youtube-api

核心用法

YouTube API Skill 通过 TranscriptAPI.com 提供 YouTube 数据访问能力，完全绕过 Google 官方的 API 配额限制。用户只需获取一个 API key（免费 100 积分起步），即可执行以下操作：

• 视频转录：获取带时间戳或无时间戳的完整字幕文本
• 全局搜索：按关键词搜索 YouTube 视频（1 积分/次）
• 频道浏览：解析频道句柄、获取最新视频、浏览上传历史（部分端点免费）
• 播放列表：提取播放列表中的所有视频

典型工作流：粘贴 YouTube 链接 → 自动触发转录获取 → 生成视频摘要或回答内容相关问题。也支持通过 @handle 或创作者名称主动查询频道信息。

显著优点

1. 零配额焦虑：Google YouTube Data API 的每日 10,000 单位配额（约 100 次搜索）常成为瓶颈，而 TranscriptAPI 采用积分制，无硬性日限
2. 转录原生支持：Google 官方 API 不提供字幕数据，此 Skill 将其作为核心功能
3. 极简配置：单环境变量 TRANSCRIPT_API_KEY，无需 OAuth、项目创建或复杂的云端控制台操作
4. 成本透明：免费 100 积分试用，$5/月获得 1,000 积分，定价低于 Google 超额费用（$0.0015/单位）
5. 部分免费端点：频道句柄解析和最新视频获取不消耗积分

潜在缺点与局限性

• 第三方依赖风险：完全依赖 transcriptapi.com 的商业服务，非 YouTube 官方，服务中断或政策变更将直接影响可用性
• 隐私暴露：所有查询内容（包括搜索词、视频 ID）都会发送至第三方服务器，敏感内容需谨慎
• T3 级来源：维护者为个人开发者 therohitdas，项目维护稳定性、安全更新响应速度存疑
• 功能边界：不支持视频上传、评论管理、账户操作等写入功能，纯只读数据获取
• 速率限制：免费版 300 请求/分钟，高频场景需升级

适合人群

• 内容创作者/研究员：需要批量分析 YouTube 视频转录文本
• 市场分析师：监控竞品频道更新、提取热门视频数据
• 教育工作者：快速获取教学视频的文字版本
• 开发原型验证：避免 Google API 繁琐配置，快速测试 YouTube 数据集成
• 对 Google Cloud 配额和结算感到困扰的个人用户

常规风险

1. 密钥泄露：TRANSCRIPT_API_KEY 需妥善保管，硬编码或误提交将导致积分被盗用
2. 数据驻留：转录内容和搜索历史存储于第三方，可能不符合某些企业的数据本地化要求
3. 服务可持续性：个人开发者项目存在维护中断风险，关键业务不建议完全依赖
4. Cloudflare 拦截：未设置 User-Agent 头会导致 403/1010 错误，需确保请求头配置正确
5. 误触发成本：Skill 设计为自动触发（粘贴链接即调用），可能在无意中消耗积分

核心用法

YouTube API Skill 是 TranscriptAPI.com 的封装接口，提供零 OAuth 配置的 YouTube 数据访问。用户仅需配置 TRANSCRIPT_API_KEY 环境变量即可调用六大类接口：视频转录（/transcript）、全局搜索（/search）、频道解析（/channel/resolve）、频道最新视频（/channel/latest）、频道视频列表（/channel/videos）及播放列表浏览（/playlist/videos）。所有请求需携带 Authorization: Bearer $TRANSCRIPT_API_KEY 和自定义 User-Agent 头，否则将触发 Cloudflare 403 拦截。

显著优点

配额解放：完全绕过 Google YouTube Data API 的 10,000 单位/日限制，采用积分制计费（1 积分/请求），无硬性日上限。转录原生支持：Google 官方 API 不提供的字幕/转录文本为本 Skill 核心功能，支持纯文本或带时间戳格式。极速上手：单 API key 替代 OAuth 2.0 + 项目配置流程，5 分钟内完成从注册到调用。成本透明：免费 tier 含 100 积分，Starter 方案 $5/月得 1,000 积分，无隐藏超量计费。

潜在局限

第三方依赖风险：数据流经 TranscriptAPI.com 中转，非 Google 直连，服务可用性、数据留存政策受该服务商制约。功能边界：不支持视频上传、账户管理、评论发布等写入操作；仅限公开内容获取。T3 来源可信度：通过 OpenClaw/Hermes 平台分发，无公开 GitHub 仓库溯源，长期维护透明度弱于 T1/T2 来源。合规灰区：部分 YouTube 创作者对转录抓取存在争议，商业用途需自行评估 ToS 兼容性。

适合人群

• 需要批量获取 YouTube 转录文本的内容创作者、研究员、AI 训练数据准备者
• 频繁触发 Google API 配额上限的开发者
• 追求快速原型验证、拒绝 OAuth 复杂配置的独立开发者
• 需频道内容监控但无官方 API 权限的分析师

常规风险

凭证泄露：API key 以明文环境变量形式存储，共享环境或版本控制误提交可导致积分盗刷。成本失控：分页接口（频道视频、播放列表）按页计费，深度遍历高产量频道可能快速耗尽积分。服务中断：TranscriptAPI.com 为商业实体，存在定价变更、服务下线或被 YouTube 反制封锁的可能。数据隐私：搜索查询、视频 URL 等元数据可能被服务商日志记录，敏感主题研究需额外评估。