YouTube视频转录

技能简介

Transcript技能通过TranscriptAPI.com服务，从任意YouTube视频提取完整字幕文本。支持标准视频、Shorts短视频及多种URL格式，输出可选JSON结构化数据或纯文本格式，适用于内容摘要、研究引用、翻译处理等场景。

业务背景

市场、内容运营及研究人员可快速获取YouTube视频的文字内容，无需手动记录或逐帧观看。支持将长视频转化为可检索的文本资产，便于制作摘要、多语言翻译准备及竞品内容分析，提升信息处理效率。

落地案例：某咨询公司需分析海外行业峰会演讲，输入YouTube链接即可提取完整字幕，选择JSON格式保留时间戳用于引用定位，或导出纯文本供团队批量审阅。系统自动识别视频语言并同步获取标题、作者等元数据，方便归档管理。

能做什么

• 提取YouTube视频完整字幕内容
• 生成带时间戳的逐句记录或连续文本
• 获取视频元数据（标题、作者、缩略图）
• 识别视频语言并返回对应字幕
• 支持长视频的内容分段处理

使用说明

安装与配置

本技能需要Node.js环境和API密钥。首次使用需完成以下步骤：

1. 注册账号（100免费额度，无需绑卡）：

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

2. 查收邮件获取6位验证码，完成验证：

node ./scripts/tapi-auth.js verify --token 上一步返回的TOKEN --otp 邮件中的6位验证码

API密钥自动保存至~/.openclaw/openclaw.json，原文件会被备份为.bak。如需手动配置，访问transcriptapi.com/signup获取密钥。

调用方式

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"

参数说明：video_url必填，支持完整URL、短链youtu.be、Shorts链接或裸视频ID；format可选json/text，默认json；include_timestamp控制是否保留时间戳；send_metadata返回视频元数据。

输入与输出

见下方输入与输出表格。

风险提示

• 仅可提取已启用CC字幕的视频，无字幕视频返回404错误
• 每次成功请求消耗1积分，免费额度100积分用完需充值
• API密钥存储于本地配置文件，注意文件权限保护
• 速率限制300请求/分钟，超限触发429错误需等待重试
• 网络超时(408)建议2秒后单次重试，避免频繁调用

来源信息

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