核心用法
youtube-playlist 技能用于解析 YouTube 播放列表结构并批量提取视频转录文本。用户只需提供播放列表链接（如 https://www.youtube.com/playlist?list=PLxxx），即可通过 API 分页获取最多 100 条视频/页的信息，包括视频标题、频道、时长、观看数等元数据，并进一步调用转录接口获取带时间戳的字幕文本。
显著优点
1. 结构化数据处理：自动识别 PL/UU/LL/FL/OL 五种播放列表类型，无需手动区分用户创建列表、频道上传列表、喜欢/收藏列表等
2. 成本可控：每页仅消耗 1 credit（100 条视频），免费 tier 提供 100 credits 起步，适合中小规模数据分析
3. 完整元数据：返回视频 ID、频道句柄、缩略图、列表描述等多维度信息，便于构建内容索引
4. 无缝转录衔接：列表浏览与单视频转录共用同一 API 认证体系，可快速构建「列表→逐条转录」的自动化工作流
潜在缺点与局限性
- 依赖第三方 API：数据完整性与稳定性取决于 TranscriptAPI.com 的服务状态，非 YouTube 官方接口
- 付费墙限制：免费 100 credits 用完后需付费，大规模播放列表处理成本累积明显
- 仅限公开内容：私有/受限播放列表返回 404，无法处理会员专属或地域限制内容
- 无原生去重：跨页续传需自行管理
continuation_token，重复请求可能导致 credits 浪费 - 转录质量不可控：依赖 YouTube 自动生成的字幕，专业术语、多语言混讲场景下准确率下降
适合人群
内容创作者进行竞品播放列表分析、研究人员批量获取教育视频字幕、播客编辑整理访谈素材、 marketers 监测品牌频道内容矩阵。
常规风险
API 密钥泄露可能导致 credits 被盗刷，建议在受控环境存储 TRANSCRIPT_API_KEY；频繁请求可能触发 402（余额不足）或 408（超时），需实现指数退避重试机制。