youtube-playlist

核心功能

youtube-playlist 是一款基于 TranscriptAPI.com 的 YouTube 播放列表解析与字幕提取工具。其核心能力分为两层：一是播放列表浏览——支持解析包括用户自建列表（PL）、频道上传（UU）、点赞视频（LL）、收藏夹（FL）在内的多种播放列表类型，单次请求返回最多100个视频的完整元数据（标题、频道、时长、播放量、缩略图等）；二是字幕转录获取——可针对列表内任意视频提取带时间戳的完整文本字幕，支持纯文本或结构化格式输出。

显著优点

1. 批量处理效率：分页机制支持大型播放列表（数百至数千视频）的完整遍历，适合课程、会议录播、播客系列等系统化内容归档
2. 多格式字幕输出：支持纯文本、带时间戳、含元数据的灵活格式，便于后续 NLP 分析、知识库构建或翻译工作流
3. 零门槛试用：100 credits 免费额度（约100页/100个视频），无需绑定信用卡即可完整体验核心功能
4. 标准化 API 设计：RESTful 接口、Bearer Token 认证、OpenAPI 规范文档，易于集成至自动化脚本或第三方工具链

潜在局限与风险

• 成本累积：播放列表遍历按页计费（1 credit/页），大型列表可能快速消耗额度；字幕提取另计费用，高频使用需关注账单
• 数据源依赖：完全依赖 TranscriptAPI.com 的服务可用性与 YouTube 数据抓取稳定性，存在因平台反爬策略导致的间歇性失效风险
• 隐私合规：处理含个人信息的播放列表（如 LL 点赞列表）时需确保符合 GDPR 等数据保护法规
• 字幕覆盖率：自动生成的 YouTube 字幕存在准确性问题，且部分视频可能无字幕或区域限制

适合人群

• 研究人员、学生：系统性整理学术会议、公开课、TED 演讲等内容
• 内容创作者：竞品分析、选题灵感挖掘、脚本参考
• 企业知识管理：内部培训视频归档与可搜索化改造
• 开发者：构建 YouTube 内容分析、RAG 知识库、多语言翻译等自动化工作流

常规风险提示

| 等级 | 事项 |

|:---|:---|

| ⚠️ 中等 | API Key 需妥善保管，避免硬编码提交至公共仓库 |

| ⚠️ 中等 | 遵守 YouTube 服务条款，禁止用于大规模商业抓取 |

| ⚠️ 中等 | 免费额度用尽后服务将中断，生产环境需配置余额监控 |

核心功能

youtube-playlist 是一款专注于 YouTube 播放列表数据获取的 Skill，通过整合 TranscriptAPI.com 服务，提供两大核心能力：

1. 播放列表浏览：分页获取播放列表视频列表（每页 100 条），支持标准播放列表（PL 前缀）、频道上传（UU）、 liked 视频（LL）等多种类型
2. 字幕提取：获取播放列表内视频的字幕/转录文本，支持带时间戳的文本格式

显著优点

• 便捷认证：采用密码less OTP 流程，用户仅需邮箱即可注册，无需信用卡即可获得 100 免费积分
• 结构化数据：返回完整的视频元数据（标题、频道、时长、缩略图、观看量）及播放列表信息
• 分页友好：内置 continuation_token 机制，可遍历大型播放列表
• 轻量依赖：仅依赖 Node.js 内置模块，无第三方包风险
• 多平台支持：自动识别 macOS/Linux/Windows 并配置对应 shell 环境

潜在局限

| 维度 | 说明 |

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

| **外部依赖** | 核心功能完全绑定 TranscriptAPI.com，服务可用性、数据隐私、定价策略均不受用户控制 |

| **成本控制** | 分页查询 1 积分/页，字幕获取另计积分，大型播放列表可能快速消耗免费额度 |

| **隐私顾虑** | 播放列表 ID、视频 ID 需经第三方服务器，敏感内容不适合处理 |

| **来源可信度** | 个人开发者维护（T3），非 Google 官方或知名组织背书 |

| **配置侵入** | 自动修改用户 shell 配置文件（`~/.zshenv`, `~/.bashrc` 等）和 Agent 配置，虽功能必需但缺乏透明预览 |

适合人群

• 研究者、内容创作者需批量提取播放列表视频清单与字幕
• 需自动化 YouTube 内容分析工作流的技术用户
• 能接受第三方 SaaS 依赖、非隐私敏感场景

常规风险

• 服务中断：TranscriptAPI.com 服务变更或终止将导致 Skill 失效
• 数据外泄：播放列表偏好、观看历史（通过 LL/FL 等私人列表）暴露给第三方
• 配置冲突：自动写入 shell 配置可能覆盖用户自定义设置
• 积分误耗：未及时检查 has_more 或重复请求可能导致积分浪费

建议用户先用临时邮箱测试，验证服务稳定性后再用于生产场景。