youtube-playlist

核心功能

YouTube Playlist 是一款专为批量处理 YouTube 内容设计的工具，基于 TranscriptAPI.com 服务提供两大核心能力：播放列表视频枚举与视频字幕提取。用户仅需提供播放列表 URL，即可自动解析 PL/UU/LL/FL/OL 等标准格式的播放列表 ID，分页获取列表内所有视频的元数据（标题、时长、播放量、频道信息），并进一步调用字幕接口下载带时间戳的完整转录文本。

显著优势

• 批量处理能力：单次请求支持 100 条视频分页加载，适合大型播放列表（如 50+ 集的系列课程）
• 多格式兼容：支持用户自建列表（PL）、频道上传（UU）、喜欢视频（LL）等五种官方播放列表类型
• 结构化输出：返回 JSON 格式的视频元数据与纯文本/时间轴字幕，便于接入下游分析流程
• 低成本入门：免费额度 100 credits（约可解析 100 页/万条视频列表），无需绑定信用卡

局限与注意事项

• 依赖第三方服务：核心功能绑定 TranscriptAPI 商业服务，存在 API 稳定性与定价变更风险
• 字幕覆盖不全：仅支持 YouTube 已生成字幕的视频，无字幕或创作者禁用字幕的内容无法获取
• 速率限制：免费版 300 请求/分钟，大规模批量处理可能触发限流
• 隐私敏感：LL（喜欢视频）等私人列表需确保授权，避免泄露用户隐私

适用人群

研究人员、内容创作者、教育工作者、播客制作人——任何需要将 YouTube 视频内容结构化提取用于二次分析、知识库构建或课程笔记整理的用户。

风险提示

API 密钥需妥善保管（sk_ 开头），避免硬编码于公开仓库；播放列表解析仅支持公开可见内容，私密或受限视频将返回 404。

核心功能

youtube-playlist 是一款专注于 YouTube 内容处理的实用工具，提供两大核心能力：

1. 播放列表浏览：分页获取播放列表中的视频元数据（标题、时长、观看量、频道信息等），支持用户创建的播放列表（PL前缀）、频道上传列表（UU）、收藏夹（FL/LL）等多种类型，每页100条，自动处理分页。

2. 字幕获取：结合 TranscriptAPI 的字幕服务，可批量提取播放列表内视频的文字转录，支持纯文本或带时间戳格式。

显著优点

• 功能聚焦：专一解决播放列表→视频列表→字幕的完整工作流，无冗余功能
• 成本友好：免费 tier 提供100积分，足够处理小型播放列表（1积分/页）
• 标准 CLI 模式：配置修改符合 Unix 工具惯例，自动注入环境变量到 shell 和 Agent 配置
• 输入验证完善：对邮箱格式、API 密钥前缀（sk_）、播放列表 ID 格式均有校验
• 零第三方依赖：仅使用 Node.js 内置模块，供应链攻击面极小

局限与风险

| 方面 | 说明 |

|------|------|

| **凭证安全** | 需向 transcriptapi.com 传输邮箱密码注册，建议设置独立密码 |

| **配置修改** | 自动修改 ~/.bashrc、~/.zshrc 及 Agent 配置文件，需事后核查 |

| **来源可信度** | 维护者信息有限，GitHub 仓库无法公开验证（T3级别） |

| **服务依赖** | 核心功能完全依赖 TranscriptAPI 的可用性与定价策略 |

| **速率限制** | 300 req/min，大规模处理需控制频率 |

适合人群

• 内容创作者需要批量整理播放列表素材
• 研究人员需获取公开课程/播客的文字记录
• 需要将 YouTube 内容结构化导入知识库的用户
• 对 API 调用和 shell 配置有一定理解的技术用户

使用建议

首次使用前备份 shell 配置文件，为 TranscriptAPI 设置专用密码（勿与主邮箱密码相同），执行 save-key 后检查 ~/.clawdbot/moltbot.json 内容是否符合预期。对于敏感播放列表内容，注意 TranscriptAPI 的数据处理条款。