YouTube Skills
Двенадцать скиллов учат агента читать YouTube через сервис TranscriptOut: транскрипты, поиск и каналы одним HTTPS-запросом
- 343 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Ссылки на видео и запросы уходят во внешний сервис TranscriptOut по вашему ключу API
- Ключ API сохраняется в файле оболочки или в конфиге агента, и агент создает аккаунт по вашей почте
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/youtube-skillsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Ссылки на видео и запросы уходят во внешний сервис TranscriptOut по вашему ключу API
- Ключ API сохраняется в файле оболочки или в конфиге агента, и агент создает аккаунт по вашей почте
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скиллы учат агента читать YouTube без загрузчиков видео, браузера без интерфейса и проекта в Google Cloud. Каждый называет свой эндпоинт, показывает точный запрос, перечисляет параметры с умолчаниями и пределами и сопоставляет каждый код ошибки с действием. Ответ на запрос — один HTTPS-вызов к сервису TranscriptOut. Агент получает транскрипт, цитаты и субтитры в SRT или VTT. Он ищет по YouTube и внутри канала, смотрит свежие ролики и весь каталог загрузок, читает плейлисты и выгружает видео пакетом. Скилл youtube-full покрывает все сразу, а transcript, youtube-search, youtube-channels и youtube-playlist ставятся по одному, чтобы не тащить в контекст лишнюю документацию. Остальные семь скиллов отвечают тем же задачам под другие формулировки запроса: субтитры, видео в текст, данные YouTube. Для пакетной работы агент собирает идентификаторы с параметром ids_only, затем отправляет весь список одним запросом пакетного задания и читает результаты по страницам, пока оно идет. Параметр segment режет текст на куски от 20 до 5000 знаков, а границы берутся из пословных таймкодов, так что фрагменты годятся для индекса RAG.
Для кого. Для разработчиков, контент-менеджеров и исследователей, которым агент должен пересказать выступления, лекции и каналы YouTube без просмотра целиком.
Подходит, если
- Нужно понять, что утверждает часовое выступление, и вытащить три сильные цитаты
- Требуется файл субтитров SRT или VTT с таймкодами для готового видео
- Из лекционного курса в плейлисте надо собрать конспект: агент берет все видео плейлиста
- Нужна выгрузка транскриптов всего канала для индекса поиска одним заданием
- Надо проверить, что нового на канале за неделю, и найти все ролики с упоминанием Postgres
Не подходит, если
- Нужно загрузить свои субтитры на YouTube или управлять аккаунтом: скиллы только читают
- Нельзя отправлять ссылки на видео сторонним сервисам: запросы идут в API TranscriptOut
- Нужен бесплатный безлимитный доступ: бесплатный аккаунт дает 100 кредитов однократно
- У видео нет субтитров: сервис подтверждает их отсутствие, и кредит все равно списывается
Пример запроса к агенту
О чем это выступление и что оно утверждает? https://www.youtube.com/watch?v=dQw4w9WgXcQОграничения
Скиллы работают через платный сервис TranscriptOut и требуют ключ API, начинающийся с sk_. Бесплатный аккаунт дает 100 кредитов один раз без карты. Тариф Starter стоит 4,49 доллара в месяц за 1000 кредитов, Scale растет до 100 000 кредитов в месяц. Один кредит — один отвеченный запрос: транскрипт стоит 1, страница поиска 1, пакетная задача 1 за видео, а чтение хода и результатов задачи бесплатно. Предел частоты — 200 запросов в минуту на ключ.
Запрос, который не дошел до YouTube из-за ошибки параметра, лимита или занятости сервиса, возвращает кредит сам. Подтвержденное «у видео нет субтитров» кредит списывает. Регистрация проходит прямо в чате по шестизначному коду из письма.
Как отключить. Удалите папку нужного скилла из ~/.claude/skills или из .claude/skills проекта. Ключ лежит в переменной TRANSCRIPTOUT_API_KEY в файле оболочки или в конфиге агента, а запасной вариант — файл ~/.transcriptout. Удалите его там и отзовите ключ в личном кабинете TranscriptOut.
Частые вопросы
Как получить транскрипт YouTube в Claude Code?
Выполните npx skills add artemchuikin/youtube-skills --skill youtube-full и попросите агента прочитать видео по ссылке. При первом запуске он предложит создать ключ: попросит почту, пришлет на нее шестизначный код и после подтверждения сохранит ключ сам.
Какой скилл выбрать, если нужен только транскрипт?
Скилл transcript: --skill transcript. youtube-full содержит все, но агент тащит в контекст документацию по каналам и плейлистам. Узкие скиллы, например youtube-search и youtube-channels, ставятся вместе: каждый следующий флаг --skill добавляет еще один.
Сколько видео можно выгрузить за раз?
Одно задание принимает до 4000 видео в одном запросе POST /v1/transcripts. Идентификаторы собирают с `ids_only=true`, до 500 на страницу. Дубликаты убираются до списания, ключ Idempotency-Key делает повторы бесплатными, а видео, которое сервис не доставил, возвращает кредит.
Как нарезать транскрипты для поиска и RAG?
Передайте `segment` со значением от 20 до 5000 знаков. Для индекса подходят 500–1500. Границы берутся из пословных таймкодов в сырых данных srv3, поэтому метка начала каждого куска совпадает с моментом, когда слова произнесены. Формат json с `segment=1000` сразу идет в эмбеддинги.
Работает ли скилл в Hermes Agent и OpenClaw?
Да. Для Hermes: hermes skills install skills-sh/artemchuikin/youtube-skills/skills/youtube-full, ключ хранится в секретах Hermes. Для OpenClaw скопируйте папку из репозитория в папку скиллов OpenClaw: там те же двенадцать скиллов с примерами для bash. В Codex есть манифест .codex-plugin.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыYouTube Skills
YouTube Skills for AI Agents
Набор скиллов дает агенту транскрипты видео YouTube, поиск роликов и каналов и разбор плейлистов через один API
Скилл для Claude Code: скачивает видео YouTube, делит на смысловые главы, вырезает выбранные фрагменты, переводит субтитры и вшивает двуязычные в ролик
MCP-сервер отдает агенту расшифровку видео YouTube по ссылке, с выбором языка, таймкодами и вырезанной рекламой
yt-fts скачивает субтитры каналов и плейлистов YouTube в базу SQLite и ищет по ним фразы с ссылками на нужную секунду, есть смысловой поиск и чат
Скилл /watch: по ссылке или файлу достает кадры и субтитры, а при ключе Gemini передает видео целиком Google, чтобы агент отвечал на вопросы по ролику
yutu управляет YouTube-каналом из терминала: видео, плейлисты, комментарии, субтитры. Есть MCP-сервер, встроенный агент и скилл для Claude Code и Codex
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| YouTube Skills (эта запись) | нет | 343 | ||
| YouTube Transcript MCP Server | нет | не нужна | 494 | MCP-сервер, который отдает транскрипт одного видео по ссылке; каналов, плейлистов и пакетной выгрузки нет |
| YouTube Clipper Skill | нет | 2 266 | скачивает видео и режет его на смысловые главы, а транскрипты каналов и поиск не покрывает |
Коротко о README
Проект сделан авторами сервиса TranscriptOut, рядом лежат ссылки на документацию API и их MCP-сервер. Главная таблица сопоставляет фразы вроде «о чем это видео» с нужным скиллом, а раздел вопросов разбирает выгрузку транскриптов.
Бейдж для README
Исходный SKILL.md
---
name: captions
description: "Reach for this when caption text from a YouTube video is wanted: reading a video instead of watching it, quoting or translating speech, accessibility (deaf/HoH) needs, content review, language practice, or exporting CC as SRT/VTT files. Timestamped captions from any public video. Skip it for uploading captions or account chores."
version: "1.1.0"
user-invocable: true
compatibility: Requires internet access to reach api.transcriptout.com. No additional runtimes or dependencies needed.
required_environment_variables:
- name: TRANSCRIPTOUT_API_KEY
prompt: Your TranscriptOut API key (starts with sk_)
help: Free account at https://transcriptout.com/?utm_source=youtube-skills&utm_medium=clawhub&utm_content=captions (100 credits on signup, no card). Create the key in the dashboard.
required_for: all API requests
metadata: {"openclaw":{"emoji":"💬","requires":{"env":["TRANSCRIPTOUT_API_KEY"]},"primaryEnv":"TRANSCRIPTOUT_API_KEY","homepage":"https://transcriptout.com"},"hermes":{"tags":["youtube","captions","cc","subtitles","accessibility","video"],"category":"media"}}
---
# Captions
Extract closed captions from YouTube videos via [TranscriptOut.com](https://transcriptout.com/?utm_source=youtube-skills&utm_medium=clawhub&utm_content=captions).
## Setup
If `$TRANSCRIPTOUT_API_KEY` is not set, read [references/auth-setup.md](references/auth-setup.md) and follow the instructions there to get and store the key.
## Required Header
Every request carries these headers:
- **Authorization:** `Bearer $TRANSCRIPTOUT_API_KEY`
- **X-Client:** `youtube-skills-clawhub/captions`, so TranscriptOut knows the call came from this skill
Every response is one JSON envelope. Success: `{"ok": true, "request_id": "...", "data": {...}}`. Error: `{"ok": false, "code": "...", "detail": "...", "request_id": "..."}`. Branch on the machine-readable `code`, not on the human text. The remaining credit balance rides in the `X-Credits-Remaining` response header.
## GET /v1/transcript · 1 credit
Fetch the closed captions of any YouTube video: timed JSON segments, plain text, or ready-made `SRT`/`VTT` files.
```bash
# SRT body inside the JSON envelope
curl -s "https://api.transcriptout.com/v1/transcript?video=VIDEO_URL_OR_ID&format=srt" \
-H "Authorization: Bearer $TRANSCRIPTOUT_API_KEY" \
-H "X-Client: youtube-skills-clawhub/captions"