aisa-youtube-search
by aisapay
Search & ResearchBrief
YouTube SERP Scout for agents.
Description
What This Skill Does
Queries YouTube search results via the AIsa API and returns structured video metadata: title, channel, views, duration, publish date, and ranking position. Supports country and language filters for regional SERP research.
Returns structured SERP data including view counts and channel links in one API call, without consuming YouTube Data API quota or scraping.
When to Use It
- Finding top-ranking videos before launching a new content series
- Monitoring competitor channels for uploads on target topics
- Checking what's trending in a niche across specific countries
- Extracting title patterns from high-performing videos in a category
- Tracking ranking shifts for target keywords over time
Example Workflow
User asks: 'What are the top YouTube videos about AI agents right now?'
- 1
Reads AISA_API_KEY from environment
- 2
Calls GET /youtube/search with q='AI agents' and gl='us'
- 3
Parses response to extract titles, channel names, view counts, and video URLs
- 4
Ranks results by position and returns the top entries with metadata
A ranked list of video titles, channel names, view counts, durations, and URLs for the query
Requirements
- AISA_API_KEY — sign up at aisa.one to generate a key
- AIsa credits — pay-as-you-go billing, approximately $0.002 per search request
Installation
clawhub install aisapay/aisa-youtube-searchRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.