名称： transcript
描述： 从任意 YouTube 视频获取字幕文本，适用于摘要、研究、翻译、引用或内容分析。当用户分享视频链接或询问“他们说了什么”、“获取字幕”、“转录此视频”、“总结此视频”，或想要分析口语内容时使用。
主页： https://transcriptapi.com
user-invocable: true
元数据： {"openclaw":{"emoji":"📝","requires":{"env":["TRANSCRIPT_API_KEY"],"bins":["node"],"config":["~/.openclaw/openclaw.json"]},"primaryEnv":"TRANSCRIPT_API_KEY"}}

字幕获取工具

通过 TranscriptAPI.com 获取视频字幕。

设置

如果未设置 $TRANSCRIPT_API_KEY，请协助用户创建账户（提供 100 个免费额度，无需绑定支付卡）：

步骤 1 — 注册： 向用户询问其邮箱地址。

node ./scripts/tapi-auth.js register --email 用户邮箱

→ 验证码将发送至邮箱。询问用户：“请检查您的邮箱，获取 6 位验证码。”

步骤 2 — 验证： 用户提供验证码后：

node ./scripts/tapi-auth.js verify --token 步骤1返回的令牌 --otp 验证码

API 密钥将保存至 ~/.openclaw/openclaw.json。详情见下文 文件写入 部分。修改前会备份现有文件。

手动操作选项：transcriptapi.com/signup → 控制面板 → API 密钥。

文件写入

验证和保存密钥命令会将 API 密钥保存至 ~/.openclaw/openclaw.json（设置 skills.entries.transcriptapi.apiKey 和 enabled: true）。修改前，现有文件会备份至 ~/.openclaw/openclaw.json.bak。

若要在代理之外的终端/CLI 中使用此 API 密钥，请手动添加到 Shell 配置文件中：
export TRANSCRIPT_API_KEY=<你的密钥>

GET /api/v2/youtube/transcript

curl -s "https://transcriptapi.com/api/v2/youtube/transcript\
?video_url=视频URL&format=text&include_timestamp=true&send_metadata=true" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

支持格式：完整 URL (youtube.com/watch?v=ID)、短链接 (youtu.be/ID)、短视频 (youtube.com/shorts/ID) 或纯视频 ID。

默认设置： 除非用户特别指定，否则始终使用 format=text&include_timestamp=true&send_metadata=true。

响应 (format=json)：

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": [
    { "text": "We're no strangers to love", "start": 18.0, "duration": 3.5 },
    { "text": "You know the rules and so do I", "start": 21.5, "duration": 2.8 }
  ],
  "metadata": {
    "title": "Rick Astley - Never Gonna Give You Up",
    "author_name": "Rick Astley",
    "author_url": "https://www.youtube.com/@RickAstley",
    "thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"
  }
}

响应 (format=text)：

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": "[00:00:18] We're no strangers to love\n[00:00:21] You know the rules...",
  "metadata": {...}
}

错误代码

使用建议

• 对于长视频，可先总结关键点，根据用户请求再提供完整字幕。
• 需要精确时间戳以引用特定片段时，使用 format=json。
• 进行翻译或文本分析时，可使用 include_timestamp=false 获取纯净文本。
• 每次成功请求消耗 1 个额度，错误请求不消耗。
• 免费套餐：100 个额度，每分钟 300 次请求。