YouTube 完整工具包

通过 TranscriptAPI.com 提供完整的 YouTube 工具包TranscriptAPI.com。所有功能集于一身。

设置

如果$TRANSCRIPT_API_KEY未设置，请帮助用户创建账户（100个免费额度，无需信用卡）：

步骤 1 — 注册：向用户询问其电子邮件。

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

→ OTP 已发送至邮箱。询问用户："请查收您的电子邮件，获取6位验证码。"

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

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=<您的密钥>

API参考

完整OpenAPI规范：transcriptapi.com/openapi.json— 请查阅此文件以获取最新参数和模式。

转录 — 1积分

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

响应(format=json):

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": [{ "text": "...", "start": 18.0, "duration": 3.5 }],
  "metadata": { "title": "...", "author_name": "...", "author_url": "..." }
}

搜索 — 1 积分

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

# 频道
curl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=channel&limit=10" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

频道

所有频道端点都接受频道— 一个@句柄、频道URL，或UC...频道ID。无需预先解析。

解析句柄 — 免费

curl -s "https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

响应：{"channel_id": "UC...", "resolved_from": "@TED"}

最新15个视频 — 免费

curl -s "https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

返回精确的观看次数以及ISO已发布时间戳。

所有频道视频 — 1积分/页

# 第一页 (100个视频)
curl -s "https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

# 后续页面
curl -s "https://transcriptapi.com/api/v2/youtube/channel/videos?continuation=TOKEN" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

请提供以下参数之一channel或continuation。响应包含continuation_token和has_more。

频道内搜索 — 1积分

curl -s "https://transcriptapi.com/api/v2/youtube/channel/search\
?channel=@TED&q=QUERY&limit=30" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

播放列表 — 1积分/页

接受playlist参数 — 一个YouTube播放列表URL或播放列表ID。

# 第一页
curl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_ID" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

# 后续页面
curl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?continuation=TOKEN" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

有效的ID前缀：PL、UU、LLFLOL。响应包括播放列表信息、结果、继续令牌、还有更多。积分成本端点

成本

验证规则

错误

典型工作流

研究工作流：搜索 → 选择视频 → 获取字幕

# 1. 搜索
curl -s "https://transcriptapi.com/api/v2/youtube/search\
?q=machine+learning+explained&limit=5" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"
# 2. 字幕
curl -s "https://transcriptapi.com/api/v2/youtube/transcript\
?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

频道监控：最新视频（免费）→ 字幕

# 1. 最新上传（免费 — 直接传入 @频道句柄）
curl -s "https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"
# 2. 最新视频的字幕
curl -s "https://transcriptapi.com/api/v2/youtube/transcript\
?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

免费套餐：100 额度，300 次请求/分钟。入门套餐（5美元/月）：1,000 额度。