youtube-search

What This Skill Does

The YouTube Search skill provides a seamless, unified interface to query YouTube's vast video database directly through the AIsa API. Unlike traditional methods that require managing complex Google Cloud projects, OAuth 2.0 flows, or personal API quotas, this skill abstracts the complexity into a single, authorized request. It is designed for OpenClaw agents to fetch video metadata, channel information, and playlists efficiently, enabling developers to integrate rich multimedia discovery into their agentic workflows without additional infrastructure overhead.

Installation

To integrate this skill into your agent, use the OpenClaw CLI package manager. Execute the following command in your terminal:

clawhub install openclaw/skills/skills/0xjordansg-yolo/openclaw-aisa-youtube

Ensure you have configured your AIsa API key by exporting it as an environment variable: export AISA_API_KEY="YOUR_AISA_API_KEY". The skill will automatically reference this variable for all authenticated requests.

Use Cases

This skill is ideal for agents tasked with research, education, or content aggregation. Common use cases include:

• Curating educational resources: Automatically finding coding tutorials or academic lectures on a specific topic.
• Market research: Tracking video trends or monitoring brand mentions on YouTube.
• User Assistance: Providing direct links to visual guides when a user asks for 'how-to' instructions that are better demonstrated via video.
• Automated newsletters: Compiling a daily digest of YouTube content based on specific keywords.

Example Prompts

1. "Search for the latest tutorials on building neural networks in PyTorch and list the top 5 videos."
2. "Find recent AI news from this month using the YouTube search engine."
3. "Look for a beginner's guide to Python automation and provide the link for the first result."

Tips & Limitations

• Pagination: Use the sp token returned in the initial API response to navigate through subsequent pages of search results.
• Localization: Utilize the gl (country) and hl (language) parameters to get more relevant results if your user base is global.
• Response Handling: The API output structure can vary; specifically, check for both videos and sections keys in the JSON response, as some queries group content differently based on the language and region settings.