youtube-playlist

核心功能

youtube-playlist 技能专用于解析 YouTube 播放列表内容，支持两种主要场景：一是批量列出播放列表中的所有视频（含标题、频道、时长、缩略图等元数据），二是结合转录功能获取系列视频的完整文本内容。该技能通过 TranscriptAPI.com 提供服务，采用 REST API 架构，无需本地运行时依赖。

显著优点

1. 批量处理能力：支持分页获取播放列表（每页100条），可自动遍历大型系列（如50+集的课程或播客）。
2. 多类型播放列表兼容：不仅支持用户创建的 PL 前缀列表，还涵盖频道上传 (UU)、点赞 (LL)、收藏 (FL) 等系统列表。
3. 与转录工作流无缝衔接：获取视频ID后可直接调用同平台的转录接口，形成「列表→视频→文本」的完整 pipeline。
4. 低门槛接入：免费 tier 提供100积分（可获取100页列表或约10000条视频条目），无需信用卡。

局限与风险

• 速率与成本限制：1积分/页，大型播放列表（如500+视频）消耗较快；免费额度耗尽后需付费。
• Cloudflare 防护敏感：必须携带有效的 User-Agent 头（如 YourAgent/1.0），否则返回 403/1010 错误。
• 仅公开内容：私有或受限播放列表无法访问，部分区域限制内容可能 404。
• 无创建/编辑功能：仅支持读取，不支持管理用户播放列表（如添加视频、修改顺序）。
• 依赖第三方服务：TranscriptAPI 的服务可用性、数据保留政策及定价变更不受用户控制。

适用人群

内容研究者、在线课程学员、播客整理者、市场调研人员，以及需要将 YouTube 系列视频结构化归档的知识工作者。

安全建议

API 密钥 (sk_ 开头) 应妥善保管，避免硬编码或泄露至版本控制；建议在环境变量中配置并限制该密钥的调用来源。

核心用法

youtube-playlist 是一款纯文档型 Skill，用于浏览 YouTube 播放列表内容并获取视频字幕。用户需提供 TranscriptAPI 密钥（免费注册，100 积分/月），通过 HTTPS 调用 transcriptapi.com 的 REST API 实现功能。

主要功能流程：
1. 播放列表解析：支持 PL/UU/LL/FL/OL 等多种播放列表 ID 格式，自动提取播放列表元数据（标题、视频数量、创建者信息）
2. 分页浏览：每页返回 100 个视频，含视频 ID、标题、频道、时长、缩略图等完整信息
3. 字幕获取：通过 /api/v2/youtube/transcript 端点获取带时间戳的纯文本字幕

典型使用场景：

• 批量获取课程/系列视频的字幕用于学习笔记
• 整理播客播放列表的内容索引
• 研究特定主题的视频元数据分析

显著优点

| 维度 | 优势 |

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

| **安全性** | T-MD 纯 Markdown 文档型，零可执行代码，S+ 顶级安全评级 |

| **透明度** | 所有 API 调用公开可查，无隐藏数据收集 |

| **成本** | 免费 tier 100 积分/月，约可处理 100 页播放列表或 100 条字幕 |

| **隐私保护** | 用户自托管 API 密钥，Skill 不接触敏感凭证 |

| **合规性** | 通过 GDPR/CCPA 数据最小化原则审查 |

潜在缺点与局限性

1. 外部依赖：完全依赖 TranscriptAPI 服务可用性，若服务中断则功能失效
2. 配额限制：免费 tier 仅 100 积分/月，大播放列表（>100 视频）可能快速耗尽
3. 公开内容限制：仅支持公开播放列表，私人/未列出内容无法访问
4. 字幕可用性：取决于视频上传者是否提供字幕，无字幕视频无法获取文本
5. 网络要求：必须保持互联网连接，无离线功能

适合人群

• 内容研究者：需要批量分析 YouTube 系列视频的研究人员
• 学习者：希望获取课程字幕制作学习笔记的学生
• 内容策展者：需要整理播放列表索引的内容运营者
• 开发者：需要 YouTube 元数据 API 的轻量级替代方案

常规风险

| 风险类型 | 说明 | 缓解措施 |

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

| API 密钥泄露 | 用户自行管理的密钥可能意外暴露 | 使用环境变量，避免硬编码 |

| 服务中断 | TranscriptAPI 服务故障 | 关注服务状态，本地备份关键数据 |

| 配额耗尽 | 免费积分不足以处理大任务 | 监控使用量，必要时升级付费方案 |

| Cloudflare 拦截 | 错误的 User-Agent 导致 403 | 按文档要求配置正确的 User-Agent 头部 |

安全认证摘要

• 安全等级：S+（顶级）
• 来源可信度：T3（个人开发者，但代码模式干净）
• 核心结论：零威胁发现，六维安全检测全部通过，可放心使用