YouTube播放列表浏览

技能简介

该技能通过 TranscriptAPI.com 服务，支持浏览 YouTube播放列表内容并获取视频字幕文本。适用于用户分享播放列表链接、询问播放列表内容、或需要批量处理视频字幕的场景。

能做什么

• 解析 YouTube 播放列表 URL，提取播放列表 ID
• 分页获取播放列表中的视频列表（每页100条）
• 获取指定视频的字幕文本（含时间戳）
• 支持多种播放列表类型：用户创建、频道上传、喜欢视频、收藏夹等

使用说明

安装与配置

1. 确保已安装 Node.js 环境
2. 设置环境变量 TRANSCRIPT_API_KEY，或运行认证脚本生成 API 密钥

注册与验证（若无 API 密钥）

第1步 — 注册：向用户索取邮箱地址

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 → Dashboard → API Keys。

典型调用流程

1. 获取播放列表视频（首页）：

curl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_PLAYLIST_ID" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY"

2. 翻页获取后续视频：

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

3. 获取单个视频字幕：

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

输入与输出

见下方输入与输出表格。

风险提示

• API 调用消耗积分（1积分/页），免费账户含100积分
• 仅支持公开播放列表，私有或受限内容返回404错误
• 字幕可用性取决于视频本身是否提供
• 配置文件修改前自动备份，但建议定期手动备份
• 网络超时可能导致408错误，需重试

来源信息

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