youtube-playlist

核心用法

本技能通过 TranscriptAPI.com 提供两项核心能力：播放列表浏览与视频转录获取。用户传入 YouTube 播放列表链接后，可分页获取列表内所有视频的元数据（标题、时长、观看数、频道信息），并进一步提取任意视频的字幕文本。

API 采用标准 REST 设计，认证使用 Bearer Token。播放列表接口支持 playlist_id 或 continuation 分页参数，每页返回 100 条视频，消耗 1 credit。转录接口需指定视频 ID 或 URL，支持纯文本、带时间戳等多种输出格式。

显著优点

1. 批量处理能力：一次性处理整个播放列表，避免逐一手动提取视频 ID
2. 多播放列表类型支持：涵盖用户自建列表（PL）、频道上传（UU）、点赞视频（LL）、收藏夹（FL）等
3. 结构化数据输出：JSON 格式包含完整的视频元数据与播放列表信息，便于下游自动化处理
4. 转录联动：与同一平台的转录 API 无缝衔接，形成"列表浏览 → 单视频转录"完整工作流

潜在缺点与局限性

• 商业 API 依赖：核心功能完全依赖 TranscriptAPI.com，非 YouTube 官方接口，存在服务稳定性与长期可用性风险
• 付费门槛：免费仅 100 credits，大规模播放列表处理需付费订阅
• 权限限制：无法访问非公开播放列表；部分视频可能因上传者关闭字幕而无法转录
• 速率限制：300 req/min 对高频批量场景可能构成瓶颈

适合人群

内容创作者、播客制作团队、在线教育研究者、需要批量整理 YouTube 视频资料的知识管理用户。

常规风险

需将 API Key 配置于环境变量，存在密钥泄露风险；第三方 API 可能因 YouTube 反爬策略调整而失效，导致服务中断。

核心用法

youtube-playlist 是一个专注于 YouTube 播放列表内容提取的文档型 Skill，通过调用 TranscriptAPI.com 的 REST API 实现两大核心功能：

1. 播放列表浏览：分页获取播放列表中的视频元数据（每页100条），支持标准用户列表（PL）、频道上传（UU）、喜欢视频（LL）、收藏（FL）等全部 YouTube 播放列表类型
2. 视频转录获取：结合配套 transcript API，提取列表内任意视频的字幕文本，支持纯文本/时间戳格式

典型工作流：提取播放列表 ID → 分页遍历视频 → 选择性获取转录 → 批量内容分析或知识库构建

显著优点

• 零代码执行风险：纯 Markdown 文档型设计，仅含 curl 示例，无实际可执行代码或动态行为
• 来源可信：依赖 TranscriptAPI.com 专业 SaaS 服务，T2 级别可信组织，TLS 1.2+ 加密传输
• 成本可控：免费起步（100 credits），按需分页计费（1 credit/页），透明定价
• 格式规范：返回结构化 JSON，包含视频 ID、标题、频道信息、时长、缩略图等完整元数据
• 隐私友好：无本地数据存储，无用户行为追踪，纯代理式 API 调用

潜在局限

• 外部依赖：完全依赖 TranscriptAPI.com 服务可用性，该服务非 Google 官方 API，存在单点故障风险
• 访问限制：仅支持公开播放列表，私有/受限内容无法获取
• 额度消耗：大规模播放列表（数千视频）需多页请求，credit 消耗累积较快
• 无离线能力：必须保持网络连接，无法缓存或离线浏览历史数据
• 速率限制：免费 tier 300 req/min，大规模批量处理需升级付费

适合人群

• 内容创作者：批量分析竞品频道视频主题与结构
• 研究人员：构建 YouTube 视频语料库，用于 NLP、教育技术研究
• 知识管理用户：将播客/讲座播放列表转为可搜索文本档案
• 开发者：快速原型播放列表数据集成，无需自建 YouTube Data API 基础设施

常规风险

| 风险类型 | 等级 | 说明 |

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

| 供应链风险 | 低 | 单一第三方依赖，建议监控服务状态页 |

| API 密钥泄露 | 中 | 用户需自行保管 `TRANSCRIPT_API_KEY`，遵循环境变量最佳实践 |

| 数据合规 | 低 | 转录内容可能受原视频版权约束，商用需确认授权 |

| 服务持续性 | 中 | 非 Google 官方服务，长期可用性存在不确定性 |

安全认证摘要

CLS-Certify v2.1.0 扫描结果：S+ 顶级安全等级（98/100 分）

• 静态/动态/依赖/隐私/威胁情报 全维度通过
• 零可执行代码，零敏感信息硬编码
• 140+ 威胁模式库零命中