{"id":"62381bd8-21a9-4dab-8593-f7d45ca18b56","shortId":"punnEz","kind":"skill","title":"youtube-full","tagline":"Use when YouTube is or could be relevant — even if not mentioned: pasted video/channel/playlist links, video IDs, @handles, creator lookups, video summaries, quotes, translations, topic research, tutorials, talks, lectures, expert discussions, product reviews, how-to guides, new ","description":"# YouTube Full\n\nComplete YouTube toolkit via [TranscriptAPI.com](https://transcriptapi.com). Everything in one skill.\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| Param               | Required | Default | Values                          |\n| ------------------- | -------- | ------- | ------------------------------- |\n| `video_url`         | yes      | —       | YouTube URL or 11-char video ID |\n| `format`            | no       | `json`  | `json`, `text`                  |\n| `include_timestamp` | no       | `true`  | `true`, `false`                 |\n| `send_metadata`     | no       | `false` | `true`, `false`                 |\n\n**Response** (`format=json`):\n\n```json\n{\n  \"video_id\": \"dQw4w9WgXcQ\",\n  \"language\": \"en\",\n  \"transcript\": [{ \"text\": \"...\", \"start\": 18.0, \"duration\": 3.5 }],\n  \"metadata\": { \"title\": \"...\", \"author_name\": \"...\", \"author_url\": \"...\" }\n}\n```\n\n## Search — 1 credit\n\n```bash\n# Videos\ncurl -s \"https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n\n# Channels\ncurl -s \"https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=channel&limit=10\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\n| Param   | Required | Default | Validation         |\n| ------- | -------- | ------- | ------------------ |\n| `q`     | yes      | —       | 1-200 chars        |\n| `type`  | no       | `video` | `video`, `channel` |\n| `limit` | no       | `20`    | 1-50               |\n\n## Channels\n\nAll channel endpoints accept `channel` — an `@handle`, channel URL, or `UC...` channel ID. No need to resolve first.\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\nResponse: `{\"channel_id\": \"UC...\", \"resolved_from\": \"@TED\"}`\n\n### Latest 15 videos — 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 exact `viewCount` and ISO `published` timestamps.\n\n### All channel videos — 1 credit/page\n\n```bash\n# First page (100 videos)\ncurl -s \"https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n\n# Next pages\ncurl -s \"https://transcriptapi.com/api/v2/youtube/channel/videos?continuation=TOKEN\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\nProvide exactly one of `channel` or `continuation`. Response includes `continuation_token` and `has_more`.\n\n### Search within channel — 1 credit\n\n```bash\ncurl -s \"https://transcriptapi.com/api/v2/youtube/channel/search\\\n?channel=@TED&q=QUERY&limit=30\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\n## Playlists — 1 credit/page\n\nAccepts `playlist` — a YouTube playlist URL or playlist ID.\n\n```bash\n# First page\ncurl -s \"https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_ID\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n\n# Next pages\ncurl -s \"https://transcriptapi.com/api/v2/youtube/playlist/videos?continuation=TOKEN\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\nValid ID prefixes: `PL`, `UU`, `LL`, `FL`, `OL`. Response includes `playlist_info`, `results`, `continuation_token`, `has_more`.\n\n## Credit Costs\n\n| Endpoint        | Cost     |\n| --------------- | -------- |\n| transcript      | 1        |\n| search          | 1        |\n| channel/resolve | **free** |\n| channel/latest  | **free** |\n| channel/videos  | 1/page   |\n| channel/search  | 1        |\n| playlist/videos | 1/page   |\n\n## Validation Rules\n\n| Field      | Rule                                                    |\n| ---------- | ------------------------------------------------------- |\n| `channel`  | `@handle`, channel URL, or `UC...` ID                   |\n| `playlist` | Playlist URL or ID (`PL`/`UU`/`LL`/`FL`/`OL` prefix)   |\n| `q`        | 1-200 chars                                             |\n| `limit`    | 1-50                                                    |\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        | Resource doesn't exist or no captions          |\n| 408      | Timeout          | Retry once after 2s                            |\n| 422      | Validation error | Check param format                             |\n| 429      | Rate limited     | Wait, respect Retry-After                      |\n\n## Typical Workflows\n\n**Research workflow:** search → pick videos → fetch transcripts\n\n```bash\n# 1. Search\ncurl -s \"https://transcriptapi.com/api/v2/youtube/search\\\n?q=machine+learning+explained&limit=5\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n# 2. Transcript\ncurl -s \"https://transcriptapi.com/api/v2/youtube/transcript\\\n?video_url=VIDEO_ID&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**Channel monitoring:** latest (free) → transcript\n\n```bash\n# 1. Latest uploads (free — pass @handle directly)\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# 2. Transcript of latest\ncurl -s \"https://transcriptapi.com/api/v2/youtube/transcript\\\n?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\nFree tier: 100 credits, 300 req/min. Starter ($5/mo): 1,000 credits.","tags":["youtube","full","skills","zeropointrepo","agent-skills","clawdbot","hermes-agent","openclaw","youtube-search","youtube-transcript"],"capabilities":["skill","source-zeropointrepo","skill-youtube-full","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/youtube-full","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 (7,146 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.016Z","embedding":null,"createdAt":"2026-04-18T22:11:55.223Z","updatedAt":"2026-05-02T12:54:57.016Z","lastSeenAt":"2026-05-02T12:54:57.016Z","tsv":"'-200':277,557 '-50':288,561 '/api/v2/youtube/channel/latest?channel=@ted':344,699 '/api/v2/youtube/channel/resolve?input=@ted':316 '/api/v2/youtube/channel/search':431 '/api/v2/youtube/channel/videos?channel=@nasa':377 '/api/v2/youtube/channel/videos?continuation=token':395 '/api/v2/youtube/playlist/videos?continuation=token':486 '/api/v2/youtube/playlist/videos?playlist=pl_id':468 '/api/v2/youtube/search':634 '/api/v2/youtube/search?q=query&type=channel&limit=10':258 '/api/v2/youtube/search?q=query&type=video&limit=20':241 '/api/v2/youtube/transcript':156,658,719 '/billing':577 '/openapi.json](https://transcriptapi.com/openapi.json)':139 '000':752 '1':149,233,276,287,366,424,450,520,522,530,556,560,628,688,751 '1/page':528,532 '100':371,745 '1010':127 '11':190 '15':336 '18.0':223 '2':652,711 '20':286 '2s':603 '3.5':225 '30':437 '300':747 '401':566 '402':572 '403':124 '403/1010':578 '404':588 '408':598 '422':604 '429':610 '5':640 '5/mo':750 'accept':293,452 'action':565 'add':581 'agent':90,92,105,178,251,268,326,354,387,405,447,478,496,586,650,680,709,741 'alon':107 'api':57,86,132,173,246,263,321,349,382,400,442,473,491,568,645,675,704,736 'author':83,170,228,230,243,260,318,346,379,397,439,470,488,642,672,701,733 'bad':567 'bare':118 'bash':151,235,311,339,368,426,461,627,687 'bearer':84,171,244,261,319,347,380,398,440,471,489,643,673,702,734 'block':129,580 'caption':597 'channel':253,283,289,291,294,297,301,329,364,411,423,432,537,539,682 'channel/latest':525 'channel/resolve':523 'channel/search':529 'channel/videos':527 'char':191,278,558 'check':570,607 'claudecode/1.0':101 'cloudflar':120,579 'code':126,563 'complet':44 'consult':140 'continu':413,416,511 'cost':516,518 'could':9 'creator':22 'credit':150,234,425,515,574,746,753 'credit/page':367,451 'curl':152,237,254,312,340,373,391,427,464,482,630,654,695,715 'default':119,182,272 'direct':694 'discuss':34 'doesn':592 'dqw4w9wgxcq':217 'durat':224 'e.g':99 'en':219 'endpoint':292,517 'error':125,562,606 'even':12 'everi':78 'everyth':50 'exact':357,408 'exist':594 'expert':33 'explain':638 'fals':204,208,210 'fetch':625 'field':535 'fine':109 'first':307,369,462 'fix':583 'fl':504,552 'follow':66 'format':161,194,212,609,663,724 'found':590 'free':310,338,524,526,685,691,743 'full':3,43,134 'get':71 'guid':40 'h':169,175,242,248,259,265,317,323,345,351,378,384,396,402,438,444,469,475,487,493,641,647,671,677,700,706,732,738 'handl':21,296,309,538,693 'header':77,82,114,587 'hermesagent/0.11.0':100 'how-to':37 'id':20,193,216,302,330,460,499,543,548,662,723 'includ':163,199,415,507,665,726 'info':509 'instruct':68 'iso':360 'json':196,197,213,214 'key':58,75,87,174,247,264,322,350,383,401,443,474,492,569,571,646,676,705,737 'known':98 'languag':218 'latest':144,335,684,689,714 'learn':637 'lectur':32 'limit':284,436,559,612,639 'link':18 'll':503,551 'lookup':23 'machin':636 'mean':564 'mention':15 'metadata':167,206,226,669,730 'monitor':683 'name':94,106,229 'need':80,304 'new':41 'next':389,480 'ol':505,553 'omit':112 'one':52,409 'openapi':135 'option':104 'page':370,390,463,481 'param':180,270,608 'paramet':145 'pass':692 'past':16 'pick':623 'pl':501,549 'playlist':449,453,456,459,508,544,545 'playlist/videos':531 'prefix':500,554 'product':35 'provid':407 'publish':361 'q':274,434,555,635 'queri':435 'quot':26 'rate':611 'read':62 'refer':133 'references/auth-setup.md':63,64 'relev':11 'req/min':748 'request':79,131 'requir':76,181,271 'research':29,620 'resolv':306,308,332 'resourc':591 'respect':614 'respons':211,328,414,506 'result':510 'retri':600,616 'retry-aft':615 'return':122,356 'review':36 'rule':534,536 'schema':147 'search':232,421,521,622,629 'send':116,166,205,668,729 'set':61 'setup':54 'skill':53 'skill-youtube-full' 'source-zeropointrepo' 'spec':136 'start':222 'starter':749 'store':73 'summari':25 'talk':31 'ted':334,433 'text':162,198,221,664,725 'tier':744 'timeout':599 'timestamp':164,200,362,666,727 'titl':227 'token':417,512 'toolkit':46 'topic':28 'topic-agent-skills' 'topic-clawdbot' 'topic-hermes-agent' 'topic-openclaw' 'topic-youtube-search' 'topic-youtube-transcript' 'transcript':56,85,148,172,220,245,262,320,348,381,399,441,472,490,519,626,644,653,674,686,703,712,735 'transcriptapi.com':48,49,138,155,240,257,315,343,376,394,430,467,485,576,633,657,698,718 'transcriptapi.com/api/v2/youtube/channel/latest?channel=@ted':342,697 'transcriptapi.com/api/v2/youtube/channel/resolve?input=@ted':314 'transcriptapi.com/api/v2/youtube/channel/search':429 'transcriptapi.com/api/v2/youtube/channel/videos?channel=@nasa':375 'transcriptapi.com/api/v2/youtube/channel/videos?continuation=token':393 'transcriptapi.com/api/v2/youtube/playlist/videos?continuation=token':484 'transcriptapi.com/api/v2/youtube/playlist/videos?playlist=pl_id':466 'transcriptapi.com/api/v2/youtube/search':632 'transcriptapi.com/api/v2/youtube/search?q=query&type=channel&limit=10':256 'transcriptapi.com/api/v2/youtube/search?q=query&type=video&limit=20':239 'transcriptapi.com/api/v2/youtube/transcript':154,656,717 'transcriptapi.com/billing':575 'transcriptapi.com/openapi.json](https://transcriptapi.com/openapi.json)':137 'translat':27 'true':165,168,202,203,209,667,670,728,731 'tutori':30 'two':81 'type':279 'typic':618 'uc':300,331,542 'upload':690 'url':158,160,185,188,231,298,457,540,546,660,721 'use':4 'user':89,177,250,267,325,353,386,404,446,477,495,585,649,679,708,740 'user-ag':88,176,249,266,324,352,385,403,445,476,494,584,648,678,707,739 'uu':502,550 'valid':273,498,533,605 'valu':183 'version':96,102 'via':47 'video':19,24,157,159,184,192,215,236,281,282,337,365,372,624,659,661,720,722 'video/channel/playlist':17 'viewcount':358 'wait':613 'within':422 'workflow':619,621 'yes':186,275 'youragent/1.0':179,252,269,327,355,388,406,448,479,497,651,681,710,742 'youtub':2,6,42,45,187,455 'youtube-ful':1","prices":[{"id":"f23ab2a4-e500-4fe3-9ea0-ee2f64445bdb","listingId":"62381bd8-21a9-4dab-8593-f7d45ca18b56","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:55.223Z"}],"sources":[{"listingId":"62381bd8-21a9-4dab-8593-f7d45ca18b56","source":"github","sourceId":"ZeroPointRepo/youtube-skills/youtube-full","sourceUrl":"https://github.com/ZeroPointRepo/youtube-skills/tree/main/skills/youtube-full","isPrimary":false,"firstSeenAt":"2026-04-18T22:11:55.223Z","lastSeenAt":"2026-05-02T12:54:57.016Z"}],"details":{"listingId":"62381bd8-21a9-4dab-8593-f7d45ca18b56","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"ZeroPointRepo","slug":"youtube-full","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":"ef59c6ff776d1212d246e7f1552049d931aa87e6","skill_md_path":"skills/youtube-full/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/ZeroPointRepo/youtube-skills/tree/main/skills/youtube-full"},"layout":"multi","source":"github","category":"youtube-skills","frontmatter":{"name":"youtube-full","description":"Use when YouTube is or could be relevant — even if not mentioned: pasted video/channel/playlist links, video IDs, @handles, creator lookups, video summaries, quotes, translations, topic research, tutorials, talks, lectures, expert discussions, product reviews, how-to guides, new product announcements, first looks, or anything where video content is fresher or richer than text search. Covers transcripts, video/channel search, channel browsing, playlists, and within-channel search. Not for uploads, account management, or written-source-only research.","compatibility":"Requires internet access to reach transcriptapi.com. No additional runtimes or dependencies needed."},"skills_sh_url":"https://skills.sh/ZeroPointRepo/youtube-skills/youtube-full"},"updatedAt":"2026-05-02T12:54:57.016Z"}}