claudeers.
// Claude Skills

youtube-transcript-skills

YouTube transcript Agent Skill for Claude Code, Cursor, Codex and OpenClaw: fetch YouTube video transcripts, search videos, browse channels and playlists.

// Claude Skills[ cli ][ api ][ web ][ claude ]#claude#agent-skills#ai-agent#ai-tools#claude-code#claude-skills#codex#cursor#skills◷ MIT$open-sourceupdated about 1 month ago
Actively maintained
100/100
last commit 11 days ago
last release none
releases 0
open issues 2
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up youtube-transcript-skills (git-clone project) into my current project.
Found on https://claudeers.com/youtube-transcript-skills
Repo: https://github.com/tubeagentkit/youtube-transcript-skills
Homepage/docs: https://getyoutubetranscript.com
Detected install method: git-clone → git clone https://github.com/tubeagentkit/youtube-transcript-skills
Category: skills. Platforms: cli, api, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/tubeagentkit/youtube-transcript-skills

// compatibility

Platformscli, api, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageShell

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

YouTube Transcript Agent Skill for Claude Code, Cursor & Codex 🎬

skills.sh

Get YouTube transcripts, search videos, browse channels, and pull playlists — from any AI agent, with no dashboard visit required to get started.

An Agent Skill that teaches Claude, Cursor, Antigravity, Windsurf, and any other Agent Skills-compatible tool how to fetch YouTube transcripts, search YouTube (videos or channels), resolve channel handles, browse a channel's full upload history, search inside a channel, and pull playlist contents — all through the getyoutubetranscript.com public API.

Works with Claude Code, Cursor, Antigravity, Windsurf, Cline, Codex, and 70+ other agent runtimes via skills.sh, and via ClawHub for OpenClaw/ClawdBot/Moltbot.

Metered API: 1 credit per successful request · 100 free credits on signup, no card · then from $5/month for 1,000 credits · Your agent can set it up for you


Install

npx skills add tubeagentkit/youtube-transcript-skills --skill youtube-transcript

ClawHub (OpenClaw/ClawdBot/Moltbot):

npx clawhub@latest install tubeagentkit/youtube-transcript

Manual (git clone):

git clone https://github.com/tubeagentkit/youtube-transcript-skills.git
cp -r youtube-transcript-skills/skills/youtube-transcript ~/.claude/skills/

Not a developer? Paste this into Claude, Cursor, or any AI agent that supports Agent Skills:

Install the youtube-transcript skill from this GitHub repo:
https://github.com/tubeagentkit/youtube-transcript-skills
I want to get YouTube transcripts, search YouTube, and browse channels from you directly.
Set everything up for me, including getting an API key.

The agent handles the rest — including signing you up for a free API key by email, no browser or dashboard visit needed.


What You Can Do

Just install and ask. No config, no code — talk to your agent in plain English.

TaskExample Prompt
Get a transcript"Summarize this video: [URL]"
Find where something is said"At what point does this video talk about pricing? Link the moment."
Search YouTube"Find videos about machine learning"
Find a channel"Search YouTube for MKBHD's channel"
Browse a channel"What has @veritasium posted recently?"
Get a channel's full upload history"List every video @TED has ever uploaded"
Search inside a channel"Search MKBHD's channel for iPhone reviews"
Get playlist contents"List all videos in this playlist: [URL]"
Research a topic"Find and summarize the top 5 videos about quantum computing"
Bulk transcripts"Get transcripts for every video in this playlist"

Getting an API Key: No Browser Required

Ask your agent for a transcript with no key configured, and it will:

  1. Tell you the cost (1 credit per successful request; 100 free credits for new accounts, then from $5/month for 1,000) and ask for the email you'd like to use.
  2. Send that email to getyoutubetranscript.com, which creates the account (or signs you in) and emails you a 6-digit code.
  3. Once you give it the code, it gets an API key, checks it, and saves it to ~/.config/getyoutubetranscript/api_key (readable only by you). The key is never printed in the chat.

Can't get the code (no access to that inbox, or it never arrives)? Sign up at getyoutubetranscript.com/dashboard and paste the key to your agent instead.

The key file is the only thing the skill writes. It only touches your shell profile if you ask it to and say yes to the exact line it will add (scripts/save_key.sh --profile). See skills/youtube-transcript/SKILL.md for the exact flow, including the two API calls involved (POST /api/v1/signup, POST /api/v1/signup/verify).


Available Endpoints

All of these are documented in SKILL.md and wrapped by a bundled script in scripts/. Base URL: https://getyoutubetranscript.com/api/v1.

EndpointCostWhat it does
GET /transcript1 creditFull transcript + title/author/thumbnail for one video, with caption_type (manual/auto) and the language actually returned; add timestamps=true for per-line segments
GET /transcript/languagesFreeThe caption languages a video offers (manual or auto-generated) and which one a default request returns
POST /batch + GET /batch1 credit per successful videoUp to 100 videos in one call; poll for results (failed videos are never charged)
GET /search1 credit/pageSearch YouTube for videos or channels, paginated
GET /resolveFreeResolve a channel handle/URL/ID to its canonical channel ID
GET /channel/latestFreeChannel metadata + its home tab's "Latest Videos"
GET /channel/videos1 credit/pageEvery video a channel has ever uploaded, fully paginated
GET /channel/search1 credit/pageSearch within one channel's videos, fully paginated
GET /playlist1 credit/pageEvery video in a playlist, fully paginated
GET /creditsFreeRemaining credit balance, plan, and rate limit for this key

Pricing

PlanPriceCreditsRate Limit
Free$0100 credits on signup60 req/min
Monthly$5/month1,000 credits/month200 req/min
Annual$4.50/mo ($54/yr)1,000 credits/month300 req/min
  • 1 credit = 1 successful request. Failed calls are never charged.
  • resolve and channel/latest are always free, regardless of plan.
  • Top-ups: $2.50 per 1,000 credits (Monthly), $1.50 per 1,000 (Annual, 40% cheaper).
  • View pricing / manage billing →

Troubleshooting

SymptomLikely causeFix
401 MISSING_API_KEY / INVALID_API_KEYNo key sent, or it's wrong/revokedConfirm YOUTUBE_TRANSCRIPT_API_KEY is actually set in your agent's environment, and that it starts with sk_live_
402 PAYMENT_REQUIREDOut of creditsTop up or upgrade at the dashboard — don't retry the same call
404 VIDEO_UNAVAILABLE / TRANSCRIPT_NOT_FOUND / TRANSCRIPT_DISABLEDVideo doesn't exist, is private, or has no captionsConfirm the video plays and shows captions in a real browser first
404 LANGUAGE_NOT_AVAILABLEThe video doesn't have a transcript in the language you asked forOmit language to get whatever's available, or try a different one
429 RATE_LIMITEDToo many requests for your plan tierBack off — don't hammer it in a retry loop
503 UPSTREAM_UNAVAILABLE / UPSTREAM_TIMEOUTTransient upstream hiccupSafe to retry once after a short delay

Two more things worth knowing:

  • Signup email never arrives. Check spam first. Disposable/throwaway email domains are rejected outright with a clear error — use a real address.
  • Timestamps are opt-in. GET /transcript returns the full spoken text as one string. Add timestamps=true to also get data.segments (start, duration, text per caption line, in seconds). Same credit cost, larger response, so your agent only asks for it when you want timestamps, quotes or chapters.

FAQ

Do I need a Google YouTube Data API key? No. This replaces the need for a Google Cloud project, API key, and quota management entirely — signup here is free and instant.

Which endpoint should I use for a whole channel's videos? channel/latest if you just want recent uploads (free). channel/videos if you want the complete upload history, paginated.

Can I search inside just one channel, not all of YouTube? Yes — channel/search does exactly that, with the same pagination convention as everything else here.

Is there an MCP server version of this too? Yes — see tubeagentkit/youtube-mcp for direct integration with Claude, ChatGPT, Cursor, and any other MCP-compatible client, including full OAuth 2.1 sign-in (no API key needed at all).


Also available as a REST API

Building an app instead of an agent skill? The exact same backend is a plain JSON REST API — see SKILL.md for the full endpoint reference, or the dashboard to get a key directly.

Disclosure

getyoutubetranscript.com is an independent product and is not affiliated with or endorsed by YouTube or Google.

Contributing

Issues and PRs welcome.

Other ways to use the GetYouTubeTranscript API:

License

MIT — see LICENSE.

// faq

What is youtube-transcript-skills?

YouTube transcript Agent Skill for Claude Code, Cursor, Codex and OpenClaw: fetch YouTube video transcripts, search videos, browse channels and playlists.. It is open-source on GitHub.

Is youtube-transcript-skills free to use?

youtube-transcript-skills is open-source under the MIT license, so it is free to use.

What category does youtube-transcript-skills belong to?

youtube-transcript-skills is listed under skills in the Claudeers registry of Claude-compatible tools.

18 views
★ 44 stars
unclaimed
updated about 1 month ago

// embed badge

youtube-transcript-skills on Claudeers
[![Claudeers](https://claudeers.com/api/badge/youtube-transcript-skills.svg)](https://claudeers.com/youtube-transcript-skills)

// retro hit counter

youtube-transcript-skills hit counter
[![Hits](https://claudeers.com/api/counter/youtube-transcript-skills.svg)](https://claudeers.com/youtube-transcript-skills)

// reviews

// guestbook

0/500

// related in Claude Skills

🔓

An agentic skills framework & software development methodology that works.

// skillsobra/⟨Shell⟩★ 314,126◷ MIT[ claude ]
🔓

Public repository for Agent Skills

// skillsanthropics/⟨Python⟩★ 188,182[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// skillsGraphify-Labs/⟨Python⟩★ 149,064◷ MIT[ claude ]
🔓

💫 Toolkit to help you get started with Spec-Driven Development

// skillsgithub/⟨Python⟩★ 148,200◷ MIT[ claude ]
→ see how youtube-transcript-skills connects across the ecosystem