youtube-playlist

YouTube Playlist 技能评估

核心用法

YouTube Playlist 技能专用于解析 YouTube 播放列表结构与批量获取视频字幕。用户只需提供播放列表 URL 或 ID，即可提取完整的视频元数据（标题、频道、时长、缩略图、观看量等），并通过关联接口获取单个视频的字幕文本（支持纯文本或带时间戳格式）。该技能采用分页机制（每页 100 条视频），支持大型播放列表的完整遍历。

显著优点

• 批量处理能力：单次 API 调用可获取 100 条视频信息，显著优于逐个视频解析的效率
• 多格式字幕输出：支持纯文本、带时间戳 JSON 等多种格式，适配学术研究、内容摘要、SEO 分析等场景
• 低门槛接入：100 免费额度起步，无需信用卡即可注册试用
• 结构化数据返回：包含播放列表级元数据（总视频数、总观看量、拥有者信息）与视频级详情
• 广泛兼容性：支持用户自建列表（PL 前缀）、频道上传列表（UU）、点赞列表（LL）、收藏夹（FL）等多种播放列表类型

潜在局限与风险

• 成本累积：播放列表解析 1 积分/页，字幕获取另计费用，大型列表（数百视频）成本可观
• 公开内容限制：仅支持公开播放列表，私有/未列出内容无法访问
• 第三方依赖：TranscriptAPI.com 为商业 API 服务，存在服务稳定性、定价策略变更、数据留存政策等外部风险
• 无原生视频下载：仅提供元数据与字幕，不支持音视频文件获取
• 速率限制：免费 tier 限 300 请求/分钟，大规模批量作业需规划调度

适合人群

• 学术研究者：需要批量获取公开讲座、访谈的字幕进行文本分析
• 内容创作者与运营：竞品播放列表分析、热门内容趋势挖掘
• 数据分析师：YouTube 内容生态的量化研究与可视化
• 教育机构：课程资源整合与教学资料归档

常规风险提示

API 密钥存储于本地配置文件（~/.openclaw/openclaw.json），虽存在备份机制，仍需注意本地文件权限安全。建议生产环境配合专用 API 密钥与最小权限原则使用。

核心用法

youtube-playlist Skill 专注于两大功能：浏览 YouTube 播放列表内容与获取视频转录文本。用户可通过播放列表 URL 或 ID 快速拉取前 100 条视频元数据（标题、频道、时长、缩略图等），支持分页续传（continuation token）处理大型列表。结合转录端点，可进一步提取带时间戳的完整字幕文本。

认证流程简洁：用户提供邮箱 → 接收 OTP → 完成验证，API Key 自动写入 ~/.openclaw/openclaw.json（含备份机制）。免费额度 100 credits，每页播放列表消耗 1 credit。

显著优点

• 结构化数据输出：返回标准 JSON，包含 playlist_info 元数据与分页令牌，便于程序化整合
• 轻量零依赖：仅使用 Node.js 内置模块，无第三方包引入供应链风险
• 隐私设计合理：仅读取 TRANSCRIPT_API_KEY 环境变量，不遍历全部环境变量，不采集敏感个人信息
• 文件操作规范：配置写入前自动备份原文件，降低配置丢失风险
• HTTPS 全链路加密：与 transcriptapi.com 通信采用 TLS 1.2+

潜在局限与风险

• 外部 API 依赖：核心功能绑定 transcriptapi.com，服务可用性、定价策略、长期维护均由第三方决定
• T3 来源可信度：开发者 therohitdas 为个人 GitHub 账户，非企业或顶级开源基金会背书，需关注项目维护持续性
• 免费额度有限：100 credits 约支持 100 页播放列表或等效转录请求，高频使用需付费
• 配置文件权限：当前实现未强制设置 600 权限，多用户系统可能存在 API Key 泄露风险
• 无数据删除机制：用户无法通过 Skill 直接删除已注册的邮箱或 API Key 数据

适合人群

• 研究者与内容分析师：需要批量获取 YouTube 播放列表结构与转录文本进行 NLP 分析
• 播客与视频编辑：快速提取字幕进行剪辑参考或内容重组
• 开发者构建自动化工作流：配合其他工具实现播放列表监控与内容归档

常规风险

• 服务中断：transcriptapi.com 若停止服务，Skill 功能完全失效
• API Key 泄露：配置文件权限不当或环境变量管理不善可能导致未授权使用
• 成本失控：未监控使用量可能快速消耗 credits 产生意外费用
• 隐私合规：需提供真实邮箱注册，用户应自行评估第三方服务的隐私政策