youtube-mcp 是一个 YouTube 转录与搜索 MCP 服务器，面向 Claude、Cursor 以及任何支持 MCP 的客户端。它让 AI 智能体能够直接读取 YouTube 视频字幕，并围绕视频、频道和播放列表执行搜索与批量处理。服务器由 TranscriptOut 托管，所有工具通过一个远程端点调用，不在用户机器上运行。
用途 当用户向智能体粘贴 YouTube 链接时，智能体通常无法自行获取字幕。连接该服务器后，智能体可自动调用 get_transcript 读取带时间轴的文本并据此回答。除单个视频外，它还支持频道、播放列表和批量任务，适合需要把大量 YouTube 内容导入智能体工作流的场景。
主要能力 服务器共提供 14 个工具，连接后自动暴露：
- get_transcript：获取任意 YouTube 视频字幕，format=text 返回纯文本，format=json 返回带时间轴的分段；srt 和 vtt 返回完整字幕文件内容，srv3 返回原始 XML。
- get_video_info：获取单个视频的元数据（标题、频道、时长、观看量、缩略图）及可用字幕语言列表，不下载字幕。
- search_youtube：搜索视频或频道，支持分页。
- list_channel_videos：按最新优先列出频道视频，接受 @handle、频道名、UC 频道 ID 或频道 URL。
- search_channel_videos：在单个频道内使用 YouTube 原生相关性搜索。
- latest_channel_videos：通过 RSS 获取频道最近约 15 个视频。
- list_playlist_videos：按播放列表顺序列出全部视频。
- search_playlist_videos：按标题子串在播放列表内查找视频，最多扫描 500 项。
- submit_transcripts_job：一次排队最多 4,000 个视频的转录任务，立即返回 job_id，后台按速率限制执行。
- get_transcripts_job：查看批量任务进度（queued/running/done/cancelled）。
- get_transcripts_results：分页读取批量任务已完成的结果，每页 1-500 条，默认 100。
- get_transcripts_result：按视频 ID 读取批量任务中单个视频的结果。
- cancel_transcripts_job：取消批量任务，仅未开始的视频退还额度。
- get_credits：查询密钥剩余额度。
使用方式
- 在 transcriptout.com 注册并创建 API 密钥，密钥以 sk_ 开头，仅显示一次。新账户获赠 100 免费额度，无需信用卡。
- 将客户端指向服务器端点，使用 streamable HTTP 和 Bearer 头认证。仓库提供 Cursor、VS Code、Claude Code、Windsurf、Zed、Kilo Code、Gemini、Qwen 等客户端的配置示例。
- 粘贴 YouTube 链接，智能体自动选择 get_transcript 并基于字幕回答。每个响应携带 X-Credits-Remaining 头以显示余额。 此外，仓库根目录是一个符合 Agent Plugins 1.0.0 的包，可安装为智能体插件，附带 youtube 技能，指导智能体何时使用各工具。仓库还包含 server.js，可作为本地 stdio MCP 服务器运行，其 14 个工具各自调用 TranscriptOut REST API。
适用场景
- 让智能体阅读并总结单个 YouTube 视频。
- 搜索 YouTube 视频与频道，或浏览频道和播放列表内容。
- 批量归档整个频道或播放列表的字幕，例如四步完成：list_channel_videos 取 ID、submit_transcripts_job 提交、get_transcripts_job 轮询、get_transcripts_results 分页读取。
- 构建应用时使用同一后端的 JSON REST API，基础 URL 为 https://api.transcriptout.com/v1，并提供 Python 和 Node.js 客户端库。
限制
- 需要 API 密钥，且目前仅支持 API 密钥认证，尚无 OAuth 流程；Claude Desktop 和 Claude Web 等无法发送自定义头的连接器需改用 Claude Code。
- 多数调用消耗 1 个额度；在到达 YouTube 前失败的调用（验证错误、速率限制、服务容量）自动退还额度；明确“无字幕”的结果仍计费。
- 批量任务提交时按视频计费，取消时仅未开始的视频退还。
- 部分错误为确定性结果：404 表示无字幕或 ID 错误，410 表示视频已删除，451 表示年龄限制或会员专属内容。
- 该服务为独立第三方，与 YouTube 或 Google LLC 无关联、未获其背书或赞助。
- 定价为订阅制，1,000 至 100,000 额度/月，按量阶梯降价，年付有折扣；可额外购买不过期的一次性额度包。具体价格以官方页面为准。
