transcript

核心用法

Transcript 技能通过 TranscriptAPI.com 提供 YouTube 视频转录服务。用户只需提供视频链接或 11 位视频 ID，即可获取完整字幕内容。API 默认返回带时间戳的纯文本格式，同时支持 JSON 结构化数据以满足精确引用需求。调用时需设置 TRANSCRIPT_API_KEY 环境变量，并在请求头中携带 Authorization 和 User-Agent。

显著优点

• 低门槛接入：免费账户提供 100 积分，无需绑定信用卡即可试用
• 格式灵活：支持 text/json 输出，可开关时间戳与元数据，适应翻译、摘要、引证等多种场景
• 全面兼容：处理标准视频、短链接、Shorts 及裸视频 ID
• 成本透明：仅成功请求消耗 1 积分，错误调用不扣费

潜在局限

• 依赖外部服务：API 可用性受 TranscriptAPI.com 运维状态影响
• 无字幕视频无法处理：404 错误表明目标视频未启用字幕
• 积分制限制：高频使用需付费充值，免费额度有限
• 网络要求：必须保持互联网连接，不适用于离线环境

适合人群

研究人员、内容创作者、翻译工作者、需要基于视频素材进行事实核查或深度分析的用户。

常规风险

API 密钥需妥善保管，避免硬编码泄露；Cloudflare 403 错误提示需正确配置 User-Agent，否则请求会被拦截。

核心用法

transcript 是一款纯文档型工具，通过调用 TranscriptAPI.com 服务获取 YouTube 视频字幕。用户需提供环境变量 TRANSCRIPT_API_KEY（免费注册，含100积分），即可通过标准 HTTP GET 请求提取视频转录文本。

关键参数配置：

• video_url: 支持完整URL、短链接、Shorts链接或裸视频ID
• format=text&include_timestamp=true&send_metadata=true（推荐默认）
• 备选 format=json 用于需要精确时间戳的场景

显著优点

1. 零代码集成：纯 Markdown 文档型 Skill，无可执行代码，无依赖风险
2. 灵活输出：支持带时间戳的文本格式（便于引用）或纯净文本（适合翻译/分析）
3. 元数据丰富：同步返回视频标题、作者、缩略图等信息
4. 成本友好：免费 tier 100 credits，错误请求不扣费，300 req/min 速率充足
5. 广泛兼容：支持标准视频、Shorts、播放列表链接等多种 YouTube URL 格式

潜在局限

• 字幕可用性依赖视频本身：404 错误常见于无字幕/未启用 CC 的视频
• 外部服务依赖：完全依赖 TranscriptAPI 的可用性和计费政策
• T3 来源：个人开发者维护，长期更新稳定性需持续观察
• 无离线能力：必须联网，无法处理本地视频文件
• 语言限制：仅能提取 YouTube 已生成的字幕语言

适合人群

• 研究人员、学生：快速提取讲座、访谈内容
• 内容创作者：获取素材引用、制作字幕备份
• 翻译工作者：获取可编辑的源文本
• 事实核查者：精准定位视频中的具体陈述时间点

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 隐私泄露 | 低 | 仅传输视频URL，无用户身份数据收集 |

| API 密钥安全 | 中 | 需妥善保管 `TRANSCRIPT_API_KEY`，避免硬编码泄露 |

| 服务中断 | 中 | 依赖第三方 API，建议实现重试逻辑（408/429错误处理） |

| 法律合规 | 低 | 遵守 YouTube ToS，仅用于个人学习/研究用途 |

认证状态：通过 CLS-Certify S 级认证（100/100分），六维检测全部通过。