{"id":"fcfb3387-72bf-43db-aafe-995a979d522f","shortId":"U4w9uN","kind":"skill","title":"youtube-channels","tagline":"Use when a YouTube channel is the focus: pasted @handles or channel URLs, requests to browse a creator's uploads, see what a channel has posted recently, search within a channel, or resolve a handle to a channel ID. Also use when the user names a creator and wants to explore thei","description":"# YouTube Channels\n\nYouTube channel tools 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\nAll channel endpoints accept flexible input — `@handle`, channel URL, or `UC...` channel ID. No need to resolve first.\n\n## GET /api/v2/youtube/channel/resolve — FREE\n\nConvert @handle, URL, or UC... ID to canonical channel ID.\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\n| Param   | Required | Validation                              |\n| ------- | -------- | --------------------------------------- |\n| `input` | yes      | 1-200 chars — @handle, URL, or UC... ID |\n\n**Response:**\n\n```json\n{ \"channel_id\": \"UCsT0YIqwnpJCM-mx7-gSA4Q\", \"resolved_from\": \"@TED\" }\n```\n\nIf input is already `UC[a-zA-Z0-9_-]{22}`, returns immediately.\n\n## GET /api/v2/youtube/channel/latest — FREE\n\nLatest 15 videos via RSS with exact stats.\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\n| Param     | Required | Validation                                |\n| --------- | -------- | ----------------------------------------- |\n| `channel` | yes      | `@handle`, channel URL, or `UC...` ID     |\n\n**Response:**\n\n```json\n{\n  \"channel\": {\n    \"channelId\": \"UCsT0YIqwnpJCM-mx7-gSA4Q\",\n    \"title\": \"TED\",\n    \"author\": \"TED\",\n    \"url\": \"https://www.youtube.com/channel/UCsT0YIqwnpJCM-mx7-gSA4Q\",\n    \"published\": \"2006-04-17T00:00:00Z\"\n  },\n  \"results\": [\n    {\n      \"videoId\": \"abc123xyz00\",\n      \"title\": \"Latest Video Title\",\n      \"channelId\": \"UCsT0YIqwnpJCM-mx7-gSA4Q\",\n      \"author\": \"TED\",\n      \"published\": \"2026-01-30T16:00:00Z\",\n      \"updated\": \"2026-01-31T02:00:00Z\",\n      \"link\": \"https://www.youtube.com/watch?v=abc123xyz00\",\n      \"description\": \"Full video description...\",\n      \"thumbnail\": { \"url\": \"https://i1.ytimg.com/vi/.../hqdefault.jpg\" },\n      \"viewCount\": \"2287630\",\n      \"starRating\": {\n        \"average\": \"4.92\",\n        \"count\": \"15000\",\n        \"min\": \"1\",\n        \"max\": \"5\"\n      }\n    }\n  ],\n  \"result_count\": 15\n}\n```\n\nGreat for monitoring channels — free and gives exact view counts + ISO timestamps.\n\n## GET /api/v2/youtube/channel/videos — 1 credit/page\n\nPaginated list of ALL channel uploads (100 per page).\n\n```bash\n# First page\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\n| Param          | Required    | Validation                                    |\n| -------------- | ----------- | --------------------------------------------- |\n| `channel`      | conditional | `@handle`, channel URL, or `UC...` ID         |\n| `continuation` | conditional | non-empty (next pages)                        |\n\nProvide exactly one of `channel` or `continuation`, not both.\n\n**Response:**\n\n```json\n{\n  \"results\": [{\n    \"videoId\": \"abc123xyz00\",\n    \"title\": \"Video Title\",\n    \"channelId\": \"UCsT0YIqwnpJCM-mx7-gSA4Q\",\n    \"channelTitle\": \"TED\",\n    \"channelHandle\": \"@TED\",\n    \"lengthText\": \"15:22\",\n    \"viewCountText\": \"3.2M views\",\n    \"thumbnails\": [...],\n    \"index\": \"0\"\n  }],\n  \"playlist_info\": {\"title\": \"Uploads from TED\", \"numVideos\": \"5000\", \"ownerName\": \"TED\"},\n  \"continuation_token\": \"4qmFsgKlARIYVVV1...\",\n  \"has_more\": true\n}\n```\n\nKeep calling with `continuation` until `has_more: false`.\n\n## GET /api/v2/youtube/channel/search — 1 credit\n\nSearch within a specific channel.\n\n```bash\ncurl -s \"https://transcriptapi.com/api/v2/youtube/channel/search\\\n?channel=@TED&q=climate+change&limit=30\" \\\n  -H \"Authorization: Bearer $TRANSCRIPT_API_KEY\" \\\n  -H \"User-Agent: YourAgent/1.0\"\n```\n\n| Param     | Required | Validation                                |\n| --------- | -------- | ----------------------------------------- |\n| `channel` | yes      | `@handle`, channel URL, or `UC...` ID     |\n| `q`       | yes      | 1-200 chars                               |\n| `limit`   | no       | 1-50 (default 30)                         |\n\n## Typical workflow\n\n```bash\n# 1. Check 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\n# 2. Get transcript of recent video\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## Errors\n\n| Code     | Meaning                                                | Action                               |\n| -------- | ------------------------------------------------------ | ------------------------------------ |\n| 400      | Invalid param combination                              | Both or neither channel/continuation |\n| 402      | No credits                                             | transcriptapi.com/billing            |\n| 403/1010 | Cloudflare block                                       | Add or fix User-Agent header         |\n| 404      | Channel not found                                      | Check handle or URL                  |\n| 408      | Timeout                                                | Retry once                           |\n| 422      | Invalid channel identifier                             | Check param format                   |\n\nFree tier: 100 credits, 300 req/min. Free endpoints (resolve, latest) require auth but don't consume credits.","tags":["youtube","channels","skills","zeropointrepo","agent-skills","clawdbot","hermes-agent","openclaw","youtube-search","youtube-transcript"],"capabilities":["skill","source-zeropointrepo","skill-youtube-channels","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-channels","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 (6,543 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:56.851Z","embedding":null,"createdAt":"2026-04-18T22:11:53.689Z","updatedAt":"2026-05-02T12:54:56.851Z","lastSeenAt":"2026-05-02T12:54:56.851Z","tsv":"'-01':321,328 '-04':300 '-17':301 '-200':212,547 '-30':322 '-31':329 '-50':552 '/api/v2/youtube/channel/latest':244 '/api/v2/youtube/channel/latest?channel=@ted':259,570 '/api/v2/youtube/channel/resolve':177 '/api/v2/youtube/channel/resolve?input=@ted':194 '/api/v2/youtube/channel/search':501,514 '/api/v2/youtube/channel/videos':373 '/api/v2/youtube/channel/videos?channel=@nasa':392 '/api/v2/youtube/channel/videos?continuation=token':410 '/api/v2/youtube/transcript':592 '/billing':633 '/channel/ucst0yiqwnpjcm-mx7-gsa4q':297 '/openapi.json](https://transcriptapi.com/openapi.json)':149 '/vi/.../hqdefault.jpg':345 '/watch?v=abc123xyz00':336 '0':475 '00':303,324,331 '00z':304,325,332 '1':211,354,374,502,546,551,558 '100':382,665 '1010':137 '15':247,359,467 '15000':352 '2':582 '2006':299 '2026':320,327 '22':240,468 '2287630':347 '3.2':470 '30':521,554 '300':667 '4.92':350 '400':620 '402':628 '403':134 '403/1010':634 '404':644 '408':652 '422':656 '4qmfsgklariyvvv1':488 '5':356 '5000':483 '9':239 'a-za-z0':235 'abc123xyz00':307,453 'accept':161 'action':619 'add':637 'agent':100,102,115,204,269,402,420,531,580,614,642 'alon':117 'alreadi':233 'also':43 'api':67,96,142,199,264,397,415,526,575,609 'auth':674 'author':93,196,261,292,317,394,412,523,572,606 'averag':349 'bare':128 'bash':189,254,385,509,557 'bearer':94,197,262,395,413,524,573,607 'block':139,636 'brows':19 'call':493 'canon':186 'chang':519 'channel':3,8,15,27,34,41,57,59,159,165,169,187,221,274,277,284,363,380,425,428,444,508,515,536,539,645,658 'channel/continuation':627 'channelhandl':464 'channelid':285,312,457 'channeltitl':462 'char':213,548 'check':559,648,660 'claudecode/1.0':111 'climat':518 'cloudflar':130,635 'code':136,617 'combin':623 'condit':426,434 'consult':150 'consum':678 'continu':433,446,486,495 'convert':179 'count':351,358,369 'creator':21,50 'credit':503,630,666,679 'credit/page':375 'curl':190,255,388,406,510,566,588 'default':129,553 'descript':337,340 'direct':565 'e.g':109 'empti':437 'endpoint':160,670 'error':135,616 'everi':88 'exact':252,367,441 'explor':54 'fals':499 'fine':119 'first':175,386 'fix':639 'flexibl':162 'focus':11 'follow':76 'format':597,662 'found':647 'free':178,245,364,562,663,669 'full':144,338 'get':81,176,243,372,500,583 'give':366 'great':360 'gsa4q':226,289,316,461 'h':195,201,260,266,393,399,411,417,522,528,571,577,605,611 'handl':13,38,164,180,214,276,427,538,564,649 'header':87,92,124,643 'hermesagent/0.11.0':110 'i1.ytimg.com':344 'i1.ytimg.com/vi/.../hqdefault.jpg':343 'id':42,170,184,188,218,222,281,432,543,596 'identifi':659 'immedi':242 'includ':599 'index':474 'info':477 'input':163,209,231 'instruct':78 'invalid':621,657 'iso':370 'json':220,283,450 'keep':492 'key':68,85,97,200,265,398,416,527,576,610 'known':108 'latest':154,246,309,560,672 'lengthtext':466 'limit':520,549 'link':333 'list':377 'm':471 'max':355 'mean':618 'metadata':603 'min':353 'monitor':362 'mx7':225,288,315,460 'name':48,104,116 'need':90,172 'neither':626 'next':404,438 'non':436 'non-empti':435 'numvideo':482 'omit':122 'one':442 'openapi':145 'option':114 'ownernam':484 'page':384,387,405,439 'pagin':376 'param':206,271,422,533,622,661 'paramet':155 'pass':563 'past':12 'per':383 'playlist':476 'post':29 'provid':440 'publish':298,319 'q':517,544 'read':72 'recent':30,586 'refer':143 'references/auth-setup.md':73,74 'req/min':668 'request':17,89,141 'requir':86,207,272,423,534,673 'resolv':36,174,227,671 'respons':219,282,449 'result':305,357,451 'retri':654 'return':132,241 'rss':250 'schema':157 'search':31,504 'see':24 'send':126,602 'set':71 'setup':64 'skill' 'skill-youtube-channels' 'source-zeropointrepo' 'spec':146 'specif':507 'starrat':348 'stat':253 'store':83 't00':302 't02':330 't16':323 'ted':229,291,293,318,463,465,481,485,516 'text':598 'thei':55 'thumbnail':341,473 'tier':664 'timeout':653 'timestamp':371,600 'titl':290,308,311,454,456,478 'token':487 'tool':60 'topic-agent-skills' 'topic-clawdbot' 'topic-hermes-agent' 'topic-openclaw' 'topic-youtube-search' 'topic-youtube-transcript' 'transcript':66,95,198,263,396,414,525,574,584,608 'transcriptapi.com':62,63,148,193,258,391,409,513,569,591,632 'transcriptapi.com/api/v2/youtube/channel/latest?channel=@ted':257,568 'transcriptapi.com/api/v2/youtube/channel/resolve?input=@ted':192 'transcriptapi.com/api/v2/youtube/channel/search':512 'transcriptapi.com/api/v2/youtube/channel/videos?channel=@nasa':390 'transcriptapi.com/api/v2/youtube/channel/videos?continuation=token':408 'transcriptapi.com/api/v2/youtube/transcript':590 'transcriptapi.com/billing':631 'transcriptapi.com/openapi.json](https://transcriptapi.com/openapi.json)':147 'true':491,601,604 'two':91 'typic':555 'uc':168,183,217,234,280,431,542 'ucst0yiqwnpjcm':224,287,314,459 'ucst0yiqwnpjcm-mx7-gsa4q':223,286,313,458 'updat':326 'upload':23,381,479,561 'url':16,166,181,215,278,294,342,429,540,594,651 'use':4,44 'user':47,99,203,268,401,419,530,579,613,641 'user-ag':98,202,267,400,418,529,578,612,640 'valid':208,273,424,535 'version':106,112 'via':61,249 'video':248,310,339,455,587,593,595 'videoid':306,452 'view':368,472 'viewcount':346 'viewcounttext':469 'want':52 'within':32,505 'workflow':556 'www.youtube.com':296,335 'www.youtube.com/channel/ucst0yiqwnpjcm-mx7-gsa4q':295 'www.youtube.com/watch?v=abc123xyz00':334 'yes':210,275,537,545 'youragent/1.0':205,270,403,421,532,581,615 'youtub':2,7,56,58 'youtube-channel':1 'z0':238 'za':237","prices":[{"id":"495a03d4-5104-428a-b1e1-e3aa3d9926ee","listingId":"fcfb3387-72bf-43db-aafe-995a979d522f","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:53.689Z"}],"sources":[{"listingId":"fcfb3387-72bf-43db-aafe-995a979d522f","source":"github","sourceId":"ZeroPointRepo/youtube-skills/youtube-channels","sourceUrl":"https://github.com/ZeroPointRepo/youtube-skills/tree/main/skills/youtube-channels","isPrimary":false,"firstSeenAt":"2026-04-18T22:11:53.689Z","lastSeenAt":"2026-05-02T12:54:56.851Z"}],"details":{"listingId":"fcfb3387-72bf-43db-aafe-995a979d522f","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"ZeroPointRepo","slug":"youtube-channels","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":"46634b84c24b6c5851916315c34de6b7c62d1d2a","skill_md_path":"skills/youtube-channels/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/ZeroPointRepo/youtube-skills/tree/main/skills/youtube-channels"},"layout":"multi","source":"github","category":"youtube-skills","frontmatter":{"name":"youtube-channels","description":"Use when a YouTube channel is the focus: pasted @handles or channel URLs, requests to browse a creator's uploads, see what a channel has posted recently, search within a channel, or resolve a handle to a channel ID. Also use when the user names a creator and wants to explore their content or monitor their uploads. Not for creating channels 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/youtube-channels"},"updatedAt":"2026-05-02T12:54:56.851Z"}}