Youtube Skills For Ai Agents

Name: Youtube Skills For Ai Agents
Author: ZeroPointRepo

本地服务

github.com/ZeroPointRepo媒体与设计1.1k5 周前更新

代码仓库

关于 Youtube Skills For Ai Agents

YouTube Skills 基于 TranscriptAPI，为支持 Agent Skills 格式的 AI Agent 提供 YouTube 字幕提取、视频搜索、频道浏览和播放列表解析能力。无需 yt-dlp 或浏览器，通过 API 调用即可完成，面向需要 YouTube 内容研究的用户。

主要功能

01提取带时间戳的完整视频字幕
02按关键词搜索视频和频道
03浏览频道上传内容并解析 @handle
04提取播放列表中的全部视频

适用场景

01让 Agent 总结或翻译指定视频的内容
02在单个频道内按关键词检索视频
03批量获取播放列表或频道中视频的字幕

MCP 相关

该项目提供 MCP 服务器形式的访问方式，可让 Claude、ChatGPT 等 LLM 直接调用 YouTube 数据接口。

#youtube #transcript #video #search #transcription #captions #subtitles #mcp #ai-agent #content #research-website-https-transcriptapi-com

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "youtube-skills": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/claude-code"
      ]
    }
  }
}

启动命令npx -y @anthropic-ai/claude-code

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@anthropic-ai/claude-codestdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

面向 AI Agent 的 YouTube 技能 🎬

通过任意 AI Agent 获取 YouTube 字幕稿、搜索视频、浏览频道并提取播放列表。

YouTube Skills 可让你的 AI Agent 即时访问 YouTube 字幕稿、视频搜索、频道数据和播放列表提取。无需 yt-dlp（YouTube 会屏蔽所有主要云服务 IP）、无需无头浏览器，也无需二进制文件——只需一次快速的 API 调用，即可在任何地方使用。由 TranscriptAPI 提供支持，与 YouTubeToTranscript.com 使用同一后端。

适用于 🦞 OpenClaw（ClawdBot/Moltbot）、 README 配图 Hermes Agent、Claude Code、Cursor、Antigravity，以及任何支持 Agent Skills 格式的 Agent。

免费套餐 · 无需信用卡 · 注册即获 100 个额度

TranscriptAPI.com · MCP Server · 文档

安装

大多数用户需要 youtube-full——它通过一个技能涵盖字幕稿、搜索、频道和播放列表。

🦞 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

一次安装全部 12 个技能：

npx skills add ZeroPointRepo/youtube-skills

手动安装（git clone）：

git clone https://github.com/ZeroPointRepo/youtube-skills.git
cp -r youtube-skills/skills/youtube-full ~/.claude/skills/

不是开发者？ 只需将这段提示词粘贴到 🦞 OpenClaw、 Hermes Agent、Claude、ChatGPT 或任意 AI Agent 中：
Install the youtube skills from this GitHub repo: https://github.com/ZeroPointRepo/youtube-skills
I want to be able to get YouTube transcripts, search YouTube, and browse channel videos from my agent.
Set everything up for me.
剩下的交给 Agent 处理。

你可以做什么

只需安装并提出需求。无需配置，无需编写代码——用日常语言与 Agent 对话即可。

任务	提示词示例
获取 YouTube 字幕稿	“总结这个视频：[URL]”
搜索 YouTube	“查找有关机器学习的视频”
浏览频道	“TED 本周发布了什么内容？”
获取播放列表内容	“列出此播放列表中的所有视频”
提取视频字幕	“获取这个视频的西班牙语字幕”
批量获取字幕稿	“获取此频道中每个视频的字幕稿”
研究某个主题	“查找并总结有关量子计算的排名前 5 的视频”
获取最新上传的视频	“给我看看 NASA 最近的视频”
在频道内搜索	“在 TED 频道中搜索‘人工智能’”

设置 — API 密钥

安装技能并首次运行 Agent 时，Agent 会自动为你设置免费的 API 密钥。具体过程如下：

Agent 会询问你的电子邮箱地址，并为你注册 TranscriptAPI
你会在邮箱中收到一个 OTP 验证码，Agent 会让你输入该验证码
验证通过后，Agent 会自动将 API 密钥保存到你的 shell 和 Agent 配置中

就这么简单。可免费使用 100 个额度，无需信用卡。

手动设置（如果你希望自行操作）

在 transcriptapi.com 注册 — 免费，无需信用卡
从控制面板复制 API 密钥（以 sk_ 开头）
请 Agent 为你保存：

“我的 TranscriptAPI 密钥是 sk_... — 请为我保存，确保它在不同会话中都能使用。”

或者自行将其设为环境变量：

export TRANSCRIPT_API_KEY="sk_your_key_here"

密钥会保存在哪里？

Agent 会将 API 密钥保存在以下位置（取决于运行环境）：

位置	文件
OpenClaw/Moltbot	`~/.openclaw/openclaw.json` 或 `~/.clawdbot/moltbot.json`
Hermes Agent	Hermes 密钥存储（通过技能 frontmatter 中的 `required_environment_variables` 声明 `TRANSCRIPT_API_KEY`）
macOS shell	`~/.zshenv`、`~/.zprofile`
Linux shell	`~/.profile`、`~/.bashrc`、`~/.zshenv`
Fish shell	`~/.config/fish/config.fish`
备用位置	`~/.transcriptapi`（权限模式 600）

保存后，Agent 会自动读取密钥。

技能

youtube-full 是推荐大多数用户使用的技能，包含所有功能：文字稿、搜索、频道和播放列表。

如果你更喜欢规模较小、用途更专一的技能（上下文越小，Agent 执行特定任务的表现越好），可按需选择：

技能	功能	安装
youtube-full	全部功能 — 文字稿、搜索、频道、播放列表	`--skill youtube-full`
transcript	获取带时间戳的视频文字稿	`--skill transcript`
youtube-search	搜索 YouTube 视频和频道	`--skill youtube-search`
youtube-channels	浏览上传内容、获取最新视频、解析 @handle	`--skill youtube-channels`
youtube-playlist	提取播放列表中的所有视频	`--skill youtube-playlist`

# Install a specific skill
npx skills add ZeroPointRepo/youtube-skills --skill transcript

# Install multiple specific skills
npx skills add ZeroPointRepo/youtube-skills --skill transcript --skill youtube-search

全部 12 项技能

我们总共提供 12 项技能。其中许多是上述 5 项核心技能的精简变体或别名 — 因此无论你如何描述需求，Agent 都能找到合适的技能。

技能	描述
youtube-full	完整的 YouTube 工具包 — 文字稿 + 搜索 + 频道 + 播放列表
transcript	提取任意 YouTube 视频的文字稿并附带时间戳
captions	获取 YouTube 视频的隐藏字幕 / CC
subtitles	提取 YouTube 视频的字幕
youtube-search	搜索 YouTube 视频和频道
youtube-channels	浏览频道上传内容、获取最新视频、解析 @handle
youtube-playlist	获取 YouTube 播放列表中的所有视频
youtube-data	获取 YouTube 视频和频道数据（Google API 的轻量替代方案）
youtube-api	为 AI Agent 提供 YouTube API 访问 — 无需担心 Google 配额
transcriptapi	完整访问 TranscriptAPI 的所有端点
video-transcript	将 YouTube 视频转换为文字稿
yt	用于快速查询的 YouTube 实用工具

定价

方案	价格	积分	速率限制
Free	$0	注册即赠 100 积分	300 req/min
Starter	$5/month	每月 1,000 积分	300 req/min
Starter Annual	$54/year ($4.50/mo)	每月 1,000 积分	300 req/min

大多数操作消耗 1 积分。频道解析和最新内容免费。免费套餐无需信用卡。

查看定价 →

支持的 Agent

适用于所有支持 Agent Skills 格式的 AI Agent：

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	`npx skills add ZeroPointRepo/youtube-skills`
Cursor	`npx skills add ZeroPointRepo/youtube-skills`
Antigravity	`npx skills add ZeroPointRepo/youtube-skills`
Cline	`npx skills add ZeroPointRepo/youtube-skills`
Codex	`npx skills add ZeroPointRepo/youtube-skills`
其他	Goose、AMP、Kiro、Roo、OpenCode、Gemini、GitHub Copilot...

常见问题

如何获取 YouTube 视频字幕？

安装 youtube-full（或 transcript），然后向你的 Agent 提问：

“获取此视频的字幕：https://youtube.com/watch?v=VIDEO_ID”

Agent 会获取带时间戳的完整字幕。随后你可以让它总结、翻译、引用或分析内容。

如何通过我的 Agent 搜索 YouTube？

安装 youtube-full（或 youtube-search），然后提问：

“查找有关机器学习的视频”

最多返回 50 条结果，包括标题、缩略图、观看次数和发布日期。

如何获取 YouTube 频道的所有视频？

安装 youtube-full（或 youtube-channels），然后提问：

“列出 TED 频道的所有视频”

Agent 会解析 @handle，获取上传的视频（分页，每页 100 条），之后还可以获取其中任意或全部视频的字幕。

我可以批量下载 YouTube 字幕吗？

可以。安装 youtube-full，然后提问：

“获取此播放列表中所有视频的字幕：[URL]”

Agent 会获取播放列表，遍历其中的视频，并提取每个视频的字幕。

我需要 Google YouTube Data API 密钥吗？

不需要。TranscriptAPI 可替代 Google YouTube Data API，用于字幕提取、搜索以及频道/播放列表操作。无需 Google Cloud 项目、无需担心配额限制，也无需设置 OAuth。

我需要 API 密钥吗？

需要，但注册免费且即时完成——赠送 100 积分，无需信用卡。你的 Agent 会在首次运行时自动完成设置。

我应该安装哪个技能？

想要全部功能？ → youtube-full（推荐）
只需要字幕？ → transcript
只需要搜索？ → youtube-search
只需要频道数据？ → youtube-channels
只需要播放列表？ → youtube-playlist

什么是 TranscriptAPI？

TranscriptAPI.com 是一个用于 YouTube 数据的 REST API 和 MCP 服务。它提供字幕提取、视频搜索、频道浏览和播放列表操作，专为开发者和 AI Agent 打造。也可作为 MCP 服务使用，以便直接集成大模型（Claude、ChatGPT）。

故障排除

针对用户实际遇到问题的快速解决方案。错误代码来自 API 本身，因此你的 Agent 通常会原样报告这些代码。

症状	可能原因	解决方法
`401 Unauthorized`	API 密钥缺失、输入错误，或未加载到环境中	确认在 Agent 运行的 shell 中设置了 `TRANSCRIPT_API_KEY`，且密钥以 `sk_` 开头
`402 Payment Required`	账户余额不足	在 transcriptapi.com/billing 查看余额
`403`，Cloudflare 代码为 `1010`	请求未携带 User-Agent 标头	将 Agent 的名称设为 User-Agent，例如 `HermesAgent/0.11.0`
`404 Not Found`	视频没有字幕、并非公开，或 ID 错误	确认 URL 可在浏览器中打开，且播放器中显示字幕
`408 Request Timeout`	视频上游暂时负载过高	这是暂时性问题：等待几秒后重试一次
`422 Validation Error`	参数格式错误，例如频道或播放列表引用无效	频道接受 `@handle`、频道 URL 或 `UC` ID；播放列表接受 `PL`、`UU`、`LL`、`FL` 和 `OL` 前缀
`429 Too Many Requests`	达到速率限制	等待并遵循 `Retry-After` 标头

另外有三种情况值得了解：

密钥已保存，但 Agent 无法读取。 Shell 配置文件会根据 shell 类型分别加载：查看设置部分中“密钥保存在哪里？”下方的表格，并确认文件与 Agent 实际运行的 shell 匹配。保存密钥后重启 Agent 通常可以解决大多数问题。
直播和首映。 直播结束且字幕处理完成后，才能获取转录文本；直播过程中无法获取。
转录文本的语言与预期不符。 许多视频只有原语言字幕。请求转录文本时指定首选语言参数，或让 Agent 翻译结果。

由 TranscriptAPI 提供支持

TranscriptAPI.com — 每月处理 1,500 万多条转录文本，正常运行时间达 99.9%。

另有：MCP 服务，可直接与 Claude 和 ChatGPT 集成。

完整 API 文档：transcriptapi.com/docs

收录于 awesome-hermes-skills，这是我们的 Hermes Agent 技能、插件、Agent 配置和记忆提供商目录。

披露声明

TranscriptAPI 是一款独立产品，与 YouTube 或 Google 无关联，也未获得其认可。

贡献

欢迎提交 PR。请参阅 CONTRIBUTING.md。

许可证

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。