openclaw-aisa-youtube-aisa

name	openclaw-aisa-youtube-aisa
description	Search YouTube videos, channels, and trends through the AISA YouTube SERP client. Use when: the user needs YouTube search, trend discovery, channel research, or SERP analysis.
license	MIT-0
compatibility	Designed for Agent Skills compatible clients such as OpenClaw, Claude Code, Hermes, and GitHub-backed skill catalogs. Requires system binaries python3, environment variables AISA_API_KEY and internet access to api.aisa.one.
metadata	{"author":"AIsa","version":"1.0.0","homepage":"https://aisa.one","repository":"https://github.com/baofeng-tech/agent-skills-so","tags":"youtube,search,research,video,aisa","platforms":"agentskills.io,agentskills.so,github","primary_env":"AISA_API_KEY"}
allowed-tools	Read Bash Grep

YouTube SERP Scout

Runtime-focused skill package for YouTube search, competitor tracking, and trend discovery through the AISA relay.

When to use

• The user wants YouTube content research, channel discovery, or trend monitoring.
• The workflow benefits from the bundled Python client for repeated searches.
• The task can use AISA_API_KEY instead of direct Google API credentials.

When NOT to use

• The user needs browser automation, local scraping, or account-level YouTube actions.
• The workflow must avoid sending search requests to api.aisa.one.
• The request depends on files outside this skill package.

Setup

Required:

• Environment variable:

  • AISA_API_KEY (required)

• Binaries:

  • python3 (required)
  • curl (used for direct API calls)

export AISA_API_KEY="your-key"

Quick Reference

python3 scripts/youtube_client.py search --query "AI agents tutorial"
python3 scripts/youtube_client.py search --query "machine learning" --country us
python3 scripts/youtube_client.py competitor --name "OpenAI" --topic "GPT tutorial"

Advanced / Debug Usage (Optional)

Direct API access using curl: curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI+agents+tutorial"
-H "Authorization: Bearer $AISA_API_KEY"

Capabilities

• Search videos, channels, and playlists with q
• Filter by country with gl and language with hl
• Reuse sp tokens for pagination or SERP narrowing
• Run competitor and top-video research from the bundled Python client

Runtime Boundary

• The package is relay-based: all search requests go to api.aisa.one.
• The package is API-key-first: it requires AISA_API_KEY and does not ask for passwords, cookies, browser data, or other legacy secrets.
• The package does not include browser automation, cache sync, home-directory persistence, cookie extraction, or external agent CLI wrappers.