← ClaudeAtlas

youtube-channel-profilelisted

Profile a YouTube channel from the official YouTube Data API v3. Covers subscribers, views, upload cadence, recent views and trend, engagement, Shorts share, top videos and an estimated ad earnings range with its formula. Use when given a YouTube channel URL, @handle or channel ID and asked how big, active, engaged or valuable the channel is.
techhorizonlabs/gearlist · ★ 2 · Data & Documents · score 58
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