核心用法
youtube-playlist 技能专用于批量处理 YouTube 播放列表，支持两类核心操作：
1. 播放列表浏览：通过 /api/v2/youtube/playlist/videos 端点分页获取播放列表内视频元数据（每页 100 条），返回视频 ID、标题、频道信息、时长、缩略图及播放列表整体信息（标题、视频总数、描述、所有者）。
2. 字幕转录获取：配合 youtube-transcript 端点，可从播放列表中的任意视频提取带时间戳或纯文本格式的字幕。
认证流程：需注册 TranscriptAPI.com 账号，通过邮箱验证获取 sk_ 开头的 API 密钥，支持 CLI 脚本自动化配置或手动仪表板获取。新用户赠送 100 免费积分（1 积分/页）。
显著优点
- 批量处理能力：一次性解析整个播放列表结构，无需逐一手动输入视频链接
- 完整元数据：返回频道 handle、精确时长、观看数等结构化信息，便于内容分析
- 灵活分页：支持 continuation token 机制，可稳定遍历数百甚至上千视频的播放列表
- 多格式输出：字幕支持纯文本、带时间戳、含元数据等多种格式
- 低门槛试用：100 免费积分 + 无需信用卡注册，降低初次使用成本
潜在缺点与局限性
- 积分消耗：播放列表浏览 1 积分/页，大列表（如 500+ 视频）需 5+ 积分仅获取目录
- 转录另计费用：获取视频字幕需额外调用 transcript 端点，未包含在 playlist 查询中
- 公开内容限制：仅支持公开播放列表，私享/未列出内容返回 404
- 速率限制：免费档 300 请求/分钟，大规模批处理需控制并发
- 依赖第三方服务：TranscriptAPI.com 的可用性与定价策略直接影响技能稳定性
适合人群
- 内容创作者与研究人员：需要批量分析教育播客、会议录像、系列教程的字幕内容
- 数据分析师：提取播放列表元数据进行频道内容结构研究
- 学习用户：希望快速浏览课程播放列表并导出重点视频的文字记录
常规风险
- API 密钥泄露：
sk_密钥需妥善保管，硬编码在脚本中存在泄露风险 - 积分耗尽导致中断：未监控余额时大批量任务可能中途失败
- 隐私合规：转录内容可能包含个人敏感信息，存储与二次分发需遵守数据保护法规
- 服务连续性：第三方 API 存在服务变更或终止风险，关键业务需考虑备选方案