BulkTranscripts: YouTube Transcripts

BulkTranscripts MCP 服务

为 AI Agent 提供 YouTube 字幕稿——单个视频、整个频道或播放列表—— 还可通过一个托管的 MCP 服务搜索 YouTube 并免费追踪新上传内容。无需本地进程，无需持续更新 yt-dlp ，也无需应对 IP 封锁：提取、代理轮换和 PO 令牌处理均在服务端完成。

• 端点： https://bulktranscripts.co/mcp（Streamable HTTP）
• 身份验证： OAuth（使用 Google 登录，可免费使用 30 个额度，无需银行卡）或使用 Bearer 令牌形式的 API 密钥
• 注册表： co.bulktranscripts/youtube · Glama 连接器
• 设置文档： https://bulktranscripts.co/docs#mcp · REST API： https://bulktranscripts.co/docs

安装

Claude Code

claude mcp add --transport http bulktranscripts https://bulktranscripts.co/mcp

运行 /mcp，选择 bulktranscripts 并登录。此代码库也是一个 Claude Code 插件（服务 + 技能）：

/plugin marketplace add pratie/bulktranscripts-mcp
/plugin install bulktranscripts@bulktranscripts

Claude（网页端和桌面端）

设置 → 连接器 → 添加自定义连接器 → URL https://bulktranscripts.co/mcp。 Claude 会打开 Google 登录页面；之后额度将关联到你的账号。

ChatGPT

设置 → 应用与连接器 → 开发者模式 → 创建 → URL https://bulktranscripts.co/mcp，身份验证选择 OAuth。

Gemini CLI

gemini extensions install https://github.com/pratie/bulktranscripts-mcp

Gemini CLI 首次使用时会打开 OAuth 页面，请使用 Google 登录。

Cursor、VS Code、Windsurf，以及任何使用 JSON 配置的客户端

{
  "mcpServers": {
    "bulktranscripts": {
      "type": "http",
      "url": "https://bulktranscripts.co/mcp"
    }
  }
}

支持 OAuth 的客户端会在首次请求时启动登录流程。不支持 OAuth 的客户端则发送 API 密钥——前往 https://bulktranscripts.co/app?tab=mcp 免费创建密钥（使用 Google 登录，可免费使用 30 个额度），或使用额度包中的许可证密钥：

{
  "mcpServers": {
    "bulktranscripts": {
      "type": "http",
      "url": "https://bulktranscripts.co/mcp",
      "headers": { "Authorization": "Bearer ${BULKTRANSCRIPTS_API_KEY}" }
    }
  }
}

无法发送标头的客户端可以在 URL 后附加 ?key=YOUR_KEY。

Agent 可以执行的操作

工具	功能	费用
get_transcript	获取一条 YouTube（或 TikTok）视频的完整字幕稿，包含整洁的文本和元数据；可按需获取带时间戳的片段。	1 个额度；从你的资料库重复读取免费
get_transcripts	单次调用最多处理 20 条视频；对于没有字幕的视频，会逐项报告，批量处理不会因此失败。	每条新字幕稿 1 个额度
search_youtube	按关键词搜索 YouTube 上的视频、频道或播放列表。	1 个额度
search_channel	在单个频道的上传内容中搜索主题。	1 个额度
get_channel_videos	列出某个频道最多 1,000 条视频（ID、标题、时长、URL）。	1 个额度
get_playlist_videos	按顺序列出公开或不公开播放列表中的最多 1,000 条视频。	1 个额度
get_latest_videos	通过 RSS 获取某个频道最新上传的视频及其发布日期。	始终免费
start_bulk_extract	通过后台任务获取频道、播放列表或视频 URL 中的所有字幕稿（最多 1,000 条）；会立即返回 run_id。	列出内容免费；每条新字幕稿 1 个额度
get_bulk_status	查看批量任务进度，并获取 check_again_in_seconds，让 Agent 按合适的间隔轮询。	免费
list_bulk_results	分页查看批量任务中每条视频的处理结果（ID、标题、频道、时长、字数、状态）。文本可通过 get_transcript 获取；内容存入资料库后免费读取。	免费

所有工具均为只读：YouTube 和你的账号中的任何内容都不会被修改或删除。字幕稿只需存入资料库一次，之后即可免费、以任意格式永久重复读取，因此 Agent 再次访问相同视频时不会消耗额度。 get_latest_videos 有意设为免费：轮询它以检测新上传内容，然后只为真正新增的内容消耗额度。对于超过约 20 条视频的任务，start_bulk_extract 会在服务端处理整个频道或播放列表，同时由 Agent 轮询 get_bulk_status。

示例提示词

总结 @veritasium 最近的 10 个视频，并告诉我哪些视频涉及量子力学。

在 Y Combinator 频道查找有关创始人模式的演讲，并提取文字稿。

关注 @simonwillison 的新上传内容，并转录任何有关本地模型的内容。

身份验证的工作方式

未通过身份验证的请求访问 /mcp 时会收到 401 响应，并附带一个指向 /.well-known/oauth-protected-resource/mcp 的 WWW-Authenticate 挑战。MCP 客户端会据此启动 OAuth 流程（支持动态客户端注册）。同一个 Authorization 标头可接受 API 密钥（bt_ak_…）或许可证密钥，可带或不带 Bearer 前缀。

定价

登录即可获得 30 个免费点数。之后可购买一次性点数包：$4.99 / 200 个点数、$14.99 / 1,200 个点数、$29 / 5,000 个点数。没有订阅，点数永不过期。详情请见 https://bulktranscripts.co/#pricing。

仓库结构

文件	用途
.mcp.json	Claude Code 插件配置（托管端点、OAuth）
.claude-plugin/plugin.json、.claude-plugin/marketplace.json	Claude Code 插件市场
plugin.json、mcp.json	Cursor / agent-plugins.org
.codex-plugin/plugin.json、.agents/plugins/marketplace.json、assets/icon.png	Codex 插件
skills/youtube-transcripts/	MCP 工具的 Agent 技能（REST API 版本位于 pratie/youtube-transcript-skill）
gemini-extension.json	Gemini CLI 扩展（托管端点、OAuth）
server.json	官方 MCP 注册表清单

链接

• 产品：https://bulktranscripts.co
• MCP 页面：https://bulktranscripts.co/youtube-mcp-server
• API 文档：https://bulktranscripts.co/docs · OpenAPI：https://bulktranscripts.co/openapi.json
• 隐私：https://bulktranscripts.co/privacy · 条款：https://bulktranscripts.co/terms
• 联系方式：[email protected]

许可证

MIT — 请参阅 LICENSE。此仓库包含托管服务的清单、插件和技能；提取服务本身由 bulktranscripts.co 运营。