🎬 YouTube 大师

获取全面的 YouTube 视频数据，包括元数据、统计信息、描述、缩略图以及可选的转录文本。

为什么选择这个技能？

YouTube 视频需要多个 API 才能获取完整数据。本技能智能地使用：

• - YouTube 数据 API（免费） → 视频元数据、统计信息、描述
• Apify API（可选） → 仅在请求转录文本时使用

优势

💰 成本效益

• - 默认模式：仅使用 YouTube API（免费配额）
• 转录文本：仅在明确请求时使用 1 次 Apify 请求
• 无浪费的 API 调用

⚡ 快速性能

• - YouTube API：约 200ms 响应
• Apify：仅在需要时加载

📊 完整数据

工作原理

┌─────────────────┐
│ 输入：URL/ID │
└────────┬────────┘
│
▼
┌─────────────────┐
│ YouTube API │ ◄── 免费，始终运行
│ (观看次数、 │
│ 描述、 │
│ 标题等) │
└────────┬────────┘
│
┌────┴────┐
│ │
▼ ▼
┌───────┐ ┌──────────────┐
│ -- │ │ --transcript │
│仅信息 │ │ 请求转录文本 │
└───┬───┘ └──────┬───────┘
│ │
│ ▼
│ ┌─────────────────┐
│ │ Apify API │ ◄── 仅在明确
│ │ (转录文本) │ 请求时运行
│ └────────┬────────┘
│ │
└─────┬───────┘
│
▼
┌─────────────────┐
│ 完整输出 │
└─────────────────┘

凭据设置

选项 1：环境变量

bash
export YOUTUBEAPIKEY=AIzaSy...
export APIFYTOKEN=apifyapi_...

选项 2：凭据文件（推荐）

添加到 ~/.openclaw/workspace/credentials/api-credentials.json：

json
{
google: {
api_key: AIzaSy...
},
apify: {
apikey: apifyapi_...
}
}

获取 YouTube API 密钥

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

获取 Apify 令牌

1. 1. 访问 Apify
2. 注册/登录
3. 从设置中复制 API 令牌

使用方法

默认模式（仅信息 - 免费）

bash
python3 gettranscript.py VIDEOID
python3 gettranscript.py https://www.youtube.com/watch?v=VIDEOID

包含转录文本（使用 Apify）

bash
python3 gettranscript.py VIDEOID --transcript
python3 gettranscript.py VIDEOID -t
python3 gettranscript.py VIDEOID --transcript --lang tr

仅信息

bash
python3 gettranscript.py VIDEOID --info-only

示例

基本视频信息

bash
python3 get_transcript.py dQw4w9WgXcQ

视频 + 转录文本

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

保存到文件

bash
python3 gettranscript.py VIDEOID > output.txt

API 配额

YouTube 数据 API（免费）

• - 每天 10,000 单位（默认）
• 视频列表：每次请求 1 单位
• 足够每天查询约 10,000 个视频

Apify

• - 提供免费套餐
• 仅在请求转录文本时计费

文件

• - get_transcript.py - 主脚本