YouTube MCP 给 AI 提供一组具体的 YouTube 工具,名字相同不代表能力相同。字幕服务器可能只能读公开视频字幕,没有账号登录或上传工具;账号连接器可能使用 OAuth,提供的是另一组操作。
创作者和小商家应先确定成果:带出处的视频摘要、自己的频道清单,还是待审核的上传素材包。不要按工具数量选服务。本文于 2026 年 11 月 12 日核对公开文档,没有宣称真实账号连接或上传实测。
按数据与权限选连接
| 目的 | 所需连接 | 要核对的边界 |
|---|---|---|
| 总结公开视频 | 能读字幕的服务器 | 字幕是否可用、时间戳覆盖是否完整,不保证每个视频都可读 |
| 查公开标题、播放量和评论 | YouTube Data API,通常使用 API Key | 额度、分页和公开数据范围 |
| 读私有账号数据或改频道 | 带正确范围的 OAuth 与对应工具 | 实际账号、频道与获准操作 |
| 看留存或收入 | 对应分析服务或授权导出 | 公开视频统计不是私有 YouTube Analytics |
Claude Desktop 的一个具体社区方案
Promethic-Labs/youtube-mcp 提供桌面扩展,文档中的步骤是:
- 阅读仓库,从其链接的 GitHub Release 下载
YouTube.mcpb。 - 用 Claude Desktop 打开,核对安装信息。
- 该实现读字幕不需要 API Key;公开搜索和元数据工具需要在扩展设置里填 Google 项目的 YouTube Data API Key。
- 新开启用连接器的对话,先查看实际工具,再读一个你熟悉的公开视频。
维护者说明,桌面扩展使用应用自带运行环境;单独的源码或 CLI 路线则需要 Node 和构建步骤。不要把扩展文件填到远程连接器 URL 中。官方桌面扩展说明介绍了这个本地安装入口。
这是一条读公开数据的路线,不代表应给它频道写权限。列出的工具包括字幕、视频与频道信息、评论、播放列表;能读公开播放列表,不代表能修改播放列表。
第一个研究任务要保留证据
读取这三个视频网址,输出表格:网址、发布日期、主要观点和支持它的字幕时间戳。注明缺失字幕与覆盖缺口;为我们的下一条商品教程提三个原创角度,把来源事实和你的建议分开。不要回评论或上传视频。
这是示例请求,不是实测结果。逐条检查时间戳是否存在、是否支持观点。标题和简介不是字幕;只能读到这些时,报告应写明。如果使用评论,保留样本量与排序方式,不要把几条热门评论称为“观众都这么想”。
比较频道表现时,也要控制视频年龄。昨天发布和去年发布的视频,积累播放量的时间不同。保留发布日期、可比时间窗和读取时间,不要只凭总播放量就认定某种标题导致了表现变化。
字幕、API 与配额,别混成一件事
Google 的官方字幕下载接口要求用户有视频编辑权限,社区服务器读取公开播放器字幕是另一条实现。后者可能因字幕缺失、视频限制或 YouTube 内部接口变化而失败。“字幕不需要 Key”不等于官方授予无限字幕访问。
官方 API 的公开数据请求通常由 Key 标识项目;私有数据和修改操作需要 OAuth。登录频道也不能让不存在的字幕凭空出现。
配额说明很容易过时。社区 README 仍有较旧的搜索成本表,Google 当前配额计算说明已把搜索与上传桶同其他接口分开。应查 Google 当前文档和自己的控制台,不能统一按“所有调用共享每天一万单位”估算。分页也会消耗请求,先用限定条数的清单,不要直接抓完整频道。
在 Orkas 中用 YouTube 连接器
Orkas 连接器目录包含 YouTube。打开连接器,搜索 YouTube,完成界面提供的授权并确认状态;为当前任务选中后,先问有哪些操作,再做小范围读取。实际工具取决于授权和已连接服务,目录描述不能证明每段字幕、每项指标或上传都能成功。
可以逐步完成研究、提纲、脚本、视频草稿和待审核上传包。把有来源的研究与确认过的商品事实交给写作或 VideoStudio agent,标题、简介、封面和可见性选项一起审。本文没有证明自动发布流程,也没有宣称 YouTube 已在 Orkas 中实连成功。
剪辑步骤见Claude 视频剪辑 skill;完整制作任务见Orkas 视频生产。
失败时先定位原因
| 现象 | 检查什么 |
|---|---|
| 没有字幕 | 检查播放器是否有字幕、工具请求的语种或轨道,缺少的证据明确标注。 |
| 公开搜索失败 | 检查 API 是否启用、Key 限制与项目当前配额。 |
| 频道不对 | 读私有数据或写入前,核对授权账号和频道身份。 |
| 数字对不上 | 对齐视频、指标定义、时间段和读取时间,考虑更新延迟。 |
| 没有上传或编辑工具 | 查看真实工具清单及 OAuth 范围,不要假设只读连接器必然含写入。 |
常见问题
YouTube MCP 都是 Google 官方的吗?
不是。本文举例的是社区项目。Google Data API 来自官方,但它的封装不会自动变成官方产品。
能读每个公开视频的字幕吗?
不能。字幕可能缺失、受限或不适用于该获取方式;官方字幕下载 API 还需要编辑权限。
有 API Key 就能上传吗?
不能。私有数据和修改操作需要适当 OAuth 授权,以及实际提供该动作的工具实现。
公开播放量能代替留存数据吗?
不能。它不能说明观众在哪一秒离开或收入来源;这些问题需要授权分析数据或导出。
来源与范围
社区服务器与工具表;Google 的字幕下载、授权和配额文档,2026 年 11 月 12 日核对。配置步骤来自文档,本次没有连接 YouTube 账号;字幕读取和上传均未作为实验结果展示。