YouTube字幕提取

技能简介

该技能通过TranscriptAPI.com服务，从YouTube视频中提取隐藏式字幕（CC）和多语言字幕，支持带时间戳的结构化输出或纯文本格式。

业务背景

帮助市场、培训及内容团队快速获取YouTube视频的文字内容，无需手动转录即可进行多语言素材整理、竞品分析脚本提取、内部培训课程字幕归档。支持结构化时间戳定位关键片段，大幅提升视频内容二次加工效率。

落地案例：某企业培训部门需将行业大咖的英文演讲视频转化为内部学习资料。通过该技能输入视频URL，选择中文或英文字幕版本，一键导出带时间戳的文本，直接导入课件制作工具；若仅需文字稿用于知识库沉淀，可切换纯文本格式，省去人工听写与校对环节。

能做什么

• 提取指定YouTube视频的完整字幕内容
• 获取带时间戳的字幕片段（精确到秒）
• 切换多种可用语言的字幕版本
• 输出JSON结构化数据或易读文本格式
• 获取视频元数据（标题、作者、缩略图等）

使用说明

安装与配置

首次使用需完成API密钥注册：

1. 执行注册命令并提供邮箱：node ./scripts/tapi-auth.js register --email 用户邮箱
2. 查收邮件获取6位验证码
3. 执行验证命令：node ./scripts/tapi-auth.js verify --token 上一步返回的令牌 --otp 验证码

密钥自动保存至~/.openclaw/openclaw.json，原文件会被备份为.bak。也可手动访问transcriptapi.com/signup注册。

调用方式

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

关键参数：video_url（必填，支持完整URL或视频ID）、format（json/text）、include_timestamp（true/false）。

输入与输出

见下方输入与输出表格。

风险提示

• API按次计费，免费额度100积分，超出需付费充值
• 部分视频未开启字幕功能时将返回404错误
• 网络超时（408）建议等待2秒后重试
• 自动生成的字幕质量低于人工校对版本
• API密钥存储于本地配置文件，注意文件权限安全

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/therohitdas/captions/SKILL.md
来源类型：开源技能仓库