youtube-apify-transcript

通过 APIFY API 获取 YouTube 视频字幕（使用云端 IP 地址，可绕过 YouTube 的机器人检测）。

为什么选择 APIFY？

YouTube 会屏蔽来自云端 IP（如 AWS、GCP 等）的字幕请求。APIFY 通过住宅代理发送请求，能可靠地绕过机器人检测。

免费额度

• 每月 $5 免费额度（约可处理 714 个视频）
• 无需信用卡
• 非常适合个人使用

费用

• 每个视频 $0.007（不到 1 美分！）
• 使用情况追踪：https://console.apify.com/billing

相关链接

• 🔗 APIFY 定价
• 🔑 获取 API 密钥
• 🎬 YouTube 字幕提取 Actor

设置步骤

1. 创建免费的 APIFY 账户：https://apify.com/
2. 获取你的 API 令牌：https://console.apify.com/account/integrations
3. 设置环境变量：

# 添加到 ~/.bashrc 或 ~/.zshrc
export APIFY_API_TOKEN="apify_api_YOUR_TOKEN_HERE"

# 或者使用 .env 文件（切勿提交此文件！）
echo 'APIFY_API_TOKEN=apify_api_YOUR_TOKEN_HERE' >> .env

使用方法

基本用法

# 获取纯文本字幕
python3 scripts/fetch_transcript.py "https://www.youtube.com/watch?v=VIDEO_ID"

# 短链接同样适用
python3 scripts/fetch_transcript.py "https://youtu.be/VIDEO_ID"

选项参数

# 输出到文件
python3 scripts/fetch_transcript.py "URL" --output transcript.txt

# JSON 格式（包含时间戳）
python3 scripts/fetch_transcript.py "URL" --json

# 组合使用：将 JSON 输出到文件
python3 scripts/fetch_transcript.py "URL" --json --output transcript.json

# 指定语言偏好
python3 scripts/fetch_transcript.py "URL" --lang de

输出格式

文本格式（默认）：

大家好，欢迎观看本视频。
今天我们将讨论...

JSON 格式（--json）：

{
  "video_id": "dQw4w9WgXcQ",
  "title": "视频标题",
  "transcript": [
    {"start": 0.0, "duration": 2.5, "text": "大家好，欢迎"},
    {"start": 2.5, "duration": 3.0, "text": "观看本视频"}
  ],
  "full_text": "大家好，欢迎观看本视频..."
}

错误处理

脚本会处理常见错误：
- 无效的 YouTube 链接
- 视频无字幕
- API 额度已用尽
- 网络错误

元数据

**元数据：**
  clawdbot:
    emoji: "📹"
    requires:
      env: ["APIFY_API_TOKEN"]
      bins: ["python3"]