YouTube 研究与字幕提取

使用 YouTube Data API v3 搜索 YouTube、获取视频/频道信息，并提取字幕。

功能特性

• 📹 视频详情（标题、描述、统计信息、发布日期）
• 📝 带时间戳的字幕
• 📺 频道信息及最新视频列表
• 🔍 在 YouTube 内搜索
• 🎬 播放列表信息

安装配置

1. 安装依赖项

MCP Server（首选方式）：

npm install -g zubeid-youtube-mcp-server

备用工具（当 MCP 失败时）：

# 使用 yt-dlp 提取字幕
pip install yt-dlp

2. 获取 YouTube API 密钥

1. 访问 Google Cloud Console
2. 创建或选择一个项目（例如 “YouTube Research”）
3. 启用 API：
   • 菜单 → “APIs & Services” → “Library”
   • 搜索：“YouTube Data API v3”
   • 点击 “Enable”
4. 创建凭据：
   • “APIs & Services” → “Credentials”
   • “Create Credentials” → “API Key”
   • 复制生成的密钥
5. （可选）限制密钥权限：
   • 点击已创建的密钥
   • 在 “API restrictions” 中仅勾选 “YouTube Data API v3”
   • 保存设置

3. 配置 API 密钥

选项 A：Clawdbot 配置文件（推荐）
添加至 ~/.clawdbot/clawdbot.json：

{
  "skills": {
    "entries": {
      "youtube": {
        "apiKey": "AIzaSy..."
      }
    }
  }
}

选项 B：环境变量

export YOUTUBE_API_KEY="AIzaSy..."

4. 启动 MCP Server

该技能将通过 mcporter 调用 YouTube MCP Server：

# 若已安装的包存在问题，可从源码构建
cd /tmp
git clone https://github.com/ZubeidHendricks/youtube-mcp-server
cd youtube-mcp-server
npm install
npm run build

使用方法

搜索视频

mcporter call --stdio "node /tmp/youtube-mcp-server/dist/cli.js" 
  search_videos query="ClawdBot AI" maxResults:5

返回视频 ID、标题、描述、频道信息等。

获取频道信息

mcporter call --stdio "node /tmp/youtube-mcp-server/dist/cli.js" 
  channels_info channelId="UCSHZKyawb77ixDdsGog4iWA"

列出频道的最新视频

mcporter call --stdio "node /tmp/youtube-mcp-server/dist/cli.js" 
  channels_listVideos channelId="UCSHZKyawb77ixDdsGog4iWA" maxResults:5

获取视频详情

mcporter call --stdio "node /tmp/youtube-mcp-server/dist/cli.js" 
  videos_details videoId="Z-FRe5AKmCU"

获取字幕（主方式）

mcporter call --stdio "node /tmp/youtube-mcp-server/dist/cli.js" 
  transcripts_getTranscript videoId="Z-FRe5AKmCU"

获取字幕（备用方式，使用 yt-dlp）

若 MCP 字幕调用失败（返回空或不可用），请改用 yt-dlp：

yt-dlp --skip-download --write-auto-sub --sub-lang en --sub-format vtt 
  --output "/tmp/%(id)s.%(ext)s" 
  "https://youtube.com/watch?v=Z-FRe5AKmCU"

随后读取 /tmp/ 目录下的 .vtt 文件。

或直接输出字幕内容：

yt-dlp --skip-download --write-auto-sub --sub-lang en --print "%(subtitles)s" 
  "https://youtube.com/watch?v=VIDEO_ID" 2>&1 | grep -A1000 "WEBVTT"

常用工作流

1. 查找某档播客的最新一期

示例：Lex Fridman 播客

# 获取频道 ID（Lex Fridman：UCSHZKyawb77ixDdsGog4iWA）
mcporter call --stdio "node /tmp/youtube-mcp-server/dist/cli.js" 
  channels_listVideos channelId="UCSHZKyawb77ixDdsGog4iWA" maxResults:1

返回最新视频的标题、ID 和发布日期。

2. 为研究目的获取字幕

# 步骤 1：通过搜索或频道列表获取视频 ID
# 步骤 2：优先尝试 MCP 字幕接口
mcporter call --stdio "node /tmp/youtube-mcp-server/dist/cli.js" 
  transcripts_getTranscript videoId="VIDEO_ID"

# 步骤 3：若为空，则回退至 yt-dlp
yt-dlp --skip-download --write-auto-sub --sub-lang en 
  --output "/tmp/%(id)s.%(ext)s" 
  "https://youtube.com/watch?v=VIDEO_ID"

cat /tmp/VIDEO_ID.en.vtt

3. 按主题搜索视频

mcporter call --stdio "node /tmp/youtube-mcp-server/dist/cli.js" 
  search_videos query="Laravel AI productivity 2025" maxResults:10

对结果按相关频道或发布时间进一步筛选。

频道 ID 参考表

将常用频道 ID 记录于此以便快速调用：

• Lex Fridman 播客： UCSHZKyawb77ixDdsGog4iWA
• Indie Hackers： （按需补充）
• Laravel： （按需补充）

查找频道 ID 的方法：

1. 访问目标频道主页
2. 查看网页源代码（View Page Source）
3. 搜索 "channelId": 或 "externalId"

也可通过 YouTube 搜索并从返回结果中解析获取。

API 配额限制

YouTube Data API v3 设置了每日配额限制：

• 默认配额：10,000 单位/天
• 搜索请求：每次调用消耗 100 单位
• 视频详情：每次调用消耗 1 单位
• 字幕获取：不消耗配额（使用独立机制）

提示： 可放心高频调用字幕接口（无配额成本），但应谨慎使用搜索接口。

故障排查

MCP Server 无法运行

现象： 报错 Connection closed 或 YOUTUBE_API_KEY environment variable is required

解决方法： 从源码构建：

cd /tmp
git clone https://github.com/ZubeidHendricks/youtube-mcp-server
cd youtube-mcp-server
npm install
npm run build

# 测试运行
YOUTUBE_API_KEY="your_key" node dist/cli.js

字幕为空

现象： 字幕接口返回成功，但内容为空

原因： 视频未提供字幕，或 MCP 无法访问可用字幕

解决方法： 使用 yt-dlp 回退方案（见上文）

找不到 yt-dlp 命令

pip install --user yt-dlp
# 或
pipx install yt-dlp

安全说明

本 MCP Server 安全地使用 YouTube API 密钥：

• ✅ 密钥仅用于向官方 YouTube Data API 进行身份验证
• ✅ 不涉及任何第三方服务器
• ✅ 所有网络请求均发往 googleapis.com
• ✅ 代码已人工审核（无数据外泄风险）

但请注意：

• 🔒 将密钥存于 Clawdbot 配置中（勿硬编码在脚本或源码内）
• 🔒 在 Google Cloud Console 中将 API 密钥严格限制为仅允许 YouTube Data API v3
• 🔒 切勿将密钥提交至 Git 仓库

使用示例

为 LinkedIn 帖子构思调研播客内容

# 1. 查找 Lex Fridman 最新一期
mcporter call --stdio "node /tmp/youtube-mcp-server/dist/cli.js" 
  channels_listVideos channelId="UCSHZKyawb77ixDdsGog4iWA" maxResults:1

# 2. 获取该视频详情
mcporter call --stdio "node /tmp/youtube-mcp-server/dist/cli.js" 
  videos_details videoId="Z-FRe5AKmCU"

# 3. 获取字幕
mcporter call --stdio "node /tmp/youtube-mcp-server/dist/cli.js" 
  transcripts_getTranscript videoId="Z-FRe5AKmCU"

# 若字幕为空，改用 yt-dlp
yt-dlp --skip-download --write-auto-sub --sub-lang en 
  --output "/tmp/%(id)s.%(ext)s" 
  "https://youtube.com/watch?v=Z-FRe5AKmCU"

# 4. 分析字幕以提炼关键主题
# （读取 /tmp/Z-FRe5AKmCU.en.vtt 并提取核心观点）

查找关于热门话题的相关视频

# 搜索近期视频
mcporter call --stdio "node /tmp/youtube-mcp-server/dist/cli.js" 
  search_videos query="ClawdBot security concerns" maxResults:10

# 筛选相关视频并获取其字幕
# 分析情绪倾向与技术主张

注意事项

• MCP Server 路径：/tmp/youtube-mcp-server/dist/cli.js
• 始终通过环境变量传入 API 密钥：YOUTUBE_API_KEY="key" node ...
• 或在 Shell 环境或 Clawdbot 配置中全局设置
• 字幕可能为自动生成（引用时请核对准确性）
• yt-dlp 还支持下载音频（如需：--extract-audio --audio-format mp3）