К основному содержанию
плагин CX Codex

youtube-skills — плагин для Claude Code: работа с YouTube

Плагин youtube-skills для Claude Code извлекает транскрипты YouTube с таймстампами, ищет видео и каналы, просматривает плейлисты через TranscriptAPI без yt-dlp и браузеров.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install youtube-skills@awesome-codex-plugins
Открыть на GitHub

Что делает youtube-skills

youtube-skills даёт агенту прямой доступ к YouTube: можно вытащить транскрипт с временными отметками, найти видео по теме, посмотреть, что загружал канал, вытащить весь плейлист. Всё через API TranscriptAPI — облачный сервис, который не блокируется, в отличие от yt-dlp на облачных IP.

В пакете двенадцать скиллов: есть полный набор youtube-full (транскрипты + поиск + каналы + плейлисты) и узкие варианты вроде transcript, captions, youtube-search, youtube-channels, youtube-playlist. Для обычного пользователя хватит полного набора; если нужна слаженная работа агента на конкретной задаче, можно установить только нужные скиллы.

Для работы нужен API-ключ TranscriptAPI. При первом запуске агент предложит зарегистрироваться: просит email, отправляет OTP-код на ящик, сохраняет ключ в конфиг. Бесплатный тариф даёт 100 кредитов без карты. Ключ хранится в конфиге агента (для OpenClaw — в ~/.openclaw/openclaw.json или ~/.clawdbot/moltbot.json, для остальных — в переменной окружения или локальном хранилище).

Какие задачи решает

  • Извлечь транскрипт из видео с таймстампами
  • Найти видео по теме на YouTube
  • Получить список всех видео в плейлисте
  • Просмотреть последние загрузки на канале
  • Получить субтитры или закрытые подписи на нужном языке

Примеры запросов агенту

  • Суммируй это видео: [ссылка]
  • Найди видео про машинное обучение
  • Какие видео опубликовал TED на этой неделе?

Как установить youtube-skills

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install youtube-skills@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о youtube-skills

Как установить youtube-skills в Claude Code?

Выполни команду /plugin marketplace add hashgraph-online/awesome-codex-plugins, потом /plugin install youtube-skills@awesome-codex-plugins. Агент сразу предложит зарегистрироваться в TranscriptAPI через email и OTP.

Что делает youtube-skills?

Даёт агенту доступ к YouTube: можно получить транскрипт видео с таймстампами, искать видео и каналы, смотреть, что загружал канал, вытаскивать плейлисты. Всё через облачный API, без локальных утилит и браузеров.

Нужна ли кредитная карта для регистрации?

Нет. Бесплатный аккаунт в TranscriptAPI даёт 100 кредитов без карты. Агент сам предложит зарегистрироваться при первом запуске.

Исходный текст

youtube-skills · MIT
# YouTube Skills for AI Agents 🎬

[![skills.sh](https://skills.sh/b/ZeroPointRepo/youtube-skills)](https://skills.sh/ZeroPointRepo/youtube-skills)

> Get YouTube transcripts, search videos, browse channels, and extract playlists — from any AI agent.

YouTube Skills gives your AI agent instant access to **YouTube transcripts**, **video search**, **channel data**, and **playlist extraction**. No yt-dlp (YouTube blocks all major cloud IPs), no headless browsers, no binaries — just a fast API call that works everywhere. Powered by [TranscriptAPI](https://transcriptapi.com), the same backend behind [YouTubeToTranscript.com](https://youtubetotranscript.com).

Works with 🦞 [OpenClaw](https://www.clawhub.ai/therohitdas/youtube-full) (ClawdBot/Moltbot), <img src="assets/hermes.png" alt="" height="14"> [Hermes Agent](https://hermes-agent.nousresearch.com), Claude Code, Cursor, Antigravity, and any agent that supports the [Agent Skills](https://skills.sh) format.

**Free tier · No credit card · 100 credits on signup**

[TranscriptAPI.com](https://transcriptapi.com) · [MCP Server](https://github.com/ZeroPointRepo/youtube-mcp) · [Docs](https://transcriptapi.com/docs/)

---

## Install

Most users want **youtube-full** — it covers transcripts, search, channels, and playlists in one skill.

**🦞 OpenClaw (ClawdBot/Moltbot):**
```bash
npx clawhub@latest install youtube-full
```

**<img src="assets/hermes.png" alt="" height="14"> Hermes Agent:**
```bash
hermes skills install skills-sh/ZeroPointRepo/youtube-skills/skills/youtube-full
```

**Claude Code / Cursor / Antigravity / Cline / Codex:**
```bash
npx skills add ZeroPointRepo/youtube-skills --skill youtube-full
```

**All 12 skills at once:**
```bash
npx skills add ZeroPointRepo/youtube-skills
```

**Manual (git clone):**
```bash
git clone https://github.com/ZeroPointRepo/youtube-skills.git
cp -r youtube-skills/skills/youtube-full ~/.claude/skills/
```

> **Not a developer?** Just paste this prompt into 🦞 [OpenClaw](https://www.clawhub.ai/therohitdas/youtube-full), <img src="assets/hermes.png" alt="" height="14"> [Hermes Agent](https://hermes-agent.nousresearch.com), Claude, ChatGPT, or any 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.
> ```
>
> The agent will handle the rest.

---

## What You Can Do

Just install and ask. No config, no code — talk to your agent in plain English.

| Task | Example Prompt |
|------|----------------|
| **Get a YouTube transcript** | "Summarize this video: [URL]" |
| **Search YouTube** | "Find videos about machine learning" |
| **Browse a channel** | "What has TED posted this week?" |
| **Get playlist contents** | "List all videos in this playlist" |
| **Extract video captions** | "Get captions from this video in Spanish" |
| **Bulk transcripts** | "Get transcripts for every video in this channel" |
| **Research a topic** | "Find and summarize the top 5 videos about quantum computing" |
| **Get latest uploads** | "Show me NASA's recent videos" |
| **Search within a channel** | "Search the TED channel for 'artificial intelligence'" |

---

## Setup — API Key

When you install a skill and run your agent for the first time, **the agent will set up your free API key automatically**. Here's what happens:

1. The agent asks you for your **email address** and registers you with TranscriptAPI
2. You'll receive an **OTP code** in your email — the agent will ask you to enter it
3. Once verified, the agent **saves the API key** to your shell and agent config automatically

That's it. 100 free credits, no credit card required.

<details>
<summary><strong>Manual setup (if you prefer to do it yourself)</strong></summary>

1. Sign up at [transcriptapi.com](https://transcriptapi.com) — free, no credit card required
2. Copy your API key from the dashboard (starts with `sk_`)
3. Ask your agent to store it for you:

   > "My TranscriptAPI key is `sk_...` — store it so it persists across sessions."

Or set it yourself as an environment variable:

```bash
export TRANSCRIPT_API_KEY="sk_your_key_here"
```

</details>

<details>
<summary><strong>Where does the key get saved?</strong></summary>

Your agent stores the API key here (depends on the runtime):

| Location | File |
|----------|------|
| **OpenClaw/Moltbot** | `~/.openclaw/openclaw.json` or `~/.clawdbot/moltbot.json` |
| **Hermes Agent** | Hermes secret store (`TRANSCRIPT_API_KEY` declared via `required_environment_variables` in skill frontmatter) |
| **macOS shell** | `~/.zshenv`, `~/.zprofile` |
| **Linux shell** | `~/.profile`, `~/.bashrc`, `~/.zshenv` |
| **Fish shell** | `~/.config/fish/config.fish` |
| **Fallback** | `~/.transcriptapi` (mode 600) |

Your agent picks it up automatically after saving.

</details>

---

## Skills

`youtube-full` is the recommended skill for most users. It includes everything: transcripts, search, channels, playlists.

If you prefer smaller, focused skills (smaller context = better agent performance for specific tasks), pick what you need:

| Skill | What It Does | Install |
|-------|--------------|---------|
| **youtube-full** | Everything — transcripts, search, channels, playlists | `--skill youtube-full` |
| **transcript** | Get video transcripts with timestamps | `--skill transcript` |
| **youtube-search** | Search YouTube for videos and channels | `--skill youtube-search` |
| **youtube-channels** | Browse uploads, get latest videos, resolve @handles | `--skill youtube-channels` |
| **youtube-playlist** | Extract all videos from a playlist | `--skill youtube-playlist` |

```bash
# 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
```

<details>
<summary><strong>All 12 skills</strong></summary>

We ship 12 skills total. Many are narrower variants or aliases of the core 5 above — so your agent can find the right skill regardless of how you phrase your request.

| Skill | Description |
|-------|-------------|
| **youtube-full** | Complete YouTube toolkit — transcripts + search + channels + playlists |
| **transcript** | Extract transcript from any YouTube video with timestamps |
| **captions** | Get closed captions / CC from YouTube videos |
| **subtitles** | Extract subtitles from YouTube videos |
| **youtube-search** | Search YouTube for videos and channels |
| **youtube-channels** | Browse channel uploads, get latest videos, resolve @handles |
| **youtube-playlist** | Fetch all videos from a YouTube playlist |
| **youtube-data** | Get YouTube video and channel data (lightweight alternative to Google's API) |
| **youtube-api** | YouTube API access for AI agents — no Google quota hassle |
| **transcriptapi** | Full TranscriptAPI access with all endpoints |
| **video-transcript** | Convert YouTube videos to text transcripts |
| **yt** | Quick YouTube utility for fast lookups |

</details>

---

## Pricing

| Plan | Price | Credits | Rate Limit |
|------|-------|---------|------------|
| **Free** | $0 | 100 credits on signup | 300 req/min |
| **Starter** | $5/month | 1,000 credits/month | 300 req/min |
| **Starter Annual** | $54/year ($4.50/mo) | 1,000 credits/month | 300 req/min |

Most operations cost 1 credit. Channel resolve and latest are free. No credit card required for the free tier.

[View pricing →](https://transcriptapi.com)

---

## Supported Agents

Works with any AI agent that supports the [Agent Skills](https://skills.sh) format:

| Agent | Install Command |
|-------|----------------|
| 🦞 **[OpenClaw](https://www.clawhub.ai/therohitdas/youtube-full)** (ClawdBot/Moltbot) | `npx clawhub@latest install youtube-full` |
| <img src="assets/hermes.png" alt="" height="14"> **[Hermes Agent](https://hermes-agent.nousresearch.com)** | `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` |
| **Others** | Goose, AMP, Kiro, Roo, OpenCode, Gemini, GitHub Copilot... |

---

## FAQ

### How do I get a YouTube transcript?

Install `youtube-full` (or `transcript`) and ask your agent:

> "Get the transcript for this video: https://youtube.com/watch?v=VIDEO_ID"

The agent fetches the full transcript with timestamps. You can then ask it to summarize, translate, quote, or analyze the content.

### How do I search YouTube from my agent?

Install `youtube-full` (or `youtube-search`) and ask:

> "Find videos about machine learning"

Returns up to 50 results with titles, thumbnails, view counts, and publish dates.

### How do I get all videos from a YouTube channel?

Install `youtube-full` (or `youtube-channels`) and ask:

> "List all videos from the TED channel"

The agent resolves the @handle, fetches uploads (paginated, 100/page), and can then get transcripts for any or all of them.

### Can I bulk download YouTube transcripts?

Yes. Install `youtube-full` and ask:

> "Get transcripts for all videos in this playlist: [URL]"

The agent fetches the playlist, iterates through videos, and extracts each transcript.

### Do I need a Google YouTube Data API key?

No. TranscriptAPI replaces the Google YouTube Data API for transcript extraction, search, and channel/playlist operations. No Google Cloud project, no quota limits, no OAuth setup.

### Do I need an API key?

Yes, but signup is free and instant — 100 credits, no credit card required. Your agent handles the setup automatically on first run.

### Which skill should I install?

- **Want everything?** → `youtube-full` (recommended)
- **Just transcripts?** → `transcript`
- **Just search?** → `youtube-search`
- **Just channel data?** → `youtube-channels`
- **Just playlists?** → `youtube-playlist`

### What is TranscriptAPI?

[TranscriptAPI.com](https://transcriptapi.com) is a REST API and MCP server for YouTube data. It provides transcript extraction, video search, channel browsing, and playlist operations — built for developers and AI agents. Also available as an [MCP Server](https://github.com/ZeroPointRepo/youtube-mcp) for direct LLM integration (Claude, ChatGPT).

---

## Troubleshooting

Quick fixes for the issues users actually hit. Error codes come from the API itself, so your agent will usually report them verbatim.

| Symptom | Likely cause | Fix |
|---------|--------------|-----|
| `401 Unauthorized` | API key missing, mistyped, or not loaded into the environment | Confirm `TRANSCRIPT_API_KEY` is set in the shell your agent runs in and that the key starts with `sk_` |
| `402 Payment Required` | The account is out of credits | Check your balance at [transcriptapi.com/billing](https://transcriptapi.com/billing) |
| `403` with Cloudflare code `1010` | Request sent without a User-Agent header | Send your agent's name as the User-Agent, for example `HermesAgent/0.11.0` |
| `404 Not Found` | The video has no captions, is not public, or the ID is wrong | Verify the URL opens in a browser and the player shows captions there |
| `408 Request Timeout` | Temporary upstream pressure on the video | Transient by nature: retry once after a couple of seconds |
| `422 Validation Error` | A parameter is malformed, such as a bad channel or playlist reference | Channels accept `@handle`, a channel URL, or a `UC` ID; playlists accept `PL`, `UU`, `LL`, `FL`, and `OL` prefixes |
| `429 Too Many Requests` | Rate limit reached | Wait and respect the `Retry-After` header |

Three more cases worth knowing:

- **The key is saved but the agent cannot see it.** Shell config files load per shell type: check the table under "Where does the key get saved?" in the Setup section and make sure the file matches the shell your agent actually runs in. Restarting the agent after saving the key resolves most cases.
- **Live streams and premieres.** Transcripts become available after the stream ends and captions are processed, not while it is live.
- **Transcript comes back in an unexpected language.** Many videos only carry captions in their original language. Request the transcript with a preferred language parameter, or ask your agent to translate the result.

---

## Powered by TranscriptAPI

[TranscriptAPI.com](https://transcriptapi.com) — 15M+ transcripts/month, 99.9% uptime.

Also available: [MCP Server](https://github.com/ZeroPointRepo/youtube-mcp) for direct LLM integration with Claude and ChatGPT.

Full API docs: [transcriptapi.com/docs](https://transcriptapi.com/docs)

Listed in [awesome-hermes-skills](https://github.com/ZeroPointRepo/awesome-hermes-skills), our directory of Hermes Agent skills, plugins, agent profiles and memory providers.

## Disclosure

TranscriptAPI is an independent product and is not affiliated with or endorsed by YouTube or Google.

## Contributing

PRs welcome. See [CONTRIBUTING.md](CONTRIBUTING.md).

## License

MIT © [TranscriptAPI](https://transcriptapi.com)

© Zero Point Studio · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
youtube-transcript tubeagentkit Скилл youtube-transcript для Claude Code и Codex загружает субтитры, метаданные каналов и поисковую выдачу YouTube. Запускается при запросе на анализ или пересказ речи из видеоролика. CX Codex +1 ★ 41звёзд репо youtube-data ZeroPointRepo Скилл youtube-data для получения субтитров, метаданных роликов, списков видео и поиска на YouTube без Google API и OAuth через сервис TranscriptAPI. CX Codex +1 782установок youtube-full ZeroPointRepo Скилл youtube-full подключает поиск по YouTube, выгрузку субтитров и метаданных каналов через TranscriptAPI. Помогает извлекать текст лекций, обзоров и свежих роликов прямо в чат агента. CX Codex +1 2 400установок youtube-seo illyism Скилл youtube-seo для Claude Code превращает записи видео в заголовки, описания с таймкодами 00:00 и посты для соцсетей. CX Codex +1 404установок youtube Eugeniu Ghelbur Извлекает расшифровку, метаданные и популярные комментарии YouTube, затем сохраняет сводку в Obsidian. Флаг --visual добавляет анализ кадров. CX Codex +1 ★ 5 412звёзд репо youtube-notes Nick Nisi Скилл youtube-notes для Claude Code превращает субтитры YouTube в заметки по главам со ссылками на таймкоды. Подключается к ссылке на YouTube или просьбе разобрать видео. CX Codex +1 ★ 114звёзд репо

Из того же набора391

Весь набор →
maintaining-modding-environments Скилл maintaining-modding-environments помогает обновлять базы знаний, очищать кэш пакетов и обслуживать CLI переводчика xtl для моддинга игр Bethesda. CX Codex +1 ★ 1 596звёзд репо review Скилл review запускает проверку изменений несколькими агентами: в быстром режиме работают 5 агентов, а флаг --deep включает полный конвейер проверки. CX Codex +1 ★ 1 596звёзд репо codiris-agentizer Скилл codiris-agentizer разбирает сайт по страницам, выясняет, что компания продаёт, и собирает из Next.js-шаблона интерактивный agentfront под этот бизнес. CX Codex +1 ★ 1 596звёзд репо zotero-research-tools Плагин zotero-research-tools для Claude Code и Codex подключает Zotero Desktop через Zotero MCP: агент ищет и читает записи библиотеки, готовит цитаты и разбирает коллекции с тегами. CX Codex ★ 1 596звёзд репо yandex-direct-for-all Плагин yandex-direct-for-all для Claude Code и Codex связывает их с Яндекс Директом, Метрикой и Wordstat v2 через MCP-серверы. CX Codex ★ 1 596звёзд репо x-twitter-scraper Плагин x-twitter-scraper для Claude Code и Codex подключает их к данным X через Xquik. Ищет посты и профили; запросы требуют API-ключа. CX Codex ★ 1 596звёзд репо x-skills Плагин x-skills для Claude Code и Codex с 9 скиллами для маркетинга в X (Twitter): пишет твиты и треды, чистит текст от AI-маркеров, строит недельный контент-план. Каждый черновик ждёт одобрения перед публикацией. CX Codex ★ 1 596звёзд репо webly Плагин webly для Claude Code и Codex разворачивает локальные папки и файлы на публичный адрес без регистрации. С его помощью можно сразу показать черновик сайта заказчику или коллегам. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой