YouTube to Google Sheets MCP Server

基本能力

产品定位

mcp-youtube-sheets 是一个用于自动化搜索 YouTube 视频并将结果保存到 Google Sheets 的工具，旨在提升内容收集和管理的效率。

核心功能

• 使用 YouTube Data API v3 搜索视频
• 自动将搜索结果保存到 Google Sheets
• 可配置的搜索参数（查询词、最大结果数）
• 结果包含视频标题、URL、频道名称和发布日期

适用场景

• 内容创作者需要批量收集相关视频信息
• 研究人员需要整理特定主题的视频资料
• 开发者需要自动化 YouTube 数据收集流程

工具列表

• YouTube Data API v3：用于搜索 YouTube 视频
• Google Sheets API：用于将搜索结果保存到 Google Sheets

常见问题解答

1. 如何获取 YouTube API 密钥？

2. 访问 Google Cloud Console，创建项目并启用 YouTube Data API v3，然后生成 API 密钥。

3. 如何配置 Google Sheets API？

4. 在同一个项目中启用 Google Sheets API，创建服务账户并下载 JSON 密钥文件，然后将目标 Google Sheet 共享给服务账户邮箱。

使用教程

使用依赖

1. YouTube Data API v3 设置
2. 访问 Google Cloud Console
3. 创建新项目
4. 启用 YouTube Data API v3

5. 创建 API 密钥

6. Google Sheets API 设置

7. 在同一项目中启用 Google Sheets API
8. 创建服务账户
9. 下载服务账户密钥（JSON 格式）
10. 将目标 Google Sheet 共享给服务账户邮箱

安装教程

npm install @rikukawa/youtube-sheets-server

配置

将以下配置添加到 MCP 设置文件中：

{
  "mcpServers": {
    "youtube-sheets": {
      "command": "node",
      "args": ["path/to/youtube-sheets-server/build/index.js"],
      "env": {
        "YOUTUBE_API_KEY": "your-youtube-api-key",
        "SPREADSHEET_ID": "your-spreadsheet-id"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

调试方式

使用 AI 助手（如 Claude）发送指令：

搜索 YouTube 视频 "ChatGPT usage" 并获取 10 个视频

确保服务正常运行并检查 Google Sheets 中是否成功保存了搜索结果。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。