YouTube字幕获取

技能简介

TranscriptAPI 是一套完整的 YouTube 数据处理工具，通过单一 API 密钥即可获取视频字幕、搜索视频与频道、浏览频道上传内容、获取最新视频以及探索播放列表。

能做什么

• 提取任意 YouTube 视频的完整字幕（含时间戳）
• 按关键词搜索视频或频道
• 解析频道信息（支持 @用户名、频道链接或 ID）
• 浏览频道上传历史和最新视频
• 获取播放列表内容

使用说明

安装要求：需要 Node.js 环境，并配置 TRANSCRIPT_API_KEY。

步骤 1 — 注册账号：若未设置 API 密钥，先创建账户（100 免费额度，无需绑卡）。向用户询问邮箱后执行：

node ./scripts/tapi-auth.js register --email USER_EMAIL

系统将向邮箱发送 6 位验证码，提示用户查收邮件。

步骤 2 — 验证激活：获取用户提供的验证码后执行：

node ./scripts/tapi-auth.js verify --token TOKEN_FROM_STEP_1 --otp CODE

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

CLI 环境变量配置（可选）：如需在终端直接使用，手动添加至 shell 配置文件：export TRANSCRIPT_API_KEY=<your-key>

获取视频字幕示例：

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

支持参数：video_url（必填）、format（json/text）、include_timestamp、send_metadata。

搜索视频示例：

curl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20" -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

完整接口文档见 OpenAPI 规范。

输入与输出

见下方输入与输出表格。

风险提示

• API 调用消耗积分，字幕和搜索各 1 积分/次，注意用量控制
• 配置文件修改前会自动备份，但建议定期手动备份重要数据
• 免费额度用尽后需付费充值，请提前规划使用场景
• YouTube 内容受版权保护，获取的字幕仅用于合规分析用途

来源信息

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