yt-search-download — скилл
Скилл для Claude Code ищет видео на YouTube, листает каналы и качает ролики, звук и субтитры через yt-dlp.
- 118 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скрипт запускает yt-dlp на вашем компьютере и пишет файлы в `~/Downloads`.
- При загрузке yt-dlp читает куки браузера, а запросы поиска уходят в YouTube Data API с вашим ключом.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/yt-search-downloadОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скрипт запускает yt-dlp на вашем компьютере и пишет файлы в `~/Downloads`.
- При загрузке yt-dlp читает куки браузера, а запросы поиска уходят в YouTube Data API с вашим ключом.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Агент получает таблицу результатов поиска по YouTube: название, дата, длительность, число просмотров. Поиск идет по ключевым словам или внутри канала, с сортировкой по дате, просмотрам и релевантности, с фильтрами по длительности и датам публикации. Данные приходят из YouTube Data API v3. Отобранные ролики скачивает yt-dlp: видео в качестве до 4K, одна звуковая дорожка в MP3 или субтитры. Субтитры сохраняются двумя файлами, SRT с таймкодами и TXT с теми же таймкодами, чтобы отдать текст модели на пересказ. Для отдельного видео есть запрос деталей: длительность, просмотры, описание.
Для кого. Редакторам и аналитикам, которые следят за каналами YouTube по теме: находят свежие выпуски, забирают звук подкаста или текст выступления.
Подходит, если
- Хочется увидеть последние выпуски канала и выбрать по просмотрам.
- Звук выпуска подкаста нужен в MP3 для прослушивания без сети.
- Субтитры лекции надо превратить в текст и отдать модели на конспект.
- Поиск по теме должен охватить только последние месяцы.
- Из канала требуется скачать несколько выпусков подряд.
Не подходит, если
- Достаточно транскрипта по ссылке: хватит MCP-сервера расшифровок, и файлы скачивать не придется.
- Ключа YouTube Data API нет и получить его негде.
- Компьютер общий, и yt-dlp не должен видеть куки вашего браузера.
- Права на копию ролика у вас нет, а правообладатель скачивание не разрешал.
Пример запроса к агенту
Покажи пять последних выпусков канала @lexfridman по просмотрам и скачай субтитры самого популярного.Ограничения
Скрипт скилла без ключа YouTube Data API v3 не стартует: ключ кладут в `YT_BROWSE_API_KEY` или `YOUTUBE_API_KEY`. Скачивание требует установленный `yt-dlp`. При загрузке yt-dlp берет куки Chrome, Firefox или Safari, поэтому получает доступ к вашей сессии в браузере. Скачивание роликов может противоречить условиям YouTube и авторскому праву. Инструкция просит агента дописывать к английским заголовкам китайский перевод. Последний коммит в репозитории сделан в марте 2026 года.
Как отключить. Удалите папку скилла `~/.claude/skills/yt-search-download` и переменную с ключом из `~/.zshrc`. Скачанные файлы лежат в `~/Downloads` или в папке из `--dir` и удаляются отдельно.
Частые вопросы
Как поставить yt-search-download в Claude Code?
Выполните `npx skills add joeseesun/yt-search-download`. Затем задайте ключ YouTube Data API v3 в `YT_BROWSE_API_KEY` и поставьте `yt-dlp`, например `brew install yt-dlp` на macOS.
Нужен ли ключ API, если я только качаю ролики?
Да, скрипт без ключа не запускается ни для одной команды. Ключ создают в Google Cloud Console, включив YouTube Data API v3.
Какие файлы получаются при загрузке субтитров?
Два файла: `.srt` с таймкодами и `.txt` с теми же таймкодами для пересказа моделью. Английские субтитры берутся первыми, при их отсутствии берутся автоматические.
Как отсортировать выдачу по просмотрам?
Добавьте `-o viewCount`, и сортировку выполнит API. Для локальной сортировки есть `--sort-by views`, а длительность отсекают флагами `--min-duration` и `--max-duration`.
Куда попадают скачанные файлы?
В `~/Downloads`. Другую папку задает `--dir`, качество видео выбирает `-q 1080p`, а флаг `--audio-only` оставляет только MP3.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыДвенадцать скиллов учат агента читать YouTube через сервис TranscriptOut: транскрипты, поиск и каналы одним HTTPS-запросом
yt-fts скачивает субтитры каналов и плейлистов YouTube в базу SQLite и ищет по ним фразы с ссылками на нужную секунду, есть смысловой поиск и чат
Скилл для Claude Code: скачивает видео YouTube, делит на смысловые главы, вырезает выбранные фрагменты, переводит субтитры и вшивает двуязычные в ролик
YouTube Skills
YouTube Skills for AI Agents
Набор скиллов дает агенту транскрипты видео YouTube, поиск роликов и каналов и разбор плейлистов через один API
Скилл /watch: по ссылке или файлу достает кадры и субтитры, а при ключе Gemini передает видео целиком Google, чтобы агент отвечал на вопросы по ролику
watch-cli, скилл и CLI, дает агенту кадры и расшифровку любого соцвидео, чтобы тот разобрал ролик сам.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| yt-search-download (эта карточка) | нет | 118 | |
| YouTube Skills | нет | 1 172 | отдает транскрипты, поиск и плейлисты через один сторонний API; yt-search-download ищет по ключу YouTube Data API и скачивает файлы через yt-dlp |
| YouTube Clipper Skill | нет | 2 284 | режет видео на смысловые главы и вшивает двуязычные субтитры; yt-search-download остается на поиске, загрузке и файлах субтитров |
Коротко о README
Репозиторий состоит из инструкции SKILL.md и скрипта `scripts/yt_search.py`. README на китайском: примеры запросов, типовые сценарии и таблица параметров поиска.
Бейдж для README
Исходный SKILL.md
--- name: yt-search-download description: | YouTube 视频搜索、下载视频、下载字幕工具。结合 YouTube Data API v3 进行高级搜索，yt-dlp 下载视频/音频/字幕。 核心能力：全站关键词搜索、频道浏览、按时间/播放量/相关度排序、下载视频、提取音频（MP3）、下载字幕（中英文）、查看视频详情。 触发场景（任何涉及 YouTube 的操作都应使用此 skill）： - 搜索类："搜索YouTube"、"YouTube搜索"、"找YouTube视频"、"搜索[频道名]最新视频"、"查找[人名]的YouTube"、"[人名]最近更新的YouTube"、"YouTube上有什么关于XXX的" - 频道浏览类："浏览频道"、"看看[频道名]最新视频"、"[人名]最近发了什么视频"、"[人名]YouTube更新"、"查看[频道名]的视频列表" - 下载视频类："下载YouTube"、"下载这个视频"、"下载YouTube视频"、"把这个视频下载下来"、"保存视频" - 下载音频类："提取音频"、"下载音频"、"YouTube转MP3"、"只要音频" - 下载字幕类："下载字幕"、"提取字幕"、"获取字幕"、"下载YouTube字幕"、"中文字幕"、"英文字幕"、"提取文字"、"视频转文字"、"获取视频文本" - 视频信息类："视频详情"、"视频信息"、"这个视频多长" 关键词匹配：只要用户消息中出现 "YouTube"、"油管"、"YT"、"yt" 加上搜索/下载/字幕/频道/视频等动作词，就应触发此 skill。 --- # YouTube 搜索 & 下载 基于 YouTube Data API v3 进行高级搜索，配合 yt-dlp 下载。 ## 前置条件 1. **YouTube API Key**： ```bash echo $YT_BROWSE_API_KEY ``` 如果为空：[Google Cloud Console](https://console.cloud.google.com/) → 启用 YouTube Data API v3 → 创建 API Key → 写入 `~/.zshrc`： ```bash export YT_BROWSE_API_KEY=your_key ``` 2. **yt-dlp**（下载用）： ```bash brew install yt-dlp # macOS pip install yt-dlp # 或 pip 安装 ``` ## 命令说明 脚本路径：`~/.claude/skills/yt-search-download/scripts/yt_search.py` ### 全站关键词搜索 ```bash python3 scripts/yt_search.py search "关键词" -n 20 ```