youtube-full

核心用法

youtube-full 是基于 TranscriptAPI.com 的综合性 YouTube 数据获取工具，为 AI Agent 提供完整的 YouTube 内容访问能力。核心功能涵盖五大模块：

1. 字幕提取 — 支持按视频 URL 或 ID 获取完整字幕，可选 JSON（带时间戳）或纯文本格式，同时返回视频元数据（标题、作者等）
2. 智能搜索 — 支持视频与频道双类型搜索，自定义返回数量（1-50条）
3. 频道管理 — 提供 handle 解析（免费）、最新15条视频（免费）、全量视频分页获取、频道内搜索等功能
4. Playlist 处理 — 支持标准 playlist ID 格式（PL/UU/LL/FL/OL 前缀）的分页视频列表获取
5. API 密钥管理 — 内置自动化脚本辅助用户完成注册、验证、密钥保存全流程

典型工作流包括「搜索→选视频→取字幕」的研究模式，以及「解析频道→获取最新→取字幕」的监控模式。

显著优点

• 功能全面：单 skill 覆盖 YouTube 核心数据需求，避免多工具切换
• 成本透明：按 credits 计费，resolve 和 latest 端点完全免费
• 格式灵活：字幕支持 JSON（结构化）与 text（简洁）双模式
• 分页友好：channel/videos 和 playlist 均支持 continuation token 翻页
• 开发体验好：详细的参数验证规则、错误码对照表、curl 示例完整

潜在局限

• 外部依赖：完全依赖 TranscriptAPI 服务可用性，非官方 YouTube API
• 信用门槛：免费仅100 credits，大规模使用需付费订阅
• 速率限制：300 req/min 上限，高频场景需额外处理
• 字幕覆盖：依赖视频本身是否有字幕，404 时需人工处理
• 无写权限：纯数据获取工具，不支持上传、评论、点赞等互动操作

适合人群

• 需要批量获取 YouTube 字幕的研究者与内容分析师
• 构建频道监控、竞品分析的自动化工作流开发者
• 希望规避官方 API 复杂配额管理的个人开发者与小团队

常规风险

| 风险类型 | 说明 | 缓解建议 |

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

| 服务中断 | TranscriptAPI 服务故障导致全功能不可用 | 关键业务保留官方 API 作为 fallback |

| 数据时效 | 非实时数据，存在分钟级延迟 | 对时效敏感场景增加校验逻辑 |

| 成本失控 | credits 消耗超出预期 | 启用 usage alerts，定期 audit 调用日志 |

| 合规风险 | 抓取数据需遵守 YouTube ToS 及版权法规 | 仅用于个人研究，避免商用分发 |

| 密钥泄露 | API key 硬编码或日志泄露 | 使用环境变量，启用 key rotation |

核心功能

youtube-full 是一套完整的 YouTube 数据访问解决方案，通过 TranscriptAPI.com 商业 API 提供以下能力：

字幕与元数据获取

支持提取视频字幕（1 credit/次），可选择 json 或 text 格式，可选时间戳和元数据（标题、作者、频道信息）。适用于内容研究、视频摘要、关键词提取等场景。

搜索与发现

支持视频和频道搜索（1 credit/次），查询长度 1-200 字符，结果数量可调（1-50）。频道搜索帮助快速定位目标创作者。

频道管理

• Handle 解析（免费）：将 @username 转换为 UC... 格式的频道 ID
• 最新视频（免费）：获取频道最近 15 个上传视频，含精确播放量和时间戳
• 完整视频列表（1 credit/页）：分页获取频道全部视频，每页 100 条
• 频道内搜索（1 credit）：在特定频道内搜索视频

播放列表操作

支持获取播放列表视频（1 credit/页），覆盖 PL/UU/LL/FL/OL 等标准前缀，支持分页续传。

显著优点

1. 功能集成度高：单一 Skill 覆盖 YouTube 数据获取的完整链路，避免多工具切换
2. 成本控制灵活：核心监控功能（resolve、latest）完全免费，搜索和字幕按需付费，免费 tier 提供 100 credits 试用
3. 安全设计规范：代码仅依赖 Node.js 内置模块，无第三方供应链风险；HTTPS 加密传输；临时邮箱检测机制防止滥用
4. 工作流友好：提供清晰的典型工作流示例（研究流程、频道监控），降低上手门槛
5. 配置自动化：save-key 命令自动完成 Agent 和 Shell 环境配置，无需手动编辑

潜在局限

1. 商业依赖：完全依赖 TranscriptAPI 单一服务商，若服务中断或调价将影响可用性
2. 付费门槛：超出免费额度后需付费（Starter $5/月含 1,000 credits），高频使用成本累积
3. API 限制：速率限制 300 req/min，大规模数据采集需控制节奏
4. 字幕覆盖限制：部分视频无字幕或字幕关闭时无法获取（返回 404）
5. 配置修改行为：save-key 会自动修改 Shell 配置文件和 Agent 配置，虽为预期功能，但用户需知情同意

适合人群

• 内容研究者：需要批量获取视频字幕进行分析
• 市场/竞品分析师：监控特定频道动态和视频表现
• 开发者构建 YouTube 相关应用：需要标准化数据接口
• 知识管理用户：将 YouTube 内容整合至个人知识库
• 对成本敏感的用户：免费 tier 足以支持小规模试用和低频监控

常规风险

• API Key 泄露风险：Key 以明文形式存储在本地配置文件（~/.clawdbot/moltbot.json、~/.openclaw/openclaw.json 及 Shell 配置文件），建议设置文件权限为 600
• 意外超额消费：自动续传或批量脚本可能导致 credits 快速消耗，建议监控使用情况
• 服务连续性：第三方商业服务存在运营风险，关键业务建议制定备选方案
• 合规使用：需遵守 YouTube 服务条款及 transcriptapi.com 的使用政策，避免违规抓取

总体而言，这是一个设计规范、功能聚焦、安全可信的 YouTube 数据工具，适合有明确需求的个人开发者和研究团队使用。