# Aisa Youtube Serp Scout

> Search YouTube videos, channels, and trends through the AIsa YouTube SERP client. Use when the user asks for content research, competitor tracking, or trend discovery without managing Google credentials. Use when: the user needs YouTube search, trend discovery, channel research, or SERP analysis.

- Skill: `baofeng-tech/aisa-youtube-serp-scout` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds add baofeng-tech/aisa-youtube-serp-scout`
- Raw SKILL.md: https://api.skillmd.com/api/skills/baofeng-tech/aisa-youtube-serp-scout/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- License: MIT-0
- Author: baofeng-tech (https://skillmd.com/u/baofeng-tech)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/baofeng-tech/aisa-youtube-serp-scout

---


# AIsa YouTube SERP Scout

Search YouTube videos, channels, and trends through the AIsa relay for content research, competitor tracking, and trend discovery.

## When to use

- The user wants YouTube content research, channel discovery, or trend monitoring.
- The workflow benefits from a 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 package.

## Quick Reference

- Required environment variable: `AISA_API_KEY`
- Endpoint: `https://api.aisa.one/apis/v1/youtube/search`
- Python client: `scripts/youtube_client.py`

## Setup

```bash
export AISA_API_KEY="your-key"
```

## Common Commands

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

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"
```

## 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

## Guardrails

- Do not ask for Google credentials or browser cookies.
- Do not claim competitor analysis succeeded before the client returns data.
- Do not assume missing locale values when the user needs a specific market.

## Security Notes

- All search requests go to `api.aisa.one`.
- Required secret: `AISA_API_KEY`.
- This package does not include browser automation, local scraping, or account actions.