youtube-playlist

核心用法

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（超时），需实现指数退避重试机制。

核心功能

youtube-playlist 是一个专注于 YouTube 播放列表处理的实用工具，通过 TranscriptAPI.com 商业服务提供两项核心能力：一是分页浏览播放列表（每页 100 条视频），支持 PL/UU/LL/FL/OL 等多种播放列表类型；二是获取视频转录文本，可将播放列表内任意视频的字幕导出为带时间戳的文本格式。

显著优点

1. API 设计简洁：采用标准的 REST 接口，支持 playlist_id 首请求 + continuation 分页的流式翻页模式
2. 元数据丰富：返回视频标题、频道信息、缩略图、播放量、索引位置及播放列表整体信息（标题、描述、所有者、总播放量）
3. 转录集成：与播放列表浏览无缝衔接，可直接对列表内视频发起转录请求
4. 免费试用友好：注册即赠 100 credits，每页消耗 1 credit，无信用卡门槛
5. 安全合规：静态代码分析通过，无危险函数调用，HTTPS 加密传输，GDPR/CCPA 合规

潜在局限与风险

1. 商业服务依赖：核心功能完全依赖 TranscriptAPI.com，存在服务商稳定性与定价策略变更风险
2. 额度消耗敏感：大规模播放列表（如频道全部上传 UU 类型）可能快速消耗 credits
3. 转录可用性限制：实际能否获取转录取决于视频本身是否含字幕/自动生成字幕
4. 配置修改行为：认证脚本会写入 Agent 配置文件（~/.clawdbot/moltbot.json）和用户 Shell 配置文件（.bashrc/.zshenv 等），虽为功能必需，但用户需知晓
5. 仅支持公开播放列表：私密或未列出的播放列表无法访问

适合人群

• 内容创作者进行竞品播放列表分析
• 研究人员批量获取教育/演讲类视频转录
• 媒体监测团队追踪特定频道内容更新
• 需要构建视频内容知识库的技术用户

常规风险

• API Key 泄露风险：密钥以环境变量和配置文件形式存储，需确保文件权限（建议 600）
• 服务中断风险：TranscriptAPI.com 服务不可用时将完全失去功能
• 成本累积风险：超出免费额度后需付费，大规模批处理前需评估 credits 消耗