youtube-data

核心功能

youtube-data 是基于 TranscriptAPI.com 的 YouTube 数据获取服务，作为 Google YouTube Data API 的轻量级替代方案，彻底解决了官方 API 的配额限制、OAuth 配置复杂等问题。支持六大核心能力：视频字幕转录与元数据提取、YouTube 搜索（视频/频道）、频道信息解析（含最新视频、全部视频分页、频道内搜索）、播放列表视频提取。

显著优势

• 零配额门槛：100 免费积分起步，无信用卡绑定，按调用量计费（1 积分/次核心请求），部分端点（频道解析、最新 15 视频）完全免费
• 极简接入：仅需环境变量 TRANSCRIPT_API_KEY，无需 Google Cloud 项目配置、OAuth 流程或域名验证
• 数据完整性：返回带时间戳的完整字幕文本、精确观看数（非格式化字符串）、频道认证状态、RSS 订阅地址等结构化字段
• 灵活标识解析：自动处理 @handle、频道 URL、UC... ID 等多种输入格式，无需手动转换
• 高性价比分页：频道和播放列表视频分页获取，每页 100 条仅需 1 积分

局限与风险

• 第三方服务依赖：数据来源于非官方 TranscriptAPI.com，存在服务稳定性、长期可用性及数据一致性风险
• 隐私合规盲区：未明确说明 GDPR/CCPA 数据处理条款，用户需自行评估字幕提取的版权与隐私合规性
• 功能边界：不支持视频上传、评论获取、实时直播数据等写入或高级读取操作
• 速率限制：免费档 300 请求/分钟，重度使用需升级付费

适用人群

内容研究者、AI 训练数据工程师、播客/视频分析工具开发者、学术研究团队，以及需要批量获取 YouTube 结构化数据但不愿处理 Google API 复杂配置的技术用户。

常规风险提示

API 密钥需妥善保管，避免硬编码泄露；字幕数据可能受版权保护，商业使用需确认原始内容授权；服务停止或调价将导致业务中断，建议建立数据缓存或备选方案。

核心用法

YouTube Data 通过 TranscriptAPI.com 提供一站式 YouTube 结构化数据获取，无需 Google Cloud 项目、OAuth 流程或每日配额焦虑。支持四大核心场景：

| 功能 | 典型调用 | 成本 |

|:---|:---|:---|

| **视频转录+元数据** | `/youtube/transcript?video_url=URL` | 1 credit |

| **全站搜索** | `/youtube/search?q=QUERY&type=video` | 1 credit |

| **频道数据** | `/channel/latest?channel=@Handle`（免费15条）、`/channel/videos`（分页，1 credit/页） | 免费/1 credit |

| **播放列表** | `/playlist/videos?playlist=PL_ID` | 1 credit/页 |

安装后通过 CLI 向导完成邮箱 OTP 注册，API key 自动写入 ~/.openclaw/openclaw.json（原文件自动备份为 .bak）。

显著优点

• 零基础设施：无需信用卡开通 Google Cloud，100 credits 免费额度开箱即用
• 精准数据：转录带时间戳、频道数据含精确 viewCount 数字、搜索返回 verified 状态等丰富字段
• 开发者友好：纯 REST API，curl 可直接调用；响应 JSON 结构化，便于 pipeline 集成
• 成本透明：按 endpoint 明码标价，免费 tier 含 300 req/min 速率限制

潜在局限与风险

| 维度 | 说明 |

|:---|:---|

| **第三方依赖** | 核心功能绑定 TranscriptAPI.com，服务可用性、定价策略、数据持久性完全取决于该商业实体；若服务终止或 API 变更，Skill 功能即失效 |

| **数据隐私** | 查询内容（视频 URL、搜索关键词、频道 handle）需发送至第三方服务器，敏感主题研究需注意合规 |

| **配额经济学** | 免费 100 credits 约支持 100 次转录/搜索或 1 万条视频分页获取；重度使用需付费，长期成本可能超过自建 YouTube Data API（后者有免费配额） |

| **功能边界** | 不支持 YouTube 直播实时转录、评论区数据、私人/受限视频访问 |

适合人群

• 学术研究者：批量获取公开讲座、访谈转录文本进行 NLP 分析
• 内容运营：监测竞品频道更新、采集热门视频元数据
• 独立开发者：快速原型验证 YouTube 相关功能，跳过 Google API 审核周期
• 数据记者：调查报道中需要结构化视频证据链

常规风险

• 402 欠费：免费额度耗尽后接口返回 402，需前往 transcriptapi.com/billing 充值
• 408 超时：偶发网络延迟，建议实现一次重试
• 密钥泄露：API key 以明文存储于本地 JSON，共享设备需额外防护
• 服务连续性：建议关键业务场景保留 Google 官方 API 作为 fallback

---

> 认证结论：CLS-Certify 静态+动态扫描评分为 90/S 级，代码无危险函数、无第三方依赖、网络通信全 HTTPS，但需接受第三方商业服务依赖风险。