核心用法
YouTube Full 是基于 TranscriptAPI.com 的综合性 YouTube 数据访问工具，涵盖五大核心功能：
1. 字幕提取（Transcript）
- 支持 YouTube 视频 URL 或 11 位视频 ID
- 输出格式可选 JSON（带时间戳）或纯文本
- 可同步返回视频元数据（标题、作者等）
- 单次调用消耗 1 积分
2. 搜索（Search）
- 视频搜索：支持关键词检索，返回前 20-50 条结果
- 频道搜索：定向查找特定频道
- 单次调用消耗 1 积分
3. 频道管理（Channels）
- Handle 解析（免费）：将
@handle转换为标准频道 ID - 最新视频（免费）：获取频道最近 15 个上传视频，含精确播放量和发布时间
- 全部视频（1 积分/页）：分页获取频道所有视频，每页 100 条
- 频道内搜索（1 积分）：在指定频道内关键词检索
4. 播放列表（Playlists）
- 支持标准播放列表（PL）、用户上传（UU）、 liked 视频（LL）等多种类型
- 分页获取，每页消耗 1 积分
5. 认证与配置
- 通过 CLI 脚本或官网注册获取 API Key
- 密钥自动保存至
~/.openclaw/openclaw.json，原文件自动备份 - 免费 tier：100 积分 + 300 请求/分钟
显著优点
- 功能全面：单一工具覆盖字幕、搜索、频道、播放列表四大场景，无需切换多个 API
- 成本友好：频道最新视频和 Handle 解析完全免费，适合监控类工作流
- 灵活输入：支持多种 ID 格式（URL、@handle、标准 ID），减少预处理步骤
- 结构化输出：JSON 格式包含完整元数据，便于程序化加工
- 渐进式付费：免费额度充足，Starter 计划 $5/月即可获得 1000 积分
潜在缺点与局限性
- 依赖第三方服务：TranscriptAPI 为商业 API，非官方 YouTube Data API，存在服务稳定性风险
- 字幕可用性限制：404 错误可能因视频无字幕或区域限制
- 积分消耗不透明：部分操作（如长频道翻页）可能快速消耗积分
- 无视频下载功能：仅限元数据和字幕，不支持音视频内容获取
- 速率限制：免费 tier 300 请求/分钟，大规模数据抓取可能受限
适合人群
- 内容研究者：需要批量获取视频字幕进行文本分析或摘要生成
- 社媒运营：监控特定频道更新，追踪竞品内容策略
- 开发者：构建 YouTube 数据分析工具，需要结构化 API 响应
- 学术用户：利用字幕数据进行语言学、传播学研究
常规风险
| 风险类型 | 说明 |
|---------|------|
| API 密钥泄露 | 密钥存储于本地 JSON 文件，多用户环境需注意权限管理 |
| 服务中断 | 第三方服务可能出现 408/429 错误，需实现重试逻辑 |
| 额度耗尽 | 402 错误时需及时充值，避免工作流中断 |
| 数据合规 | 抓取字幕需遵守 YouTube 服务条款及当地版权法规 |
认证建议
- 生产环境建议配置环境变量
TRANSCRIPT_API_KEY而非依赖本地文件 - 对关键任务实现指数退避重试，处理 408/429 状态码
- 定期监控积分余额，设置告警阈值