{"id":"961bea7c-07d0-4917-83ae-b3525cb16ca2","shortId":"z6MLLp","kind":"skill","title":"yt","tagline":"Use when YouTube is relevant: pasted video links or IDs, @handles, quick video lookups, summaries, channel latest uploads, topic search, or any request involving YouTube content — even if YouTube is not mentioned explicitly. Covers transcripts, search, and channel latest. Not for","description":"# yt\n\nQuick YouTube lookup via [TranscriptAPI.com](https://transcriptapi.com).\n\n## Setup\n\nIf `$TRANSCRIPT_API_KEY` is not set, read [references/auth-setup.md](references/auth-setup.md) and follow the instructions there to get and store the key.\n\n## Required Headers\n\nEvery request needs two headers:\n\n- **Authorization:** `Bearer $TRANSCRIPT_API_KEY`\n- **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.\n\n## API Reference\n\nFull OpenAPI spec: [transcriptapi.com/openapi.json](https://transcriptapi.com/openapi.json) — consult this for the latest parameters and schemas.\n\n## Transcript — 1 credit\n\n```bash\ncurl -s \"https://transcriptapi.com/api/v2/youtube/transcript\\\n?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\n## Search — 1 credit\n\n```bash\ncurl -s \"https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=10\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\n| Param   | Default | Values                 |\n| ------- | ------- | ---------------------- |\n| `q`     | —       | 1-200 chars (required) |\n| `type`  | `video` | `video`, `channel`     |\n| `limit` | `20`    | 1-50                   |\n\n## Channel latest — FREE\n\n```bash\ncurl -s \"https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\nReturns last 15 videos with exact view counts and publish dates. Accepts `@handle`, channel URL, or `UC...` ID.\n\n## Resolve handle — FREE\n\n```bash\ncurl -s \"https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\nUse to convert @handle to UC... channel ID.\n\n## Errors\n\n| Code     | Meaning          | Action                                         |\n| -------- | ---------------- | ---------------------------------------------- |\n| 401      | Bad API key      | Check key                                      |\n| 402      | No credits       | transcriptapi.com/billing                      |\n| 403/1010 | Cloudflare block | Add or fix User-Agent header                   |\n| 404      | Not found        | No captions or resource doesn't exist          |\n| 408      | Timeout          | Retry once                                     |\n\nFree tier: 100 credits. Search and transcript cost 1 credit. Channel latest and resolve are free.","tags":["youtube","skills","zeropointrepo","agent-skills","clawdbot","hermes-agent","openclaw","youtube-search","youtube-transcript"],"capabilities":["skill","source-zeropointrepo","skill-yt","topic-agent-skills","topic-clawdbot","topic-hermes-agent","topic-openclaw","topic-youtube-search","topic-youtube-transcript"],"categories":["youtube-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/ZeroPointRepo/youtube-skills/yt","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add ZeroPointRepo/youtube-skills","source_repo":"https://github.com/ZeroPointRepo/youtube-skills","install_from":"skills.sh"}},"qualityScore":"0.511","qualityRationale":"deterministic score 0.51 from registry signals: · indexed on github topic:agent-skills · 123 github stars · SKILL.md body (2,735 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T12:54:57.199Z","embedding":null,"createdAt":"2026-04-18T22:11:57.465Z","updatedAt":"2026-05-02T12:54:57.199Z","lastSeenAt":"2026-05-02T12:54:57.199Z","tsv":"'-200':201 '-50':211 '/api/v2/youtube/channel/latest?channel=@ted':220 '/api/v2/youtube/channel/resolve?input=@ted':258 '/api/v2/youtube/search?q=query&type=video&limit=10':184 '/api/v2/youtube/transcript':152 '/billing':293 '/openapi.json](https://transcriptapi.com/openapi.json)':135 '1':145,177,200,210,326 '100':320 '1010':123 '15':234 '20':209 '401':282 '402':288 '403':120 '403/1010':294 '404':304 '408':314 'accept':243 'action':281 'add':297 'agent':86,88,101,174,194,230,268,302 'alon':103 'api':53,82,128,169,189,225,263,284 'author':79,166,186,222,260 'bad':283 'bare':114 'bash':147,179,215,253 'bearer':80,167,187,223,261 'block':125,296 'caption':308 'channel':17,39,207,212,245,276,328 'char':202 'check':286 'claudecode/1.0':97 'cloudflar':116,295 'code':122,279 'consult':136 'content':27 'convert':272 'cost':325 'count':239 'cover':35 'credit':146,178,290,321,327 'curl':148,180,216,254 'date':242 'default':115,197 'doesn':311 'e.g':95 'error':121,278 'even':28 'everi':74 'exact':237 'exist':313 'explicit':34 'fine':105 'fix':299 'follow':62 'format':157 'found':306 'free':214,252,318,333 'full':130 'get':67 'h':165,171,185,191,221,227,259,265 'handl':12,244,251,273 'header':73,78,110,303 'hermesagent/0.11.0':96 'id':11,249,277 'includ':159 'instruct':64 'involv':25 'key':54,71,83,170,190,226,264,285,287 'known':94 'last':233 'latest':18,40,140,213,329 'limit':208 'link':9 'lookup':15,46 'mean':280 'mention':33 'metadata':163 'name':90,102 'need':76 'omit':108 'openapi':131 'option':100 'param':196 'paramet':141 'past':7 'publish':241 'q':199 'quick':13,44 'read':58 'refer':129 'references/auth-setup.md':59,60 'relev':6 'request':24,75,127 'requir':72,203 'resolv':250,331 'resourc':310 'retri':316 'return':118,232 'schema':143 'search':21,37,176,322 'send':112,162 'set':57 'setup':50 'skill' 'skill-yt' 'source-zeropointrepo' 'spec':132 'store':69 'summari':16 'text':158 'tier':319 'timeout':315 'timestamp':160 'topic':20 'topic-agent-skills' 'topic-clawdbot' 'topic-hermes-agent' 'topic-openclaw' 'topic-youtube-search' 'topic-youtube-transcript' 'transcript':36,52,81,144,168,188,224,262,324 'transcriptapi.com':48,49,134,151,183,219,257,292 'transcriptapi.com/api/v2/youtube/channel/latest?channel=@ted':218 'transcriptapi.com/api/v2/youtube/channel/resolve?input=@ted':256 'transcriptapi.com/api/v2/youtube/search?q=query&type=video&limit=10':182 'transcriptapi.com/api/v2/youtube/transcript':150 'transcriptapi.com/billing':291 'transcriptapi.com/openapi.json](https://transcriptapi.com/openapi.json)':133 'true':161,164 'two':77 'type':204 'uc':248,275 'upload':19 'url':154,156,246 'use':2,270 'user':85,173,193,229,267,301 'user-ag':84,172,192,228,266,300 'valu':198 'version':92,98 'via':47 'video':8,14,153,155,205,206,235 'view':238 'youragent/1.0':175,195,231,269 'youtub':4,26,30,45 'yt':1,43","prices":[{"id":"8cc63ddf-b6a8-43f1-a4e0-ec05e4320ef3","listingId":"961bea7c-07d0-4917-83ae-b3525cb16ca2","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"ZeroPointRepo","category":"youtube-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T22:11:57.465Z"}],"sources":[{"listingId":"961bea7c-07d0-4917-83ae-b3525cb16ca2","source":"github","sourceId":"ZeroPointRepo/youtube-skills/yt","sourceUrl":"https://github.com/ZeroPointRepo/youtube-skills/tree/main/skills/yt","isPrimary":false,"firstSeenAt":"2026-04-18T22:11:57.465Z","lastSeenAt":"2026-05-02T12:54:57.199Z"}],"details":{"listingId":"961bea7c-07d0-4917-83ae-b3525cb16ca2","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"ZeroPointRepo","slug":"yt","github":{"repo":"ZeroPointRepo/youtube-skills","stars":123,"topics":["agent-skills","clawdbot","hermes-agent","openclaw","youtube-search","youtube-transcript"],"license":"mit","html_url":"https://github.com/ZeroPointRepo/youtube-skills","pushed_at":"2026-04-29T18:46:05Z","description":"YouTube Transcript API skills for AI agents. Get transcripts, search videos, browse channels. Works with OpenClaw, Hermes-Agent, Claude Code, Cursor, Windsurf.","skill_md_sha":"b2b254d8d5f180fcf178bd4db43d1f48a7af4388","skill_md_path":"skills/yt/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/ZeroPointRepo/youtube-skills/tree/main/skills/yt"},"layout":"multi","source":"github","category":"youtube-skills","frontmatter":{"name":"yt","description":"Use when YouTube is relevant: pasted video links or IDs, @handles, quick video lookups, summaries, channel latest uploads, topic search, or any request involving YouTube content — even if YouTube is not mentioned explicitly. Covers transcripts, search, and channel latest. Not for uploads or account management.","compatibility":"Requires internet access to reach transcriptapi.com. No additional runtimes or dependencies needed."},"skills_sh_url":"https://skills.sh/ZeroPointRepo/youtube-skills/yt"},"updatedAt":"2026-05-02T12:54:57.199Z"}}