ytranscript-mcp

ytranscript-mcp

一个 MCP 服务，可为 Claude、Cursor、VS Code 和其他 AI 工具提供任意 YouTube 视频的文字稿。

• 随处可用。 可在 AWS、Lambda、Vercel、n8n Cloud 和其他云主机上正常运行。无需购买代理，也无需设法绕过 IP 封禁。YouTube 会拦截大多数云端 IP 的文字稿请求；yTranscript API 会为你处理这些问题。
• 支持没有字幕的视频。 如果视频没有字幕，系统会使用 AI 语音转文字功能生成文字稿。
• 默认返回视频实际使用的语言，自动配音的视频也不例外。传入 lang 可选择特定字幕轨道。
• 让长视频更易处理。 可选择纯文本或带时间戳的行，并限制长度，避免两小时的视频占满模型上下文。

设置

1. 在 ytranscript.com/developers 获取免费 API 密钥。免费套餐每月包含 50 个单位，无需绑定银行卡。
2. 使用以下任一配置将服务添加到客户端。

Claude Code

claude mcp add ytranscript -e YTRANSCRIPT_API_KEY=yk_live_your_key -- npx -y ytranscript-mcp

Claude Desktop

将以下内容添加到 claude_desktop_config.json。在 Settings → Developer → Edit Config 中打开该文件。

{
  "mcpServers": {
    "ytranscript": {
      "command": "npx",
      "args": ["-y", "ytranscript-mcp"],
      "env": { "YTRANSCRIPT_API_KEY": "yk_live_your_key" }
    }
  }
}

Cursor

将以下内容添加到 ~/.cursor/mcp.json，或项目中的 .cursor/mcp.json：

{
  "mcpServers": {
    "ytranscript": {
      "command": "npx",
      "args": ["-y", "ytranscript-mcp"],
      "env": { "YTRANSCRIPT_API_KEY": "yk_live_your_key" }
    }
  }
}

VS Code

将以下内容添加到 .vscode/mcp.json：

{
  "servers": {
    "ytranscript": {
      "command": "npx",
      "args": ["-y", "ytranscript-mcp"],
      "env": { "YTRANSCRIPT_API_KEY": "yk_live_your_key" }
    }
  }
}

任何可运行 stdio 服务的其他 MCP 客户端也可以使用相同方式：运行 npx -y ytranscript-mcp，并设置 YTRANSCRIPT_API_KEY。

工具：get_transcript

参数	必填	描述
video	是	YouTube URL（watch、youtu.be、shorts、embed）或 11 位视频 ID
lang	否	要获取的字幕轨道语言代码，例如 en 或 es。省略时，获取视频的原始语言
format	否	text（默认）返回纯文本。timestamped 按片段逐行返回，并附上 [m:ss] 时间戳
max_characters	否	将文字稿截断至约指定字符数。响应会说明省略了多少内容

可以向助手提出以下请求：

• “总结这个视频：https://youtu.be/...”
• “讲者对定价有什么看法？分别在什么时间戳？”
• “提取这段西班牙语视频的文字稿，并翻译成英语。”

每次响应都会附上已使用的单位数和每月累计用量，方便你随时查看配额。

定价

带字幕的视频，提取文字稿需 1 个单位。没有字幕、使用 AI 转录的视频需 15 个单位。失败的请求不收费。

套餐	价格	每月单位数
Free	$0	50
Starter	$9/mo	1,000
Developer	$29/mo	10,000
Scale	$79/mo	50,000

详情请参阅 ytranscript.com/developers。

相关项目

• ytranscript-api 是构建此服务所使用的 JavaScript/TypeScript 客户端。

许可证

MIT