youtube-api

核心用法

TranscriptAPI.com 提供第三方 YouTube 数据接口，无需 Google Cloud 项目或 OAuth 配置。核心功能包括：视频字幕提取（含时间戳）、频道视频列表、播放列表内容、搜索接口。通过 TRANSCRIPT_API_KEY 认证，按调用次数计费（1 credit/次，部分端点免费）。

显著优点

1. 零配额焦虑：无 Google API 每日 10,000 units 限制，适合高频抓取场景
2. 独家字幕能力：Google 官方 API 不提供字幕数据，此为差异化功能
3. 极简接入：单一 API Key 认证，无需项目配置、OAuth 流程
4. 成本控制透明：$5/1000 credits，起步门槛低（100 credits 免费）
5. 免费端点覆盖：频道解析、最新视频列表可零成本调用

潜在缺点与局限

• 第三方依赖：服务稳定性、数据准确性完全依赖 TranscriptAPI.com，非 Google 官方渠道
• 合规灰色地带：通过非官方方式抓取 YouTube 数据，存在违反 YouTube ToS 风险
• 功能边界：不支持视频上传、评论管理、用户授权等写入操作，纯只读方案
• 速率限制：300 req/min 免费档，超量需付费，大规模抓取仍需成本规划

适合人群

• 需批量获取 YouTube 字幕的 NLP/AI 开发者
• 受 Google API 配额困扰的数据分析团队
• 快速原型验证阶段，不愿投入 OAuth 配置成本的个人开发者
• 频道监控、竞品分析类的只读数据需求

常规风险

• 账号封禁风险：YouTube 可能对异常流量来源采取反制措施（IP/账号维度）
• 服务持续性：第三方服务存在关停或涨价可能，关键业务需有迁移预案
• 数据延迟：非实时官方管道，视频上线到数据可用存在时间差
• 隐私合规：抓取用户生成内容需遵守 GDPR/CCPA 等数据保护法规

核心用法

youtube-api skill 通过 TranscriptAPI.com 提供 YouTube 数据访问能力，用户无需申请 Google Cloud 项目或担心 API 配额耗尽。支持功能包括：视频转录提取（含时间戳）、频道信息解析、视频搜索、播放列表浏览及最新视频获取。所有请求通过 Authorization: Bearer $TRANSCRIPT_API_KEY 头部认证，API 密钥通过邮箱 OTP 验证后自动注入 shell 配置文件。

典型调用流程：注册获取 100 免费积分 → 设置环境变量 → 使用 curl 或直接调用端点。转录获取成本为 1 积分/请求，频道解析和最新视频为免费端点。

显著优点

1. 零配额焦虑：替代 Google YouTube Data API 的 10,000 单位/日限制，采用积分制无日上限
2. 核心功能补位：官方 API 不提供的转录功能，此处为原生支持
3. 极简接入：单 API 密钥即可，无需 OAuth 2.0 复杂流程
4. 成本可控：$5/1000 积分，免费 tier 含 100 积分足够测试
5. 技术实现干净：仅依赖 Node.js 内置模块，无第三方 npm 包，供应链攻击面极小

潜在缺点与局限性

• 第三方依赖风险：所有数据流经 TranscriptAPI.com，隐私和可用性完全绑定该服务商
• shell 配置入侵：认证脚本会修改 ~/.zshenv、~/.bashrc 等文件注入密钥，存在配置污染和明文存储风险
• 无官方背书：非 Google 官方方案，服务持续性、数据准确性无 SLA 保障
• 速率限制：免费 tier 300 req/min，高频场景需付费升级
• 遗留密码登录：代码中仍存在 --password 参数的 legacy 登录路径，虽默认 OTP 但仍存在误触发风险

适合人群

• 快速原型开发者：需要 YouTube 转录数据做 NLP/AI 训练
• 配额敏感项目：Google API 10,000 单位无法满足搜索量需求
• 无 Google Cloud 账号用户：个人开发者或学生绕过复杂云项目 setup

常规风险

• 数据外泄：搜索查询、频道浏览记录发送至第三方服务器，敏感场景需谨慎
• 密钥本地暴露：API key 以明文形式存储在 shell profile，多用户系统存在泄露风险
• 服务中断：第三方服务被封禁或倒闭将导致功能完全失效
• 合规隐患：GDPR 等场景下第三方数据处理需额外审查 TranscriptAPI 隐私政策