YouTube MCP 服务器

将 Claude 连接到您的 YouTube 频道。 从 Claude Desktop、Claude Code 或任何 MCP 客户端读取分析数据、获取完整视频元数据（包括未列出/私有/草稿）、搜索您的上传内容并更新标题/描述/标签。

这是什么？

一个通过 OAuth2 将 Claude 连接到 YouTube Data API v3 和 YouTube Analytics API 的 模型上下文协议 (MCP) 服务器。

无需再将数据从 YouTube 工作室复制到 AI 工具中，只需询问 Claude：

“获取此视频的完整标题、描述和标签”
“我本月表现最好的视频有哪些？”
“更新我最新上传视频的标题和标签”
“我的流量来自哪里？”

Claude 可以读取您的真实私有频道数据，并能直接更新视频 SEO。

Claude  →  YouTube MCP Server  →  YouTube APIs  →  Your Channel Data
(you)        (this repo)           (OAuth2)         (stays local)

一切都在您的机器上运行。具备读写权限。不会向第三方发送任何内容。

提供 10 种工具

视频元数据（读 + 写）

工具	功能
`get_video_details`	通过 ID 或 URL 获取任何视频的完整元数据 — 标题、完整描述、所有标签、类别、隐私状态（公开/未列出/私有/草稿）、统计信息、时长、缩略图 URL
`search_my_videos`	按关键字搜索您自己频道的视频。返回匹配视频的元数据 + 统计信息
`update_video_seo`	直接更新任何视频的标题、描述和/或标签。仅更改您提供的字段

频道分析

工具	功能
`get_channel_overview`	订阅者、总观看次数、视频数量、频道描述、创建日期
`get_all_videos`	列出所有带有统计信息（观看次数、点赞数、评论数、标签、隐私状态）的视频。按日期或观看次数排序
`get_analytics_over_time`	任何日期范围内的每日观看次数、观看时长、订阅者增减情况
`get_top_videos_analytics`	按观看次数排名的表现最佳视频，包含留存率 %、观看时长、新增订阅者
`get_audience_demographics`	受众细分：主要国家/地区、设备类型、年龄段、性别
`get_traffic_sources`	观众来源：YouTube 搜索、推荐、浏览功能、外部、直接访问
`analyze_and_suggest_topics`	获取频道 + 热门视频数据，用于 AI 驱动的主题分析

安装

选项 A：npx（无需安装 — 直接运行）

npx youtube-studio-mcp

选项 B：全局安装

npm install -g youtube-studio-mcp

— 连接到 Claude Code

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)：

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

或者如果通过 npm 安装：

{
  "mcpServers": {
    "youtube-analytics": {
      "command": "npx",
      "args": ["-y", "youtube-studio-mcp"]
    }
  }
}

Claude Code (终端)

claude mcp add youtube-analytics node /full/path/to/youtube-studio-mcp/server.js

VS Code

添加到 .vscode/settings.json：

{
  "mcp.servers": {
    "youtube-analytics": {
      "command": "npx",
      "args": ["-y", "youtube-studio-mcp"]
    }
  }
}

即用型提示词

SEO 审计（任何视频）

Get the full details for this video: [paste URL or ID]
Check what keywords it's ranking for and suggest optimized title + tags

频道表现报告

Pull my channel overview, top 20 videos by watch time, 90-day analytics,
traffic sources and audience demographics. Give me a full performance report.

视频主题研究

Get my top 20 videos by watch time. What patterns do you see —
topics, lengths, title styles? Suggest 10 new video ideas.

更新视频 SEO

Search my videos for "elementor menu". Pull the full details.
Write an optimized title, description, and tags — then update it.

受众深度分析

Show my full audience demographics — age, gender, countries, devices.
What content style and posting schedule fits my actual audience?

表现不佳诊断

Get all my videos. Compare bottom 10 vs top 10 by views.
Why did the lower ones underperform? What would you change?

技能 + MCP 如何协同工作

You: "Optimize this video: youtube.com/watch?v=abc123"

Claude:
  1. youtube-seo-optimizer skill activates
  2. Calls get_video_details → pulls current title, description, tags
  3. Checks YouTube SERP for current rankings
  4. Lists PROTECTED keywords (won't remove)
  5. Writes 3 new title options + full description + 20 tags
  6. Can call update_video_seo to apply changes directly

技能告诉 Claude 做什么。MCP 工具为 Claude 提供访问您数据的权限。它们共同创建了一个完整的 YouTube AI 工作流。

安装技能

Claude Desktop / Claude Code：

# Copy a skill to your Claude skills directory
cp skills/youtube-seo-optimizer.md ~/.claude/skills/

或者安装全部 8 个：

cp skills/youtube-*.md ~/.claude/skills/

OAuth 范围

范围	用途
`youtube`	读写视频元数据（标题、描述、标签）
`youtube.readonly`	读取视频数据、搜索、列表
`yt-analytics.readonly`	读取私有分析数据（观看次数、观看时长、订阅者、人口统计）
`youtubepartner-channel-audit`	扩展频道审计数据

要启用写权限 (update_video_seo)，请删除 tokens.json 并重新运行 node auth.js。新的授权流程会请求 youtube 写权限范围。

文件

youtube-studio-mcp/
├── server.js          ← MCP server (10 tools)
├── auth.js            ← Run once to link YouTube account
├── package.json       ← Dependencies + npm config
├── skills/            ← 8 AI skills for YouTube creators
├── LICENSE            ← MIT
├── credentials.json   ← YOU add this (never commit!)
└── tokens.json        ← Auto-created after auth (never commit!)

贡献

功能

字幕提取 (YouTube 字幕 API)
YouTube Shorts 专项分析
收入/变现数据 (YouTube Reporting API)
播放列表管理工具
评论管理工具
缩略图上传

许可证

Adiya Sharma MIT

YouTube MCP Server