youtube-mcp

这是一个MCP服务器，让你可以直接从Claude分析@ザビエル-zav的YouTube频道。 目标是实现像“上周的视频哪个CTR最好？”这样的问题，能够获取真实数据来回答。

基于Node.js开发（不使用Python）。将YouTube Analytics API / Reporting API / Data API v3 封装在官方的Node库（googleapis、google-auth-library）中， 并通过MCP官方的TypeScript SDK（@modelcontextprotocol/sdk）作为工具公开。

使用的API及分工

只有CTR的获取方式根本不同（批量报告），因此通过 register-reach-job.js 注册任务 → 用 download-reports.js 定期将CSV累积到本地，走的是另一条路径。

Related MCP server: YouTube MCP Server

设置

1. Google Cloud Console

1. 创建项目

2. 启用以下3个API

   • YouTube Analytics API

   • YouTube Reporting API

   • YouTube Data API v3

3. 配置OAuth同意屏幕（用户类型=外部，将自己的Google账号添加到测试用户）

4. 在 凭据 > OAuth客户端ID > 应用类型=桌面应用 中创建，并下载JSON

5. 将下载的JSON以 client_secret.json 的名称放在此仓库根目录下

   绝对不要提交 client_secret.json 以及首次认证后生成的 token.json。 虽然已在 .gitignore 中，但注意不要误用 git add -f。

2. Node.js和依赖包

需要Node.js 18以上（如果未安装，从 nodejs.org 安装LTS版。 安装程序中已包含 npm，因此基本不需要像Python那样单独设置PATH）。

npm install

3. 注册触达报告（CTR）任务 — 最优先执行

Reporting API 从“注册任务之日”开始生成数据，过去的数据最多也只能追溯到 注册时点的30天前。注册越晚，过去的CTR数据丢失越多， 所以请在其他工作之前先执行这一步。

npm run register-reach-job

首次会打开浏览器要求认证（之后通过 token.json 自动更新）。

4. 启动MCP服务器

npm start

如果要从Claude Desktop使用，请在 claude_desktop_config.json 中按如下方式注册。

{
  "mcpServers": {
    "youtube-analytics": {
      "command": "node",
      "args": ["/absolute/path/to/youtube-mcp/server.js"]
    }
  }
}

5. 下载触达报告（注册后数小时〜2天）

npm run download-reports

CSV会累积到 data/reach/<report_type>/ 目录下。报告会在YouTube侧保留60天 （过去数据部分为30天）后消失，因此请定期（最好每天1次）持续执行。 Windows可使用任务计划程序，Mac/Linux可注册到cron。 get_reach 工具会读取这些本地CSV。

公开工具列表

输出不是原始JSON，而是返回四舍五入后的数值、上限约20条左右的文本表格 （为了减少Claude侧的上下文消耗）。

已知限制

• Analytics API的数据比YouTube Studio显示最多延迟约2天。有时无法获取“昨天的数据”。

• get_reach 只查看已下载到本地的CSV。未执行 download-reports.js 期间的数据不会出现。

• channel_reach_basic_a1 / channel_reach_combined_a1 的准确列结构尚未确认。get_reach 采用了通过关键词推测列名来读取的备用方案，但请用实际下载的CSV表头确认一次。

• 未添加写入类权限（只读）。不存在误修改或删除视频的途径。

部署目标的分支

如果也想在手机上使用，最快的方式是将 StdioServerTransport 切换为 StreamableHTTPServerTransport （@modelcontextprotocol/sdk/server/streamableHttp.js）， 并搭载到现有的托管环境中。