youtube-data

youtube-data 是一款专为 YouTube 数据提取设计的轻量级工具，通过 TranscriptAPI.com 服务提供视频转录文本、元数据、频道信息、搜索及播放列表数据的结构化获取能力。作为 Google YouTube Data API 的替代方案，它消除了复杂的 OAuth 配置和每日配额限制，特别适合需要高频或批量获取 YouTube 数据的场景。

核心用法方面，用户首先需要通过邮箱注册获取 API Key（提供 100 个免费积分），支持自动化的 Node.js 脚本验证或手动注册。获取密钥后，可通过简单的 HTTP 请求获取数据：视频端点返回带时间戳的完整转录文本和元数据（1 积分）；搜索端点支持视频和频道检索；频道端点提供 Handle 解析、最新 15 个视频获取（免费）以及全量视频列表（分页，每页 1 积分）；播放列表端点支持批量获取视频信息。所有接口返回标准 JSON 格式，便于集成到各类应用中。

显著优点包括：完全绕过 Google API 的配额限制，适合大规模数据采集；使用成本透明，按积分计费且提供免费额度；支持丰富的数据维度，包括精确到句的时间戳转录、频道统计信息、播放列表元数据等；接口设计简洁，无需处理复杂的 OAuth 流程，降低了开发门槛；频道 Handle 自动解析功能简化了用户操作，同时脚本在修改配置文件前会自动备份原文件，保障数据安全。

潜在缺点与局限性方面：依赖第三方服务 TranscriptAPI.com 的可用性，存在单点故障风险；需要付费购买积分（超出免费额度后）；作为个人维护的项目（T3 来源），长期维护稳定性存疑；数据获取受限于 YouTube 的 robots.txt 和反爬策略，某些私密或受限视频可能无法获取；转录文本质量依赖 YouTube 自动字幕的准确性，可能存在识别错误。

适合的目标群体主要包括：需要进行 YouTube 内容分析的研究人员和市场营销人员；构建视频推荐、内容聚合应用的开发者；需要批量获取视频元数据用于机器学习训练的数据工程师；以及希望自动化获取自己频道数据的内容创作者。对于教育领域的视频内容分析、媒体监测、竞品分析等场景尤为适用。

使用风险包括：由于需要向外部服务 transcriptapi.com 发送请求，存在网络依赖和数据隐私风险（尽管报告确认无静默收集）；API Key 本地存储在 ~/.openclaw/openclaw.json，如果文件权限设置不当可能导致密钥泄露；作为第三方非官方接口，存在因 YouTube 页面结构变更导致服务中断的风险；高频调用可能触发速率限制（300 req/min），需要合理设计重试逻辑；此外需注意 402 错误（积分耗尽）和 408 超时错误的处理。