Skillppx logo

captions

通过TranscriptAPI从YouTube视频提取带时间戳的字幕文本。

已扫描
适合谁
内容创作者、语言学习者
不适合谁
无网络环境用户、无需字幕提取的普通浏览者
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @therohitdas/captions
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

字幕

通过 [TranscriptAPI.com](https://transcriptapi.com) 从 YouTube 视频中提取封闭字幕。

设置

如果未设置 $TRANSCRIPT_API_KEY，请阅读 [references/auth-setup.md](references/auth-setup.md)，并按照其中说明获取并存储 API 密钥。

必需请求头

每个请求都需要两个请求头：

  • Authorization: Bearer $TRANSCRIPT_API_KEY
  • User-Agent: 代理名称和版本（如 HermesAgent/0.11.0、ClaudeCode/1.0）。版本可选，仅提供代理名称也可。不得省略此头，也不得发送默认值 —— Cloudflare 将返回 403 错误（错误码 1010）并阻止请求。

GET /api/v2/youtube/transcript

curl -s "https://transcriptapi.com/api/v2/youtube/transcript\
?video_url=VIDEO_URL&format=json&include_timestamp=true&send_metadata=true" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"
参数是否必需默认值可选值
video_url是—YouTube 链接或视频 ID
format否jsonjson（结构化），text（纯文本）
include_timestamp否truetrue，false
send_metadata否falsetrue，false

响应（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": "...", "author_name": "...", "thumbnail_url": "..." }
}
  • start：从视频开始起的秒数
  • duration：字幕显示时长

响应（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..."
}

使用建议

  • 使用 format=json 获取带时间戳的字幕（适用于辅助工具、时间分析）。
  • 使用 format=text 并设置 include_timestamp=false 以获得更清晰的纯文本阅读体验。
  • 大多数视频都提供自动生成字幕；手动添加的字幕质量更高。

错误信息

错误码含义解决方法
401无效 API 密钥检查密钥是否正确
402余额不足访问 transcriptapi.com/billing
403/1010Cloudflare 拦截添加或修正 User-Agent 请求头
404无字幕视频未开启字幕功能
408超时等待 2 秒后重试一次

每次请求消耗 1 个积分。免费套餐：100 个积分，每分钟最多 300 次请求。

T
@therohitdas

已收录 1 个 Skill

相关推荐