给你的 AI 代理 YouTube 转录文本:MCP 与 Claude Code、Codex 和 claude.ai

将 YouTube 链接粘贴到聊天中并希望模型"知道"视频不工作——模型不能看视频。工作的是什么:给你的代理一个获取实际转录文本的工具。youtube2text.org 运送一个托管 MCP(模型上下文协议)服务器,做恰好那个。
端点:https://youtube2text.org/mcp(流 HTTP、无状态)。它暴露一个工具:
transcribe_video(url, maxChars?)——返回{title, content, contentSize, videoId, pubDate, truncated}。
一旦连接,你只是问:"在五个项目符号中总结 https://www.youtube.com/watch?v=...",代理自己拉转录文本。
claude.ai(网页和桌面)
- 设置 → 连接器 → 添加自定义连接器
- URL:
https://youtube2text.org/mcp - 完成 Google 登录并单击允许。
服务器用动态客户端注册和 PKCE 实现 OAuth 2.1,所以 claude.ai 自动处理整个握手——没有密钥复制周围。使用针对你的 youtube2text 账户计划计数。
Claude Code
claude mcp add --transport http youtube2text https://youtube2text.org/mcp
然后在会话内运行 /mcp 完成 OAuth 登录。从那点每个 Claude Code 会话可以按需转录视频——对于将会议谈话变成笔记或文档很好。
Codex 和其他 MCP 客户端
任何说流 HTTP 的客户端都可以连接。如果你的客户端不做 OAuth,用 API 密钥代替认证——作为 Authorization: Bearer <key> 或 x-api-key 发送它。从仪表板获得密钥(或共享演示密钥从 GET /api/demo-key)。
直接调用 Claude API?添加这个到 Messages 请求的 mcp_servers 数组:
{"type": "url", "url": "https://youtube2text.org/mcp", "name": "youtube2text",
"authorization_token": "<YOUR_API_KEY>"}
使用 OpenAI Responses API:
{"type": "mcp", "server_label": "youtube2text",
"server_url": "https://youtube2text.org/mcp",
"headers": {"x-api-key": "<YOUR_KEY>"}, "require_approval": "never"}
人们用它构建什么
- 视频摘要器——馈送谈话、讲座和播客到 LLM 管道。
- 研究代理——让代理引用实际措辞而不是幻想说什么。
- 内容重新利用——转录文本进入、博客文章/线程/展示笔记出来。
- 对频道的 RAG——索引转录文本并对整个频道回答问题。
更喜欢纯 REST?
相同的能力可用作一个经典 HTTP API——看在 30 秒内用 curl 提取 YouTube 转录文本。代理读这个:完整的机器可读参考在 youtube2text.org/api.md(索引:/llms.txt)。