YouTube Skills for AI Agents
为 AI 智能体提供 YouTube 字幕获取、视频搜索、频道浏览和播放列表提取能力，无需 yt-dlp 或无头浏览器。
证据显示：SECURITY.md 明确声明技能文件不含凭证，密钥仅通过环境变量提供，且有第三方服务披露。扣分点：README 描述的自动设置流程让代理代表用户向第三方 TranscriptAPI 注册邮箱并输入 OTP，随后把密钥写入多个 shell 配置文件（.zshenv/.bashrc 等），权限面偏宽且无显式的逐次确认机制说明；无 SKILL.md 实际文件可核实 least_privilege 声明；完全依赖未经验证的第三方付费 API，外部副作用（数据外发至 transcriptapi.com）未以技能层粒度说明；无任何回滚/卸载说明。
证据显示：故障排除表详细列出 401/402/403/404/408/422/429 的成因与修法，质量较高。扣分点：评分依据的文件集中不含任何 SKILL.md 或代码，无法核实指令自洽与端点行为；强依赖单一第三方服务（TranscriptAPI），无降级路径或本地回退，可用性完全绑定外部 SLA。
证据显示：README 面向多种代理运行时（OpenClaw、Hermes、Claude Code、Cursor 等）给出安装命令，任务示例表覆盖转录/搜索/频道/播放列表，并说明了 shell 环境差异与直播、语言限制等边界。扣分点：12 个技能中多数为窄变体或别名，触发精度依赖代理自行匹配，无可见的技能定义文件核实触发词；能力边界（如订阅视频、地区限制）未完全覆盖。
证据显示：README 结构清晰（安装、示例、定价、FAQ、故障排除、许可、披露），MIT 许可证文件完整，install_notes 详尽到手动 git clone 与分技能安装，FAQ 与已知限制（直播、语言、shell 加载差异）具体。扣分点：无版本号、无 CHANGELOG、无维护者或更新承诺文件；'TranscriptAPI' 版权主体与仓库归属（ZeroPointRepo）关系未说明；命名上 12 个技能含大量别名，稳定性存疑。
证据显示：替代 yt-dlp/无浏览器方案的价值主张明确，免费层与定价透明，输出可用性通过示例提示词体现。扣分点：实际输出格式（JSON 结构、字段）在提供的文件中无从核实；批量为整个频道取转录的额度消耗可能很大但仅给出'多数操作 1 credit'，成本边界描述不完整。
证据显示：有 SECURITY.md、CI 扫描工作流（HOL Plugin Scanner，固定 action 哈希），第三方归属与不隶属声明明确。扣分点：'15M+ transcripts/month, 99.9% uptime' 等数字无来源可追溯；运行时列表与 skills.sh 徽章等主张无法在静态文件中交叉验证；宣传语与事实陈述在 README 中混排，事实与推断未分离。
- 自动设置流程会让代理代为注册第三方账号并接触邮箱 OTP，建议改用手动注册并在授权前逐项确认。
- API 密钥会被写入多个 shell 配置文件，注意检查实际写入位置并限制其可见性（权限 600）。
- 本技能完全依赖未经验证的第三方付费服务 TranscriptAPI，需自行评估其数据政策、可用性与额度成本；批量取转录可能消耗大量额度。
- 本次为静态审阅，未执行任何技能，未验证实际输出格式与端点行为；安装前建议阅读技能文件全文。
这个 Agent 能做什么，适合哪些场景？
该仓库提供一套基于 Agent Skills 格式的技能包，核心产品是 youtube-full 技能，封装了 TranscriptAPI.com 的 REST API，可获取带时间戳的 YouTube 字幕、搜索视频（最多 50 条结果）、按 @handle 解析并浏览频道上传内容、提取播放列表中的全部视频。安装通过 npx skills add、npx clawhub 或 hermes skills install 完成，共有 12 个技能，其中 5 个为核心技能，其余为窄化变体或别名。首次运行时智能体会引导用户注册 TranscriptAPI 并自动保存 API 密钥（免费 100 积分）。它不依赖 yt-dlp、无头浏览器或 Google YouTube Data API 密钥，但所有数据操作都依赖 TranscriptAPI 的付费/免费额度，因此存在明确的外部服务依赖。
安装后，智能体以纯自然语言指令调用技能：技能向 TranscriptAPI 的 REST 端点发起请求，获取带时间戳的视频字幕、最多 50 条的搜索结果（含标题、缩略图、观看数、发布日期）、频道上传列表（每页 100 条分页）、播放列表内容，并可为频道或播放列表中的每个视频批量提取字幕。API 密钥存储于环境变量 TRANSCRIPT_API_KEY 或各运行时的配置文件（如 ~/.openclaw/openclaw.、Hermes secret store、shell 配置文件，兜底为 ~/.transcriptapi）。频道支持 @handle、频道 URL 或 UC ID；播放列表支持 PL、UU、LL、FL、OL 前缀。
- 研究者让智能体抓取某话题前 5 个视频的字幕并总结内容
- 内容团队为频道本周新上传的视频批量生成文字稿
- 需要为播放列表中每个视频提取字幕并翻译的分析师
- 希望不申请 Google YouTube Data API 密钥即可在智能体中搜索 YouTube 的开发者
- 使用 OpenClaw 或 Hermes Agent 的用户想在对话中直接查询 TED、NASA 等频道的最新视频
这个 Agent 有哪些优点和局限？
- 明确支持 OpenClaw、Hermes Agent、Claude Code、Cursor、Antigravity、Cline、Codex 等多个智能体运行时，安装命令各自原生
- 无需 yt-dlp、无头浏览器或 Google Cloud 项目/OAuth 配置，避开云端 IP 被封与配额限制问题
- 12 个技能按功能拆分，可只装 transcript 或 youtube-search 等单一技能以减小上下文占用
- 提供 12 个技能、100 积分免费层及 300 请求/分钟限速，上手成本低
- 所有数据功能依赖第三方商业服务 TranscriptAPI，超出免费 100 积分后需付费（Starter $5/月 或 $54/年）
- 存在单点供应商风险：TranscriptAPI 是独立产品，与 YouTube/Google 无关联，服务条款或可用性变化会直接影响技能
- 字幕可用性受限：无字幕、非公开或直播未结束的视频返回 404；许多视频只有原始语言字幕
- 403 错误要求请求附带特定 User-Agent 头（如 HermesAgent/0.11.0），422 错误对频道/播放列表 ID 格式有严格要求，排错有一定门槛
如何安装或部署这个 Agent？
OpenClaw（ClawdBot/Moltbot）：npx clawhub@latest install youtube-full
Hermes Agent：hermes skills install skills-sh/ZeroPointRepo/youtube-skills/skills/youtube-full
Claude Code / Cursor / Antigravity / Cline / Codex：npx skills add ZeroPointRepo/youtube-skills --skill youtube-full手动：git clone https://github.com/ZeroPointRepo/youtube-skills.git 后将 skills/youtube-full 复制到 ~/.claude/skills/
首次运行时智能体自动注册 TranscriptAPI（输入邮箱→输入邮件中的 OTP→自动保存密钥）；也可在 transcriptapi.com 手动注册获取 sk_ 开头的密钥并 export TRANSCRIPT_API_KEY="sk_your_key_here"。
如何使用这个 Agent？
安装 youtube-full 后直接用自然语言向智能体提问，例如："Summarize this video: [URL]"（获取字幕并总结）、"Find videos about machine learning"（搜索）、"List all videos from the TED channel"（浏览频道）、"Get transcripts for all videos in this playlist: [URL]"（批量提取）。频道操作（解析和最新视频）免费，其余多数操作每次消耗 1 积分；免费层限速 300 请求/分钟。