YouTube 频道监控器（AssemblyAI）

监控 YouTube 频道，并使用 AssemblyAI 云 API 自动转录新发布的视频。除 requests 外，无需任何本地依赖。

前提条件

1. AssemblyAI 账户：https://www.assemblyai.com/app/signup（免费，每月 100 小时）
2. API Key：从控制台获取
3. requests 库（通常随 OpenClaw/Python 预装）

配置 API Key

任选其一：

# 方式 A：设置环境变量
export ASSEMBLYAI_API_KEY="your-key"

# 方式 B：使用配置文件
echo '{"api_key": "your-key"}' > data/config.json

工作原理

频道主页 → innertube API → 音频直链 → AssemblyAI 云服务 → 文本 + 摘要

不下载本地音频，不使用 Whisper，不依赖 ffmpeg。AssemblyAI 在服务端完成全部处理。

命令

# 转录单个视频
python3 scripts/monitor.py now "https://www.youtube.com/watch?v=VIDEO_ID"

# 添加待监控频道
python3 scripts/monitor.py add "https://www.youtube.com/@ChannelName/videos" "Alias"

# 检查所有已添加频道是否有新视频并执行转录
python3 scripts/monitor.py check [count_per_channel]

# 列出所有已监控频道
python3 scripts/monitor.py list

# 移除指定频道
python3 scripts/monitor.py remove "Alias"

重要说明

• 音频 URL 提取使用 YouTube 的 innertube API（纯 requests 实现）。
• 支持普通家庭宽带 IP 地址。数据中心 IP 可能被 YouTube 封禁。
• 若音频 URL 提取失败并返回 UNPLAYABLE，表明当前 IP 可能已被 YouTube 标记——这是 YouTube 的限制，而非程序缺陷。
• 免费套餐：每月 100 小时转录额度。
• 转录耗时约为视频时长的 70–80%。
• 结果保存至 data/summaries/{video_id}.json。

输出格式

每个结果包含以下字段：

• text：完整转录文本
• summary：AI 生成的段落式摘要
• confidence：转录置信度分数
• utterances：带时间戳与说话人标签的分段内容

文件说明