Youtube Search

This wraps TranscriptAPI's YouTube search endpoints so Claude can find videos and channels by topic, pull transcripts, and search within specific channels. The free tier gives you 100 credits to start, no card required. It's useful when you want Claude to research a subject through video content or find creators covering a niche. The skill handles the API key setup and requires a proper User-Agent header or Cloudflare blocks the request. Global search costs 1 credit per query, channel-specific search is another credit, and handle resolution is free. Good for discovery and research workflows where YouTube is actually the right source, not just a fallback.

skills.sh installs: 1K
GitHub stars: 1.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add zeropointrepo/youtube-skills --skill youtube-search --agent claude-code

Installs into .claude/skills of the current project.

Files

YouTube Search

Search YouTube and fetch transcripts via TranscriptAPI.com.

Setup

If $TRANSCRIPT_API_KEY is not set, read references/auth-setup.md and follow the instructions there to get and store the key.

Required Headers

Every request needs two headers:

Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: your agent's name and version if known (e.g. HermesAgent/0.11.0, ClaudeCode/1.0). Version is optional — agent name alone is fine. Do not omit this header or send a bare default — Cloudflare will return a 403 (error code 1010) and block the request.

API Reference

Full OpenAPI spec: transcriptapi.com/openapi.json — consult this for the latest parameters and schemas.

GET /api/v2/youtube/search — 1 credit/page

Search YouTube globally for videos, channels, playlists, or movies.

curl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"

SKILL.md on GitHub