Youtube MCP By Transcriptapi

面向 AI Agent 的 YouTube 字幕 + YouTube 搜索 MCP

面向 AI Agent 的最快 YouTube 字幕 + YouTube 搜索 MCP。免费试用。
提供 12 种工具：字幕、视频和频道元数据、视频搜索、频道浏览、频道内搜索、播放列表提取和新上传内容轮询，适用于 Claude、ChatGPT、Cursor、VS Code、Claude Code 及 20 多种客户端。

每月为 1,500 多万条字幕提供支持 · 每日处理 50 多万条字幕 · 中位响应时间为 49 毫秒 youtubetotranscript.com（约 1,100 万/月）和 recapio.com（约 280 万/月）均在生产环境中信赖并使用。

为什么选择 TranscriptAPI MCP

大多数 YouTube MCP 服务只做一件事：获取单条字幕。TranscriptAPI MCP 是一套完整的工具包：字幕、视频搜索、频道搜索、频道浏览、播放列表提取，以及免费的基于 RSS 的上传内容追踪，全部通过一个远程端点提供，专为 AI Agent 打造。

快速体验：

Find @NASA's three most-viewed videos about the Moon landing,
get the transcript of each, and write a 5-bullet comparison.

这个提示词只用到了我们 12 种工具中的 3 种（search_youtube、search_channel_videos、get_youtube_transcript），你无需编写任何代码。

🧩 安装为 Agent 插件 _{· 最简单}

此仓库根目录是一个符合规范的 Agent Plugins 1.0.0 软件包：这是一种于 2026-08-06 发布的可移植格式，受 ChatGPT、Codex、Cursor、GitHub Copilot、Kiro 和 VS Code 支持。安装一次，即可获得 MCP 服务，以及内置的 youtube 技能，该技能会教你的 Agent 何时使用各个工具，以及如何避免浪费点数。

plugin.json                    # Agent Plugins 1.0.0 manifest
mcp.json                       # hosted MCP server, streamable-http, OAuth (no keys)
skills/youtube/SKILL.md        # when + how to use the 12 tools
.cursor-plugin/plugin.json     # Cursor plugin manifest, same MCP + skill (+ marketplace.json)

VS Code：打开命令面板 → Chat: Install Plugin From Source，然后粘贴：

https://github.com/ZeroPointRepo/youtube-mcp

或者在 settings.json 中注册本地克隆：

"chat.pluginLocations": { "/absolute/path/to/youtube-mcp": true }

Cursor：点击侧边栏中的 Customize → 找到该插件 → Install。如需使用本地克隆：

git clone https://github.com/ZeroPointRepo/youtube-mcp ~/.cursor/plugins/local/transcriptapi

然后执行 Developer: Reload Window。

添加到 Cursor：仅安装 MCP 服务，无需克隆。将此深层链接粘贴到浏览器中：

cursor://anysphere.cursor-deeplink/mcp/install?name=transcriptapi&config=eyJ1cmwiOiJodHRwczovL3RyYW5zY3JpcHRhcGkuY29tL21jcCJ9

ChatGPT、Codex、GitHub Copilot、Kiro 及其他客户端：将客户端的插件机制指向此仓库或本地克隆。Agent Plugins 1.0.0 标准化的是软件包格式，而非安装方式，因此每个客户端都有自己的安装流程。

30 秒示例

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

Agent 会调用 get_youtube_transcript，获取完整的带时间戳字幕稿并进行总结。无需配置 API 密钥：首次调用时会打开 OAuth 登录页面（免费账户，含 100 点数，无需银行卡）。然后试试：

What has @TED posted in the last month?     → get_channel_latest_videos (free)
Find talks on protein folding, summarize the best three.
                                             → search_youtube, then transcripts

此软件包不包含任何凭据：Agent Plugins 1.0.0 禁止嵌入机密信息，授权由客户端管理。你可以自行验证此软件包：

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

🛠️ 快速安装

要求：

• TranscriptAPI 账户（免费注册，前 100 点数免费）
• 从控制面板获取 API 密钥，或使用 OAuth（Claude、ChatGPT）

推荐：添加规则以自动调用 TranscriptAPI

将此规则添加到你的 AI 客户端，这样就无需明确要求获取字幕稿：

当我分享 YouTube URL 时，自动使用 TranscriptAPI MCP 工具
在回复前获取字幕稿。此规则适用于任何关于 YouTube 内容的视频分析、
总结或提问。

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

claude mcp add --transport http transcript-api https://transcriptapi.com/mcp

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

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

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

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

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

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

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

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

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

{
  "mcpServers": {
    "transcript-api": {
      "httpUrl": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "transcript-api": {
      "httpUrl": "https://transcriptapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

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

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

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

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

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

{
  "url": "https://transcriptapi.com/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}

🔐 身份验证

API Key

简单且通用。适用于所有 MCP 客户端。

1. 从你的 dashboard 获取 API key
2. 密钥以 sk_ 前缀开头
3. 在配置中将其添加为 Bearer 令牌：

"headers": {
  "Authorization": "Bearer sk_your_api_key_here"
}

安全提示： 尽可能将密钥存储在环境变量中，切勿将其提交到版本控制系统。

OAuth 2.1

自动、安全地完成身份验证，无需手动管理密钥。

动态客户端注册（DCR）：

• 支持：Claude Desktop、Claude Web、ChatGPT
• 只需添加 MCP URL：客户端会自动注册
• 无需凭据
• 通过浏览器重定向授权一次即可

静态客户端注册：

• 支持：ChatGPT（可选）
• 从 MCP Integration Dashboard 获取 Client ID + Secret
• 更好地控制客户端身份

完整参考：身份验证文档 →

🧰 可用工具

连接后会自动提供全部 12 个工具。除非下方另有说明，每次成功调用消耗 1 个额度。 失败或受到速率限制的调用不会消耗额度。

该用哪个视频工具？ 获取字幕前，使用免费的 get_youtube_video_info 查看字幕语言。若要获取观看/点赞数、发布日期、说明、时长、标签或相关视频，请使用 get_video_metadata（1 个额度）。

1. get_youtube_transcript

以 Markdown（含元数据）或结构化 JSON 格式获取任意 YouTube 视频的字幕。输出可直接用于摘要工具、搜索索引或 AI 流水线。

费用： 每次成功请求消耗 1 个额度。

输出示例（Markdown）：

# Metadata

## Title: Rick Astley - Never Gonna Give You Up
## Author: RickAstleyVEVO

# Transcript

[0.0s] Never gonna give you up
[4.12s] Never gonna let you down

输出示例（JSON）：

{
  "transcript": [
    { "text": "Never gonna give you up", "start": 0.0, "duration": 4.12 },
    { "text": "Never gonna let you down", "start": 4.12, "duration": 3.85 }
  ],
  "metadata": { "title": "Rick Astley...", "author_name": "RickAstleyVEVO" }
}

2. get_youtube_video_info _{· 免费}

基本元数据（标题、作者、缩略图）以及可用字幕语言列表：调用此工具后，再使用 get_youtube_transcript 选择语言。

费用： 免费。

若要获取观看/点赞数、发布日期、说明、时长、标签或相关视频，请改用 get_video_metadata。

3. get_video_metadata

无需字幕即可获取丰富的视频元数据：标题、观看/点赞数文本、发布日期、结构化说明和链接、上传频道摘要以及缩略图。可选的 include 扩展项会提取更多由播放器提供的数据（时长、类别、标签、字幕轨道清单）和相关视频。

费用： 每次成功请求消耗 1 个额度。

提示词示例：

Get the view count, publish date, and tags for https://youtu.be/UF8uR6Z6KLc.

4. search_youtube

在 YouTube 上搜索视频、频道、播放列表或电影。可按类型、排序方式、上传日期或时长筛选，也可使用续页令牌进行分页，非常适合发现内容、开展研究和构建内容流水线。

费用： 每页 1 个积分（每页约 20 条结果）。

提示词示例：

Search YouTube for "transformer architecture explained" and pick the
top 3 results by relevance.

5. get_channel_info

频道简介：标题、@handle、认证标记、订阅者/视频数文本、简介、关键词、标签、缩略图、横幅以及频道提供的标签页。不支持分页。

费用： 每次成功请求 1 个积分。

使用 tab 调用 get_channel_sections 或 list_channel_videos 前，请先检查返回的标签页。

6. get_channel_latest_videos _{· 免费}

通过 RSS 获取任意频道最近上传的约 15 个视频。非常适合监控、每日摘要或触发下游流水线。

费用： 免费。

提示词示例：

Every morning, list new uploads from @NASA and @natgeo.

7. search_channel_videos

在某个指定频道中搜索符合查询条件的视频。非常适合研究创作者的内容，或在大型频道中查找小众主题。

费用： 每页 1 个积分（每页约 30 条结果）。

提示词示例：

On @NASA's channel, find every video about the Moon landing.

8. list_channel_videos

使用分页列出频道的视频内容。使用 tab 选择上传内容信息流（默认值，每页约 100 条）、Shorts 或直播（每页约 48 条），还可选择 sort，按最新、热门或最早排序 Videos 标签页。非常适合构建数据库、批量提取文字稿或审核频道的完整内容库。

排序。 为 channel/videos 添加 sort=latest、popular 或 oldest，即可按所需顺序获取频道视频，例如优先显示最热门的上传内容。排序后的页面约返回 30 个视频（未排序的页面约返回 100 个），每页费用均为 1 个 credit。

排序结果来自 YouTube 的 Videos 标签页（仅长视频）；Shorts 使用独立的 tab=shorts 信息流。

翻页时，每次请求都要使用相同的 sort。

每个条目都包含 members_only：只有 YouTube 为视频标记“仅限会员”时才为 true；这些条目没有 viewCountText，因为 YouTube 不会公开会员内容的观看次数。在上传内容信息流、tab: "shorts" 和播放列表中，该值始终为 false。

tab: "streams" 的条目包含 lengthText 和 publishedTimeText（例如 Streamed 2 years ago，或直播期间显示的 LIVE 和观看人数）。tab: "shorts" 的这两个字段均为 null，因为 YouTube 的 Shorts 网格不会提供时长或发布日期。在频道标签页信息流中（tab: "videos" 且带有 sort、tab: "shorts"、tab: "streams"），channelId、channelTitle、channelHandle 和 index 均为 null。

费用： 每页 1 个 credit。

9. list_channel_playlists

分页列出频道中的播放列表（ID、标题、URL、视频数量文本、缩略图）。将返回的播放列表 ID 传递给 list_playlist_videos，即可获取其中的视频。

费用： 每页 1 个 credit。

10. list_channel_posts

分页列出频道社区（Posts 标签页）中的内容：文本、发布时间、点赞数文本，以及附件（图片、多图、视频、播放列表或投票）。没有社区标签页的频道会返回空结果列表，而不是报错。

费用： 每页 1 个 credit。

11. get_channel_sections

获取频道页面上经过整理和分组的板块：按频道自己的顺序展示带标题的视频、播放列表、Shorts 或推荐频道。结果不会分页。

**费用：**每次成功请求消耗 1 个额度。

podcasts 和 releases 仅适用于包含这些内容的频道（否则结果为空）。

12. list_playlist_videos

获取 YouTube 播放列表中的所有视频（支持 PL/UU/LL/FL/OL ID）。通过一次调用处理完整课程、讲座系列或精选合集。

**费用：**每页消耗 1 个额度（每页约 100 条结果）。

💡 使用场景与提示词

💳 定价与速率限制

• 1 个额度 = 1 次成功请求（HTTP 200）
• 失败和受到速率限制的请求不会消耗额度。
• get_channel_latest_videos 免费（不消耗额度）。
• 查看定价 · 管理额度

🚨 故障排查

🔗 也提供 REST API

要构建应用而非 Agent？同一后端也以 JSON REST API 的形式提供。

基础 URL：https://transcriptapi.com/api/v2

🤝 联系我们

• 🌐 网站： transcriptapi.com
• 📚 文档： transcriptapi.com/docs
• 🔧 API 参考： transcriptapi.com/docs/api
• 🤖 MCP 设置指南： Claude · ChatGPT · OpenAI Agent Builder
• 💬 联系方式： transcriptapi.com/contact
• 📂 收录于： awesome-agent-plugins，这是我们收录经过验证的开放标准 Agent 插件的目录

📋 MCP 注册表

此服务已使用以下名称发布到官方 Model Context Protocol 注册表：

com.transcriptapi/youtube-transcript-and-youtube-search

_{© 2026 Zero Point Studio d.o.o. · 基于 MIT License 发布}