YouTube Transcript + YouTube Search MCP

YouTube MCP 服务：字幕、搜索、频道与播放列表

适用于 YouTube 的远程 MCP 服务：字幕、视频和频道搜索、浏览频道、频道内搜索以及提取播放列表。
使用 API 密钥或 OAuth 2.1 登录。免费套餐，无需银行卡。

提供 13 个工具，通过一个托管端点即可使用，无需本地安装，支持 Claude、ChatGPT、Cursor、VS Code、Windsurf 及其他 15 种以上兼容 MCP 的客户端。

https://getyoutubetranscript.com/api/mcp

快速体验：

Search @veritasium for videos about black holes, pull the transcript of the
two best matches, and tell me where they disagree.

Agent 会自行串联 search_channel_videos 和 get_youtube_transcript。你无需编写任何代码。

为什么选择这个 MCP

安装为 Agent 插件

本仓库根目录也是一个 Agent Plugins 1.0.0 软件包，其中包含 MCP 服务和一个 youtube 技能，用于告诉 Agent 何时使用哪个工具、每个工具的费用，以及如何避免浪费额度。

plugin.json                # plugin manifest
mcp.json                   # hosted MCP server (streamable-http, OAuth, no key in the file)
skills/youtube/SKILL.md    # when and how to use the 13 tools

在 VS Code 中运行 Chat: Install Plugin From Source，然后粘贴 https://github.com/tubeagentkit/youtube-mcp。其他支持 Agent Plugins 的客户端可以指向此仓库或本地克隆。Cursor 有单独的插件仓库。

该软件包不包含任何凭据。请自行对照已发布的架构检查清单文件：

curl -sO https://agent-plugins.org/schemas/1.0.0/plugin.schema.json
curl -sO https://agent-plugins.org/schemas/1.0.0/mcp.schema.json
npx ajv-cli@5 validate --spec=draft2020 -s plugin.schema.json -d plugin.json
npx ajv-cli@5 validate --spec=draft2020 -s mcp.schema.json -d mcp.json

ChatGPT 和 Codex

同一个 plugin.json 通过 extensions.com.openai 携带 ChatGPT/Codex 插件目录清单（其他客户端会忽略它）。scripts/build-openai-zip.sh 会根据 OpenAI 的字段限制检查该清单，并在 dist/ 中构建上传用 ZIP，其中仅包含 plugin.json、mcp.json、skills/ 和 assets/。

快速安装

**要求：**免费注册 getyoutubetranscript.com 账号（注册——100 个额度，无需银行卡），并从控制面板获取 API 密钥——或者直接通过 OAuth 连接，完全跳过密钥（请参阅下文的身份验证）。

**提示：**支持 MCP OAuth 的客户端可以跳过以下代码片段中的 headers 部分，改为通过浏览器登录。

**提示：**如需避免反复说“使用转录工具”，请在客户端规则或自定义指令中添加一条固定指令，例如：“当我分享 YouTube 链接时，先使用 youtube-transcript MCP 获取其转录，再回答。”

claude mcp add --transport http youtube-transcript https://getyoutubetranscript.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

{
  "mcpServers": {
    "youtube-transcript": {
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

"mcp.servers": {
  "youtube-transcript": {
    "type": "http",
    "url": "https://getyoutubetranscript.com/api/mcp",
    "headers": { "Authorization": "Bearer YOUR_API_KEY" }
  }
}

{
  "mcpServers": {
    "youtube-transcript": {
      "serverUrl": "https://getyoutubetranscript.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "youtube-transcript": {
      "url": "https://getyoutubetranscript.com/api/mcp",
      "type": "streamableHttp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

{
  "context_servers": {
    "youtube-transcript": {
      "source": "remote",
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "youtube-transcript": {
      "type": "streamable-http",
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

amp mcp add youtube-transcript https://getyoutubetranscript.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

"augment.advanced": {
  "mcpServers": [
    {
      "name": "youtube-transcript",
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  ]
}

{
  "mcpServers": {
    "youtube-transcript": {
      "type": "streamable-http",
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "youtube-transcript": {
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

30 秒示例

Summarize this video for me: https://youtu.be/dQw4w9WgXcQ

Agent 会调用 get_youtube_transcript 并总结结果。如果你通过 OAuth 连接，则完全无需配置密钥——只需批准一次连接即可。

本地运行（stdio）

更喜欢本地进程？server/ 是一个开源 stdio MCP 服务，提供相同的 13 个工具，基于官方 MCP TypeScript SDK 构建。它会使用你的 API 密钥调用公开的 REST API。

git clone https://github.com/tubeagentkit/youtube-mcp
npm install --prefix youtube-mcp/server

然后将客户端指向该服务，例如 Claude Desktop / Cursor：

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "node",
      "args": ["/absolute/path/to/youtube-mcp/server/index.js"],
      "env": { "GYT_API_KEY": "sk_live_your_key_here" }
    }
  }
}

实时集成测试（仅使用免费工具）：GYT_API_KEY=sk_live_... npm test --prefix server

身份验证

API 密钥

通用方式，适用于所有 MCP 客户端。在控制面板免费获取（100 个额度，无需银行卡），然后将其作为 Bearer 令牌发送：

"headers": { "Authorization": "Bearer sk_live_your_key_here" }

OAuth 2.1

无需手动管理密钥——通过浏览器登录，其余步骤由服务处理。

• **动态客户端注册（DCR）：**支持在连接时自行注册的客户端（Claude Desktop/Web、ChatGPT 及大多数其他客户端）。
• **客户端 ID 元数据文档（CIMD）：**根据当前 MCP 规范（2026-07-28）提供支持，适用于托管自身元数据文档的客户端——这是比 DCR 更现代的替代方案，无需共享密钥。
• 首次连接时会打开同意页面，清楚显示授予的访问权限；批准一次即可完成连接。

这两种方式都会签发一个限定于此 MCP 服务且受受众限制的令牌——该令牌无法用于其他任何 API。

可用工具

连接后，所有十三个工具都会自动公开。**1 个积分 = 1 次成功请求。**失败或受速率限制的调用不会消耗积分。

1. get_youtube_transcript

获取 YouTube 视频的完整字幕，以及标题、作者和缩略图元数据。

**费用：**1 个积分，无论是否启用 timestamps。

2. get_transcript_languages

列出视频提供的字幕语言（包括创作者上传和自动生成的字幕），以及默认请求会返回哪种语言。

空列表表示该视频已关闭字幕。普通字幕请求无需使用此工具：get_youtube_transcript 已会报告返回的语言。

**费用：**1 个积分。

3. search_youtube

分页搜索 YouTube 视频或频道。

**费用：**每页 1 个积分。

4. get_channel_latest_videos

获取频道元数据及其最近上传的视频。

**费用：**1 个积分。

5. search_channel_videos

在指定频道的视频中搜索。

**费用：**每页 1 个积分。

6. list_channel_videos

列出频道最近视频以外的上传内容：较早的剧集、最热门的视频、Shorts 或过往直播。

**费用：**每页 1 个积分。

7. list_channel_playlists

列出频道发布的播放列表。将播放列表的 id 传递给 list_playlist_videos，即可查看其中的视频。

**费用：**每页 1 个积分。

8. list_channel_posts

列出频道的社区帖子：文本、链接、点赞、评论和任何附带的图片。

**费用：**每页 1 个积分。

9. get_related_videos

YouTube 在视频旁推荐的后续视频，每个视频包含标题、视频 ID、链接、频道、观看次数、发布时间和时长。

费用： 1 个额度。

10. get_channel_banner

频道的未裁剪横幅、YouTube 提供的各种裁剪尺寸，以及头像。若频道没有横幅，has_banner 为 false。

费用： 1 个额度。

11. get_video_dislikes

视频的点赞数、点踩数、星级评分和观看次数。YouTube 不再公布点踩数，因此这些数据为估算值。

费用： 1 个额度。

12. list_playlist_videos

获取 YouTube 播放列表中的所有视频。

费用： 每页 1 个额度。

13. get_credits _{· 免费}

查询密钥/账户的剩余额度。无需参数。

费用： 免费。

使用场景与提示词

定价与速率限制

• 1 个额度 = 1 次成功请求。失败或受速率限制的请求不会消耗额度。
• get_credits 是唯一免费的工具。
• 管理账单 →

故障排除

验证

此仓库包含本地 stdio MCP 服务的 MIT 许可源代码，位于 server/ （工具定义、输入验证、API 调用、错误映射），以及托管端点的清单。托管端点及其背后的 REST API 均由 getyoutubetranscript.com 运行，且不是开源的。你可以自行检查其中任一项：

• 运行本地服务的实时测试 — GYT_API_KEY=sk_live_... npm test --prefix server 会通过 stdio 启动 server/index.js，列出全部 13 个工具，并调用免费的工具。
• 针对托管端点运行 verify.js — 零依赖，无需身份验证：

  node verify.js
  

  它会针对实时端点执行真实的 MCP 握手（先执行 initialize，再执行 tools/list），并打印服务的实际响应，其中包含全部 13 个真实工具架构。 工具的发现是公开的；只有工具调用需要 API 密钥或 OAuth 令牌（参见 身份验证）。
• 经四个第三方 MCP 目录独立验证，这些目录均连接了实时端点并确认了工具本身（而不只是听信我们的说法）：
  • Official MCP Registry — com.getyoutubetranscript/youtube-transcript-and-youtube-search，通过经过域名所有权验证的 HTTP mcp-publisher 发布
  • Smithery — 其自有扫描器连接并发现了全部 6 个工具
  • Glama
  • LobeHub
• 自 2026-09-12 起运行 — OAuth 2.1（DCR + CIMD）流程也已由真实的第三方客户端（Smithery）通过 CIMD 连接并进行端到端测试，期间发现了一个互操作性问题并完成了修复（参见提交历史）。

另有 REST API 可用

你要构建的是应用而非 Agent？同一后端也是一个普通的 JSON REST API — 完整的端点参考请参阅 Agent Skill repo，或前往控制面板直接获取密钥。

基础 URL：https://getyoutubetranscript.com/api/v1

联系方式

• 🌐 网站： getyoutubetranscript.com
• 🔑 控制面板： getyoutubetranscript.com/dashboard
• 🧩 Agent Skill 版本： tubeagentkit/youtube-transcript-skills

声明

getyoutubetranscript.com 是一款独立产品，与 YouTube 或 Google 无关联，也未获其认可。

相关项目

使用 GetYouTubeTranscript API 的其他方式：

• youtube-transcript-api：YouTube Transcript API 文档、端点参考、OpenAPI 规范，以及 curl、Python、JavaScript、Go 和 PHP 示例
• youtube-transcript-api-python：适用于 Python 的 YouTube Transcript API SDK
• youtube-transcript-api-node：适用于 Node.js / TypeScript 的 YouTube Transcript API SDK
• youtube-transcript-skills：适用于 Claude Code、Cursor、Codex 和 OpenClaw 的 YouTube transcript Agent Skill
• youtube-transcript-cursor-plugin：YouTube Transcript Cursor 插件，集成 MCP 服务、技能、命令和研究 Agent
• n8n-nodes-getyoutubetranscript：YouTube transcript n8n 社区节点，也可用作 AI Agent 工具

许可证

MIT — 参见 LICENSE。