aisa-youtube-search

name	aisa-youtube-search
description	Search YouTube videos, channels, and playlists through the AIsa YouTube relay with one API key. Use when the user asks for YouTube discovery, query expansion, or pagination without managing Google credentials.
license	MIT-0
compatibility	Designed for Agent Skills compatible clients such as OpenClaw, Claude Code, Hermes, and GitHub-backed skill catalogs. Requires system binaries curl, environment variables AISA_API_KEY and internet access to api.aisa.one.
metadata	{"aisa":{"emoji":"🎬","requires":{"bins":["curl"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY","compatibility":"Designed for Agent Skills compatible clients such as OpenClaw, Claude Code, Hermes, and GitHub-backed skill catalogs. Requires system binaries curl, environment variables AISA_API_KEY and internet access to api.aisa.one.","version":"1.0.1"}}

AIsa YouTube Search

Search YouTube videos, channels, and playlists through the AIsa YouTube relay with one API key.

When to use

• The user wants to search YouTube videos, channels, or playlists.
• The task needs region or language filters without direct Google API setup.
• The workflow can call the AIsa YouTube search endpoint with AISA_API_KEY.

When NOT to use

• The user needs browser automation, local scraping, or direct YouTube account actions.
• The workflow must avoid sending search requests to api.aisa.one.
• The request depends on a local helper script that is not part of this package.

Quick Reference

• Required environment variable: AISA_API_KEY
• Endpoint: https://api.aisa.one/apis/v1/youtube/search
• This package is curl-first and does not ship a local Python client.

Setup

export AISA_API_KEY="your-key"

Common Commands

curl -s "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=machine+learning+tutorial" \
  -H "Authorization: Bearer $AISA_API_KEY"

curl -s "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI+news&gl=us&hl=en" \
  -H "Authorization: Bearer $AISA_API_KEY"

curl -s "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=python+tutorial&sp=EgIQAQ%3D%3D" \
  -H "Authorization: Bearer $AISA_API_KEY"

Capabilities

• Search YouTube SERP results with q
• Filter by locale with gl and hl
• Apply pagination or narrowing via sp
• Return structured results that may include videos or grouped sections

Guardrails

• Do not ask for Google credentials or browser cookies.
• Do not claim a result is local-only when it depends on relay requests.
• Do not fabricate missing filters or parameters.

Security Notes

• All search requests go to api.aisa.one.
• Required secret: AISA_API_KEY.
• This workflow does not require passwords, browser automation, or local scraping.