🎬 YouTube Master

获取完整的 YouTube 视频数据，包括元数据、统计信息、描述、缩略图，以及可选的字幕（transcript）。

为何需要该技能？

要获取 YouTube 视频的完整数据，通常需调用多个 API。本技能智能地组合使用以下服务：

• YouTube Data API（免费） → 获取视频元数据、统计信息、描述等
• Apify API（可选） → 仅在明确请求字幕时调用

优势

💰 成本效益高

• 默认模式：仅调用 YouTube API（使用免费配额）
• 字幕模式：仅当显式请求字幕时，发起 1 次 Apify 请求
• 无冗余 API 调用

⚡ 性能优异

• YouTube API：响应时间约 200ms
• Apify：按需加载，不提前初始化

📊 数据全面

工作原理

┌─────────────────┐
│  输入：URL 或 ID   │
────────┘
         │
         ▼
┌─────────────────┐
│ YouTube API    │ ◄── 免费，始终执行
│ (viewCount,    │
│  description,   │
│  title 等)     │
└────────┬────────┘
         │
    ┌────┴────┐
    │         │
    ▼         ▼
┌───────┐ ┌──────────────┐
│ --    │ │ --transcript │
│info   │ │ 已被请求     │
│only   │ └──────┬───────┘
└───┬───┘        │
    │            ▼
    │    ┌─────────────────┐
    │    │ Apify API      │ ◄── 仅在显式要求时执行
    │    │ (transcript)   │
    │    └────────┬────────┘
    │             │
    └─────┬───────┘
          │
          ▼
┌─────────────────┐
│   完整输出结果   │
└─────────────────┘

凭证配置

方式一：环境变量

export YOUTUBE_API_KEY="AIzaSy..."
export APIFY_TOKEN="apify_api_..."

方式二：凭证文件（推荐）

将以下内容添加至 ~/.openclaw/workspace/credentials/api-credentials.json：

{
  "google": {
    "api_key": "AIzaSy..."
  },
  "apify": {
    "api_key": "apify_api_..."
  }
}

获取 YouTube API Key

1. 访问 Google Cloud Console
2. 新建一个项目
3. 启用 YouTube Data API v3
4. 创建凭据（API Key）
5. 免费配额：每日 10,000 单位

获取 Apify Token

1. 访问 Apify 官网
2. 注册或登录账号
3. 在 Settings 中复制 API token

使用方法

默认模式（仅获取基本信息 — 免费）

python3 get_transcript.py "VIDEO_ID"
python3 get_transcript.py "https://www.youtube.com/watch?v=VIDEO_ID"

启用字幕（调用 Apify）

python3 get_transcript.py "VIDEO_ID" --transcript
python3 get_transcript.py "VIDEO_ID" -t
python3 get_transcript.py "VIDEO_ID" --transcript --lang tr

仅获取基本信息

python3 get_transcript.py "VIDEO_ID" --info-only

示例

基础视频信息

python3 get_transcript.py dQw4w9WgXcQ

视频信息 + 字幕

python3 get_transcript.py Oi3Z1wlZXhg --transcript --lang tr

保存输出至文件

python3 get_transcript.py VIDEO_ID > output.txt

API 配额说明

YouTube Data API（免费）

• 每日 10,000 单位（默认配额）
• 单次 video.list 请求消耗 1 单位
• 足够支持约每日 10,000 次视频查询

Apify

• 提供免费层级（Free tier）
• 仅在请求字幕时计费

相关文件

• get_transcript.py — 主程序脚本