youtube-playlist

核心用法

YouTube Playlist 技能专注于两大场景：播放列表视频浏览与视频字幕提取。用户传入播放列表URL或ID（支持PL/UU/LL/FL/OL前缀），即可分页获取列表内视频元数据（标题、频道、时长、播放量），并可联动TranscriptAPI进一步提取逐字稿。

典型工作流：
1. 调用 /api/v2/youtube/playlist/videos 获取播放列表视频列表（每页100条，1积分/页）
2. 选取目标视频，调用 /api/v2/youtube/transcript 获取带时间戳的文本字幕

显著优点

• 播放列表类型全覆盖：不仅支持普通用户创建列表（PL），还原生支持频道上传（UU）、喜欢（LL）、收藏（FL）等系统列表
• 分页机制清晰：提供continuation_token实现大数据量列表的流式处理
• 与字幕API深度整合：从列表浏览到单视频逐字稿形成完整闭环
• 低成本试错：免费层100积分，足够测试10个完整列表（假设每列表10页）

潜在缺点与局限性

• 依赖第三方服务：核心数据来自TranscriptAPI.com，非YouTube官方API，存在服务中断或策略变更风险
• 计费模式隐性成本：大型播放列表（如500+视频的教育频道上传列表）可能快速消耗积分
• 无视频内容过滤：仅返回基础元数据，无法按时长、上传日期等条件服务端筛选
• 地域/隐私限制：无法获取私密或地域限制播放列表内容

适合人群

• 研究人员：批量获取教育/演讲类播放列表的逐字稿进行分析
• 内容运营：监控竞品频道的内容矩阵与更新节奏
• 语言学习者：提取带时间戳的台词进行精读训练
• 播客/视频剪辑者：快速定位长视频中的关键片段

常规风险

• API密钥泄露风险：TRANSCRIPT_API_KEY以环境变量形式存储，多用户共享环境时需谨慎
• 服务稳定性：非官方接口，YouTube前端结构变更可能导致解析失败（虽历史稳定性较好）
• 积分耗尽中断：批量处理长列表时若未预估积分，可能中途失败
• 版权合规：提取的字幕仅应用于个人学习、研究等合理使用场景，商业再分发存在法律风险

核心功能与用法

youtube-playlist 是一款面向内容创作者、研究者和知识工作者的 YouTube 播放列表管理工具。它通过 TranscriptAPI.com 提供两项核心能力：播放列表视频批量浏览与视频字幕获取。

主要使用场景

1. 播放列表内容概览：输入播放列表 URL 或 ID，快速获取前 100 个视频的元数据（标题、频道、时长、播放量、缩略图），支持分页翻页浏览大型播放列表。
2. 批量字幕提取：结合 playlist → transcript 工作流，可批量获取播放列表内视频的文字稿，支持纯文本、带时间戳格式输出。
3. 频道内容分析：利用 UU（频道上传）、LL（ liked videos）等系统播放列表前缀，分析特定频道的内容结构。

显著优点

• 零门槛试用：100 免费 credits（约可浏览 100 页或获取 100 条字幕），无需绑定信用卡。
• 标准化输出：返回结构化 JSON，包含视频 ID、标题、频道信息、缩略图等完整元数据。
• 智能分页：自动处理 continuation token，支持大型播放列表（>100 视频）的分页获取。
• 安全传输：全程 HTTPS，API Key 本地存储（shell profile + ~/.transcriptapi），不传输至第三方。
• 纯内置依赖：认证脚本仅使用 Node.js 内置模块，无 npm 依赖，供应链风险极低。

潜在局限与风险

| 维度 | 说明 |

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

| **成本** | 1 credit/页（playlist）或 1 credit/视频（transcript），大型播放列表成本累积 |

| **覆盖限制** | 仅支持公开播放列表；私有、未列出、区域限制视频无法获取 |

| **字幕可用性** | 依赖 YouTube 原生字幕/自动字幕，无字幕视频无法生成 transcript |

| **来源可信度** | T3 级别（个人开发者维护），无公开 GitHub 仓库，需通过社区反馈验证 |

| **权限操作** | 认证脚本自动修改 shell 配置文件（~/.bashrc, ~/.zshenv 等），属高权限行为 |

适合人群

• 知识管理者：将 YouTube 课程、讲座、播客转为可搜索文字稿
• 内容研究者：批量分析播放列表结构、频道内容策略
• 语言学习者：获取带时间戳字幕，配合视频精读
• 数据分析师：提取结构化元数据进行趋势分析

常规风险提示

• API Key 泄露可能导致 credits 被盗用，建议定期轮换
• 大规模爬取可能触发 YouTube/TranscriptAPI 速率限制（300 req/min）
• 自动字幕准确性因视频质量、口音、专业术语而异，关键场景建议人工校对
• 个人开发者维护，长期更新与支持稳定性需持续关注

技术细节

• API 端点：transcriptapi.com/api/v2/youtube/playlist/videos（分页列表）、/transcript（字幕获取）
• 认证方式：Bearer Token（Authorization: Bearer $TRANSCRIPT_API_KEY）
• 支持播放列表前缀：PL（用户创建）、UU（频道上传）、LL（点赞视频）、FL（收藏）、OL（其他系统列表）