YouTube Transcript AI

YouTube Transcript MCP 服务

让 Claude、ChatGPT、Cursor、Claude Code 和任何 MCP 客户端都能读取 YouTube 字幕文本。托管服务，无需安装。免费 API 密钥：每天 10 次请求。

一个托管的 Model Context Protocol 服务，提供一个工具 get_youtube_transcript，由 youtube-transcript.ai 提供支持。在对话中粘贴 YouTube 链接，AI 就会按需读取完整字幕文本。

连接器 URL：

https://youtube-transcript.ai/mcp?key=YOUR_KEY

将 YOUR_KEY 替换为你的 API 密钥。使用 Google 账号登录即可创建免费密钥，大约需要一分钟。

---

为什么选择它

• 免费开始使用。 免费密钥每天可获取 10 段字幕文本。Pro 每年 120 美元，每天可获取 1,000 段，使用同一个密钥。
• 可靠。 强化的抓取流程会在代理回退机制的支持下，即使视频会屏蔽常见抓取工具，也能返回字幕文本。
• 支持任何语言。 按语言代码（en、zh-CN、es、ja 等）选择字幕轨道，也可以让它选择默认轨道。
• 专为 Agent 打造。 只需一个工具，输出带有标题和元数据的纯文本。数小时的视频会分段返回，确保内容不会被截断。

身份验证

调用工具需要 API 密钥。不支持 OAuth。可通过以下两种方式之一传入密钥：

位置	示例
标头	Authorization: Bearer YOUR_KEY
URL	https://youtube-transcript.ai/mcp?key=YOUR_KEY

URL 形式适用于只接受连接器 URL 的客户端。

快速开始

Claude（网页 / 桌面端）

设置 → 连接器 → 添加自定义连接器

字段	值
名称	youtube-transcript.ai
URL	https://youtube-transcript.ai/mcp?key=YOUR_KEY

然后提问：“总结这个视频：https://youtu.be/dQw4w9WgXcQ”

ChatGPT

在自定义连接器 / MCP 服务设置中，使用 URL https://youtube-transcript.ai/mcp?key=YOUR_KEY 添加 MCP 服务（传输方式：Streamable HTTP），为聊天启用它，然后粘贴 YouTube 链接。

Claude Code

claude mcp add --transport http --scope user youtube-transcript \
  https://youtube-transcript.ai/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Cursor

添加到 ~/.cursor/mcp.json，或添加到某个项目中的 .cursor/mcp.json：

{
  "mcpServers": {
    "youtube-transcript": {
      "url": "https://youtube-transcript.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Codex

添加到 ~/.codex/config.toml：

[mcp_servers.youtube-transcript]
url = "https://youtube-transcript.ai/mcp"
http_headers = { "Authorization" = "Bearer YOUR_KEY" }

仅支持启动本地服务的客户端

对于从配置文件启动 MCP 服务且无法接受远程 URL 的客户端，可通过 mcp-remote 建立桥接：

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://youtube-transcript.ai/mcp?key=YOUR_KEY"]
    }
  }
}

让你的 Agent 代劳

将 https://youtube-transcript.ai/mcp.md 粘贴到编码 Agent 中。这是这些说明的纯文本版本，专为 AI 执行而编写。

工具参考

get_youtube_transcript

获取 YouTube 视频的完整字幕文本。

参数	类型	必填	说明
video	string	是	YouTube URL（watch、youtu.be、shorts、embed）或 11 个字符的视频 ID
lang	string	否	字幕语言代码，例如 en、zh-CN、es。省略时使用默认轨道
offset	integer	否	从长字幕文本的指定位置继续。使用上一部分末尾给出的值

返回纯文本：字幕文本，以及标题、时长和可用语言列表。超过 120,000 个字符的字幕文本会分段返回；每部分末尾都会附带说明，给出下一次调用所需的 offset。

示例提示词

• “用 5 个要点总结 <link> 的关键内容。”
• “提取这个视频的字幕文本并翻译成西班牙语。”
• “演讲者在 <link> 中是怎么谈定价的？引用原文。”

程序化使用

该服务通过 Streamable HTTP（JSON-RPC）使用标准 MCP。无依赖示例见 examples/quickstart.mjs：

YT_TRANSCRIPT_KEY=YOUR_KEY node examples/quickstart.mjs https://youtu.be/dQw4w9WgXcQ

不通过 MCP，而是从自己的代码调用？另有纯 HTTP 端点：参见 YouTube Transcript API。

限额

• 免费版：每天 10 次请求。Pro 版：每年 $120，每天 1,000 次请求。可在密钥页面升级。
• 每次工具调用都计为一次请求，包括长字幕的每个部分。计数会在 UTC 时间 00:00 重置。
• 视频需要有字幕，可以是上传者编写的，也可以是 YouTube 自动生成的。

说明

• 与 YouTube 或 Google 无关联。字幕取自公开可用的字幕。
• 已列入官方 MCP Registry，名称为 ai.youtube-transcript/youtube-transcript。

链接

• 网页工具（无需 AI 客户端）：https://youtube-transcript.ai
• 连接器介绍页：https://youtube-transcript.ai/mcp
• HTTP API：https://youtube-transcript.ai/api

许可证

MIT