AI导哈

YouTube数据管理服务器

一个全面的YouTube数据管理服务器，提供对YouTube数据API v3、分析API和报告API的访问，支持视频管理、分析、评论等多种功能。

  • by pauling-ai
  • Python
  • 本地部署
  • 29 星标
  • 更新于
在 GitHub 查看 pauling-ai/youtube-mcp-server

使用说明

YouTube MCP服务器

全面 模型上下文协议 YouTube Data API v3、Analytics API和Reporting API的服务器。让AI助手完全访问您的YouTube频道——分析、视频管理、评论等。

40工具 涵盖：

  • 频道和视频数据
  • YouTube分析（性能、受众、留存率、收入）
  • 视频发布和播放列表管理
  • 转录提取
  • YouTube搜索引擎优化（搜索建议、趋势）
  • 评论
  • 批量报告

为什么选择此服务器？

现有的YouTube MCP服务器仅专注于抄本抓取或基本搜索。此服务器涵盖 三个YouTube API 并且是唯一提供以下功能的开源MCP服务器：

  • YouTube分析API --频道表现、热门视频/短片、观众留存曲线、流量来源、人口统计、收入、每周分析
  • YouTube报告API --安排和下载批量CSV报告
  • API全面数据覆盖 --不仅可以阅读，还可以上传视频、管理播放列表、发表评论、设置缩略图
  • YouTube搜索引擎优化工具 --自动完成建议、热门视频、类别发现
  • 双重转录策略 -官方字幕API为您自己的视频， youtube-transcript-api 任何公共视频的回退
  • 配额跟踪 --具有硬故障保护的客户端跟踪，这样您就不会在不知不觉中耗尽每日配额
功能 此服务器 其他
分析API（观察时间、保留时间、CTR） 是 否
报告API（批量CSV导出） 是 否
视频上传和管理 是 罕见
播放列表管理 是 罕见
评论（读+写） 是 否
搜索引擎优化/趋势/建议 是 否
转录提取 是 是
配额跟踪 是 否
工具总数 40 1-5

先决条件

  • Python 3.11+
  • 启用了YouTube API的Google Cloud项目
  • OAuth 2.0凭据

谷歌云设置

1.创建谷歌云项目

  1. 首选 Google 云控制台
  2. 创建新项目（或使用现有项目）

2.启用API

在中启用所有三个API API和服务>库:

  • YouTube数据API v3
  • YouTube分析API
  • YouTube报告API

3.配置OAuth同意屏幕

  1. 首选 API和服务>OAuth同意屏幕
  2. 将用户类型设置为 外部的
  3. 填写应用程序名称和必填字段
  4. 添加Google帐户 拥有 您的YouTube频道 测试用户

重要提示： 您必须使用以下Google帐户登录 拥有 YouTube频道，而不是经理。只有所有者帐户可以访问Analytics数据。

4.创建OAuth凭据

  1. 首选 API和服务>凭据
  2. 点击 创建凭据>OAuth客户端ID
  3. 应用程序类型： 桌面应用程序
  4. 下载JSON文件
  5. 另存为 ~/.youtube-mcp/client_secret.json

或者，设置 YOUTUBE_MCP_CLIENT_SECRET 将环境变量设置为凭据文件的路径。

安装

pip install youtube-studio-mcp

或者使用紫外线：

uv pip install youtube-studio-mcp

MCP客户端配置

克劳德桌面

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "youtube": {
      "command": "youtube-studio-mcp"
    }
  }
}

克劳德代码

添加到MCP设置中：

{
  "mcpServers": {
    "youtube": {
      "command": "youtube-studio-mcp"
    }
  }
}

有环境变量

{
  "mcpServers": {
    "youtube": {
      "command": "youtube-studio-mcp",
      "env": {
        "YOUTUBE_MCP_CLIENT_SECRET": "/path/to/client_secret.json",
        "YOUTUBE_API_KEY": "your-api-key-for-public-data"
      }
    }
  }
}

首次运行

首次使用时，服务器将打开一个浏览器窗口以获得Google OAuth同意。使用拥有您的YouTube频道的帐户登录，并授予所请求的权限。令牌保存到 ~/.youtube-mcp/token.json 以及自动刷新。

工具参考

身份验证和设置（2个工具）

工具 说明
youtube_auth 启动OAuth 2.0流程
youtube_auth_status 检查身份验证状态和配额使用情况

频道和视频（3个工具）

工具 说明
youtube_get_channel 通过ID、句柄或 mine=True
youtube_list_videos 列出频道或播放列表中的视频
youtube_get_video 获取详细的视频元数据和统计数据

搜索和搜索引擎优化（4个工具）

工具 说明
youtube_search 搜索YouTube（每次通话100个配额单位）
youtube_search_suggestions 获取自动完成建议（无配额成本）
youtube_trending 按地区/类别获取热门视频
youtube_get_categories 列出某个地区的视频类别

成绩单（2个工具）

工具 说明
youtube_get_transcript 获取视频记录（官方API或抓取回退）
youtube_list_captions 列出自己视频的字幕曲目

分析——性能（4个工具）

工具 说明
youtube_analytics_overview 频道摘要（浏览量、观看时间、订阅量、点赞）
youtube_analytics_top_videos 热门视频（不包括短片）
youtube_analytics_top_shorts 按风景划分的上衣短裤
youtube_analytics_video_detail 特定视频的每日指标

分析——受众（3个工具）

工具 说明
youtube_analytics_traffic_sources 流量来源细分
youtube_analytics_demographics 年龄和性别细分
youtube_analytics_geography 按国家分列的意见

分析——进度和到达（3个工具）

工具 说明
youtube_analytics_daily 一段时间内的日常表现
youtube_analytics_day_of_week 工作日平均表现
youtube_analytics_content_type_breakdown 短裤vs长款vs现场比较

分析——收入和留存（3个工具）

工具 说明
youtube_analytics_revenue 收入明细（需要YouTube合作伙伴计划）
youtube_analytics_revenue_by_video 每视频收入
youtube_analytics_retention 视频的观众保留曲线

出版（4个工具）

工具 说明
youtube_upload_video 上传视频（1600个配额单位）
youtube_update_video 更新视频元数据
youtube_set_thumbnail 上传自定义缩略图
youtube_delete_video 删除视频

播放列表（4个工具）

工具 说明
youtube_list_playlists 列出频道的播放列表
youtube_create_playlist 创建新的播放列表
youtube_add_to_playlist 将视频添加到播放列表
youtube_remove_from_playlist 从播放列表中删除视频

评论（3个工具）

工具 说明
youtube_list_comments 列出对视频的评论
youtube_post_comment 发表顶级评论
youtube_reply_to_comment 对评论的回复

批量报告（5个工具）

工具 说明
youtube_reporting_list_types 列出可用的报告类型
youtube_reporting_create_job 安排每日报告作业
youtube_reporting_list_jobs 列出活动报告作业
youtube_reporting_list_reports 列出为作业生成的报告
youtube_reporting_download 下载CSV报告

配额管理

YouTube Data API v3的默认每日配额为 10000台。此服务器跟踪客户端和客户端的配额使用情况 硬失败 当配额用尽时。

关键成本：

  • 大多数读取操作： 1台
  • 搜索： 100台
  • 写入操作： 50台
  • 视频上传： 1600台

使用 youtube_auth_status 检查当前配额使用情况。

环境变量

变量 描述
YOUTUBE_MCP_CLIENT_SECRET 通往 client_secret.json
YOUTUBE_MCP_CONFIG_DIR 配置目录（默认： ~/.youtube-mcp)
YOUTUBE_API_KEY 用于公共操作的API密钥

发展

git clone https://github.com/pauling-ai/youtube-studio-mcp.git
cd youtube-studio-mcp
uv venv && uv pip install -e ".[dev]"
.venv/bin/python -m pytest tests/ -v

许可证

麻省理工学院

相关 MCP