YTAPI

面向 AI Agent 的 YouTube 技能

用于获取 YouTube 字幕稿、搜索视频、查看频道和播放列表的 Agent 技能，由 YTAPI 提供支持。它们适用于 Claude Code、Codex、Cursor、 OpenClaw、Hermes Agent，以及任何能够读取 Agent Skills 的 Agent。

只需通过 curl 发起普通 HTTPS 调用，无需安装其他内容。它们也适用于无法直接获取 YouTube 内容的场景：在服务器和云端 Agent 上，yt-dlp 等工具常常会遇到 HTTP 429、机器人验证或 IP 封禁。

安装

**Claude 插件：**包含 YTAPI MCP 服务，以及用于视频摘要、频道简报、主题研究和频道分析的技能。在 Claude Code 中：

/plugin marketplace add ytapi/youtube-skills
/plugin install ytapi@ytapi

Claude 首次使用 YTAPI 工具时，运行 /mcp 并登录 YTAPI 账户（或创建账户：可获赠 200 个免费点数，无需银行卡）。无需 API 密钥。插件位于 plugins/ytapi。

**Cursor：**在 Cursor Settings → MCP 中添加 YTAPI MCP 服务，或将以下内容写入 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "ytapi": { "url": "https://api.ytapi.dev/mcp" }
  }
}

Cursor 会在首次使用时要求你登录 YTAPI 账户。本仓库也是一个 Cursor 插件：根目录下的 .cursor-plugin/plugin.json 和 .mcp.json，以及下方列出的技能。

Claude Code、Codex、Cursor、Cline 等（skills.sh）：

npx skills add ytapi/youtube-skills

仅安装一项技能：

npx skills add ytapi/youtube-skills --skill ytapi-youtube-transcript

OpenClaw（ClawHub）：

npx clawhub@latest install ytapi

Hermes Agent：

hermes skills install skills-sh/ytapi/youtube-skills/skills/ytapi

**不是开发者？**将以下内容发送给你的 Agent：

从 https://github.com/ytapi/youtube-skills 安装 YouTube 技能， 并设置我的 YTAPI 密钥。

技能

技能	功能
ytapi	一个技能涵盖以下所有功能：字幕稿、视频详情、评论、最常重播片段、搜索、频道、播放列表、批量处理
ytapi-youtube-transcript	字幕稿和字幕：文本、Markdown、带时间戳的 JSON、SRT、VTT，支持任意语言
ytapi-youtube-search	搜索视频、频道、播放列表和 Shorts，然后读取搜索结果
ytapi-youtube-channels	频道资料、最新上传内容、所有视频、播放列表
ytapi-youtube-summarize	视频或频道最新上传内容的摘要和笔记，附带带时间戳的链接
ytapi-youtube-channel-analysis	竞品研究：爆款内容、频道成长历程、视频走红原因，以及可供复用的策略指南技能

如果不确定，请安装 ytapi。

API 密钥

这些技能会从 YTAPI_API_KEY 读取密钥。如果尚未设置，Agent 会询问是否为你创建免费账户：你只需提供电子邮箱地址和我们发送给你的 6 位验证码，Agent 就会保存密钥。无需浏览器，也无需银行卡。 你也可以在 ytapi.dev 自行创建密钥。

新账户可获得 200 个免费点数。每次成功请求消耗 1 个点数 （视频基本信息和搜索建议免费）；失败的请求不收费。 在购买点数包之前，密钥每秒最多可发起 1 次请求，每天最多 100 次。点数包售价为 $9 起，可获 2,000 个点数，且永不过期： 价格。

示例

• “总结这个视频：https://youtu.be/dQw4w9WgXcQ”
• “将这场演讲的西班牙语字幕保存为 SRT 文件。”
• “查找本周关于 Rust async 播放量最高的视频，并告诉我它们讲了什么。”
• “@mkbhd 最近上传了什么？请分别用两句话概括。”
• “列出此播放列表中的所有视频及其时长。”
• “@channel 最新视频为什么表现这么好？请将有效做法整理成适用于我频道的策略指南。”

链接

• 文档：https://docs.ytapi.dev（供 Agent 使用：https://docs.ytapi.dev/llms-full.txt）
• 远程 MCP 服务：https://docs.ytapi.dev/agent-setup/#mcp
• Agent 注册 API：https://docs.ytapi.dev/agent-signup/
• 支持：[email protected]

贡献

每个技能的 references/ 文件夹中都包含一份 shared/auth-setup.md，因为技能是逐个安装的。编辑 shared/ 中的文件，然后运行 ./scripts/sync-references.sh。

plugins/ytapi 中的 Claude 插件有自己的技能，这些技能使用 MCP 工具，且从不处理 API 密钥。修改这些技能时，请更新 plugins/ytapi/.claude-plugin/plugin.json 中的 version：Claude Code 会让插件用户使用其中列出的版本。

采用 MIT-0 许可证。