Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →Use when structured YouTube data is needed: pasted video/channel/playlist links, transcripts for analysis, video metadata, channel upload history, search results, or playlist contents — without Google API quotas or OAuth. Triggers on YouTube URLs, creator names, topic research, or any request needing YouTube content, even if not mentioned explicitly. Not for uploads, account management, or written-source-only research.
.claude/skills/zeropointrepo-youtube-data/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-04 | ✗→✓ | ▲ Improved | 19% | 0% |
| case-05 | ✗→✓ | ▲ Improved | 15% | 0% |
| case-06 | ✗→✓ | ▲ Improved | 30% | 0% |
| case-07 | ✗→✓ | ▲ Improved | -17% | 0% |
| case-08 | ✗→✓ | ▲ Improved | 45% | 0% |
YouTube data access via TranscriptAPI.com — lightweight alternative to Google's YouTube Data API.
If $TRANSCRIPT_API_KEY is not set, read references/auth-setup.md and follow the instructions there to get and store the key.
Every request needs two headers:
Bearer $TRANSCRIPT_API_KEYHermesAgent/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.Full OpenAPI spec: transcriptapi.com/openapi.json — consult this for the latest parameters and schemas.
httpGET https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_URL&format=json&include_timestamp=true&send_metadata=true Authorization: Bearer $TRANSCRIPT_API_KEY User-Agent: YourAgent/1.0
Response:
json{ "video_id": "dQw4w9WgXcQ", "language": "en", "transcript": [ { "text": "We're no strangers to love", "start": 18.0, "duration": 3.5 } ], "metadata": { "title": "Rick Astley - Never Gonna Give You Up", "author_name": "Rick Astley", "author_url": "https://www.youtube.com/@RickAstley", "thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg" } }
httpGET https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20 Authorization: Bearer $TRANSCRIPT_API_KEY User-Agent: YourAgent/1.0
Video result fields: videoId, title, channelId, channelTitle, channelHandle, channelVerified, lengthText, viewCountText, publishedTimeText, hasCaptions, thumbnails
Channel result fields (type=channel): channelId, title, handle, url, description, subscriberCount, verified, rssUrl, thumbnails
Channel endpoints accept channel — an @handle, channel URL, or UC... ID. No need to resolve first.
Resolve handle to ID (free):
httpGET https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED Authorization: Bearer $TRANSCRIPT_API_KEY User-Agent: YourAgent/1.0
Returns: {"channel_id": "UCsT0YIqwnpJCM-mx7-gSA4Q", "resolved_from": "@TED"}
Latest 15 videos with exact stats (free):
httpGET https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED Authorization: Bearer $TRANSCRIPT_API_KEY User-Agent: YourAgent/1.0
Returns: channel info, results array with videoId, title, published (ISO), viewCount (exact number), description, thumbnail
All channel videos (paginated, 1 credit/page):
httpGET https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA Authorization: Bearer $TRANSCRIPT_API_KEY User-Agent: YourAgent/1.0
Returns 100 videos per page + continuation_token for pagination.
Search within channel (1 credit):
httpGET https://transcriptapi.com/api/v2/youtube/channel/search?channel=@TED&q=QUERY&limit=30 Authorization: Bearer $TRANSCRIPT_API_KEY User-Agent: YourAgent/1.0
Accepts playlist — a YouTube playlist URL or playlist ID.
httpGET https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_ID Authorization: Bearer $TRANSCRIPT_API_KEY User-Agent: YourAgent/1.0
Returns: results (videos), playlist_info (title, numVideos, ownerName, viewCount), continuation_token, has_more
| Endpoint | Cost | Data returned | | --------------- | -------- | -------------------------- | | transcript | 1 | Full transcript + metadata | | search | 1 | Video/channel details | | channel/resolve | free | Channel ID mapping | | channel/latest | free | 15 videos + exact stats | | channel/videos | 1/page | 100 videos per page | | channel/search | 1 | Videos matching query | | playlist/videos | 1/page | 100 videos per page |
| Code | Meaning | Action | | -------- | ---------------- | ---------------------------------------------- | | 401 | Bad API key | Check key | | 402 | No credits | transcriptapi.com/billing | | 403/1010 | Cloudflare block | Add or fix User-Agent header | | 404 | Not found | Resource doesn't exist | | 408 | Timeout | Retry once | | 422 | Validation error | Check param format |
Free tier: 100 credits, 300 req/min.
Every request in this file as a ready-to-run one-liner: references/curl-examples.md
| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-01 | fail→fail | 6,134 | 6,031 | -2% | 1 | 1 | 0% | 724 | 1,779 | +146% | 0 | 0 | — |
case-02 | fail→fail | 10,514 | 7,299 | -31% | 1 | 1 | 0% | 1,845 | 1,802 | -2% | 0 | 0 | — |
case-03 | pass→pass | 20,871 | 5,083 | -76% | 1 | 1 | 0% | 1,738 | 2,367 | +36% | 0 | 0 | — |
case-04 | fail→pass | 11,809 | 4,434 | -62% | 1 | 1 | 0% | 1,974 | 2,357 | +19% | 0 | 0 | — |
case-05 | fail→pass | 10,157 | 2,940 | -71% | 1 | 1 | 0% | 1,757 | 2,025 | +15% | 0 | 0 | — |
case-06 | fail→pass | 7,820 | 2,958 | -62% | 1 | 1 | 0% | 1,431 | 1,864 | +30% | 0 | 0 | — |
case-07 | fail→pass | 15,072 | 3,475 | -77% | 1 | 1 | 0% | 2,512 | 2,096 | -17% | 0 | 0 | — |
case-08 | fail→pass | 8,334 | 4,152 | -50% | 1 | 1 | 0% | 1,432 | 2,071 | +45% | 0 | 0 | — |
case-09 | fail→pass | 10,185 | 3,510 | -66% | 1 | 1 | 0% | 1,920 | 2,069 | +8% | 0 | 0 | — |
case-10 | pass→pass | 11,524 | 1,582 | -86% | 1 | 1 | 0% | 1,828 | 1,688 | -8% | 0 | 0 | — |
case-11 | fail→pass | 8,907 | 2,476 | -72% | 1 | 1 | 0% | 1,365 | 1,818 | +33% | 0 | 0 | — |
case-12 | pass→pass | 9,072 | 5,276 | -42% | 1 | 1 | 0% | 1,459 | 2,268 | +55% | 0 | 0 | — |
case-13 | fail→pass | 9,844 | 1,792 | -82% | 1 | 1 | 0% | 1,569 | 1,768 | +13% | 0 | 0 | — |
case-14 | pass→pass | 7,832 | 2,153 | -73% | 1 | 1 | 0% | 1,468 | 1,822 | +24% | 0 | 0 | — |
case-15 | pass→pass | 8,140 | 2,489 | -69% | 1 | 1 | 0% | 1,341 | 1,838 | +37% | 0 | 0 | — |
case-16 | pass→pass | 8,757 | 2,875 | -67% | 1 | 1 | 0% | 1,452 | 1,841 | +27% | 0 | 0 | — |
case-17 | fail→pass | 12,023 | 2,348 | -80% | 1 | 1 | 0% | 1,986 | 1,805 | -9% | 0 | 0 | — |
case-18 | fail→pass | 8,688 | 2,094 | -76% | 1 | 1 | 0% | 1,220 | 1,725 | +41% | 0 | 0 | — |
case-19 | fail→pass | 7,314 | 9,805 | +34% | 1 | 1 | 0% | 1,195 | 2,387 | +100% | 0 | 0 | — |
case-20 | pass→pass | 14,414 | 8,849 | -39% | 1 | 1 | 0% | 2,506 | 3,011 | +20% | 0 | 0 | — |
case-21 | pass→pass | 5,366 | 4,203 | -22% | 1 | 1 | 0% | 870 | 2,185 | +151% | 0 | 0 | — |
case-22 | pass→pass | 14,038 | 11,072 | -21% | 1 | 1 | 0% | 2,777 | 3,725 | +34% | 0 | 0 | — |
DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 22 cases were attempted, and 20 counted toward the lift figure. The other 2 produced results that are not comparable between the two arms, so they are excluded from the headline rather than averaged into it. The headline lift of +50 percentage points is the difference between those two pass rates over the 20 comparable cases.
Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.
Other measured skills in the registry, with their headline benchmark lift.