核心用法
Transcript 技能通过调用 TranscriptAPI.com 服务，实现对 YouTube 视频的字幕提取功能。用户只需提供视频 URL 或 11 位视频 ID，即可获取带时间戳或不带时间戳的完整转录文本，支持 JSON 和纯文本两种输出格式。
显著优点
- 多格式灵活输出：
format=text适合快速阅读，format=json便于精确引用特定时间点的内容 - 完整元数据：可选获取视频标题、作者、缩略图等元信息，便于学术研究引用
- 免费起步友好：注册即赠 100 积分（1 积分/次成功请求），无需绑定信用卡
- 高并发支持：免费 tier 支持 300 请求/分钟，满足大多数个人研究需求
- 错误不扣费：仅成功请求消耗积分，降低试错成本
潜在局限
- 依赖第三方字幕：无法提取无人工/自动字幕的视频内容（404 错误）
- 仅支持 YouTube：不支持其他平台如 Bilibili、Vimeo 等
- 积分消耗模式：高频使用者需付费充值（transcriptapi.com/billing）
- 网络稳定性：存在 408 超时、429 限流等风险，长视频提取可能中断
适合人群
- 内容创作者：快速提取视频脚本进行二次创作
- 学术研究者：引用视频言论、制作文献综述
- 语言学习者：获取带时间戳的听力材料
- 媒体记者：核实视频发言内容、制作报道引用
常规风险
- API 密钥管理：密钥存储于本地 shell 配置文件，共享环境存在泄露风险
- 隐私合规：提取视频内容需遵守原视频版权及平台 ToS，商用需谨慎
- 服务连续性：依赖单一第三方 API，存在服务变更或下线风险
典型工作流
1. 用户分享视频链接或提出转录需求
2. 检查 TRANSCRIPT_API_KEY 环境变量，未设置时引导完成注册验证
3. 调用 API 获取 format=text&include_timestamp=true 默认输出
4. 长视频先提供摘要，按需展开完整转录
5. 遇到 404 时提示"该视频可能未开启字幕"，遇到 402 时引导充值