youtube-channel-profilelisted
Install: claude install-skill techhorizonlabs/gearlist
# YouTube channel profile
`scripts/channel_profile.py` reads public channel data through the YouTube Data API v3 and prints a Markdown report, or JSON with `--json`. It uses the official API only. It never loads YouTube web pages, and it writes nothing to disk.
## Before you run it
1. The human needs a Google Cloud project with the YouTube Data API v3 enabled and an API key, restricted to that API.
2. The key lives in the `YOUTUBE_API_KEY` environment variable. Never put it in a prompt, file or chat, and never print it. If it is not set, stop and ask the human to set it. Do not look for keys anywhere else.
3. Install the one dependency: `pip install -r scripts/requirements.txt` (requests).
## Run
```bash
python3 scripts/channel_profile.py @handle
python3 scripts/channel_profile.py https://www.youtube.com/@handle --videos 100
python3 scripts/channel_profile.py UCxxxxxxxxxxxxxxxxxxxxxx --json
```
Options: `--videos N` (recent uploads to read, default 50, max 500), `--json`, `--no-search`, `--cpm-low` and `--cpm-high` (default 0.25 and 4.00).
## How it finds the channel
- A channel ID or a `/channel/UC...` URL: `channels.list` with `id`.
- An `@handle` or `/@handle` URL: `channels.list` with `forHandle`.
- A `/user/` URL: `forUsername`. A `/c/` URL is tried as a handle.
- If nothing matches, it falls back to `search.list` for the best match and says so in the report. Check the title and ID before you rely on it. `--no-search` turns the fallback off.
- Video links, playli