YouTube MCP (Zubeid)
Zubeid YouTube MCP Server
YouTube MCP на ключе Data API: агент ищет видео и каналы с фильтром по числу подписчиков, читает плейлисты, статистику и расшифровки
- 588 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Каждый запрос расходует дневную квоту ключей YouTube Data API вашего проекта в Google Cloud
- Ответы по каналам включают найденные адреса почты и ссылки для связи: это публичные, но контактные данные людей
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/zubeid-youtube-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Каждый запрос расходует дневную квоту ключей YouTube Data API вашего проекта в Google Cloud
- Ответы по каналам включают найденные адреса почты и ссылки для связи: это публичные, но контактные данные людей
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
YouTube MCP от автора Zubeid Hendricks дает агенту десять инструментов чтения по данным YouTube. Сервер ставится как npm-пакет `zubeid-youtube-mcp-server` и запускается командой `npx -y zubeid-youtube-mcp-server`. Ему нужен хотя бы один ключ YouTube Data API в переменных `YOUTUBE_API_KEY`, `YOUTUBE_API_KEY2` или `YOUTUBE_API_KEY3`. Когда у ключа заканчивается квота, сервер повторяет запрос со следующим. Для видео есть `videos_getVideo` и `videos_searchVideos` с фильтрами по дате, каналу и числу подписчиков канала. Для каналов — `channels_getChannel`, `channels_getChannels`, `channels_searchChannels` и `channels_listVideos`. Инструмент `channels_findCreators` находит каналы по упоминаниям в видео и отбирает их по размеру аудитории, дате последней загрузки и эвристике «автор или бренд». Для плейлистов есть `playlists_getPlaylist` и `playlists_getPlaylistItems`. Расшифровку видео отдает `transcripts_getTranscript`, язык берется из параметра или из `YOUTUBE_TRANSCRIPT_LANG`, по умолчанию английский. В ответе по каналу появляются дата последней загрузки и нормализованные данные: страна, язык по умолчанию, дата создания, найденные адреса почты и ссылки для связи. Образ Docker поднимает тот же сервер по HTTP на порту 8088.
Для кого. Для маркетологов, продюсеров и исследователей, которые через Claude Desktop или VS Code ищут на YouTube видео, авторов для сотрудничества и расшифровки для конспектов, и для разработчиков, которым нужен простой сервер на ключе Data API.
Подходит, если
- Нужно найти небольшие каналы по теме и отобрать их по числу подписчиков и дате последней загрузки
- Агент должен собрать статистику по видео, каналу или плейлисту и свести ее в таблицу
- Расшифровку ролика надо получить на нужном языке для краткого пересказа или конспекта
- Для поиска видео нужны фильтры: дата публикации, канал, диапазон подписчиков канала
- Сервер надо поднять как HTTP-сервис в контейнере и подключать к нему клиентов по адресу /mcp
Не подходит, если
- Нужно загружать видео, создавать Shorts или смотреть аналитику своего канала: все десять инструментов только читают общедоступные данные
- Нет ключа YouTube Data API и нет желания его получать: без ключа работает только расшифровка
- Нужны только расшифровки: для этого есть запись youtube-transcript-mcp-server, она проще и ключа не просит
- Нужен ответ, сжатый по токенам, с кешем запросов: такие свойства описаны в записи youtube-data-mcp-server-kirbah
Пример запроса к агенту
Найди видео про домашнюю кофейню за последние три месяца, оставь каналы до 50 тысяч подписчиков и пришли таблицу с названиями, просмотрами и датой последней загрузкиMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
YOUTUBE_API_KEYобязательная, секрет- Основной ключ YouTube Data API
YOUTUBE_API_KEY2секрет- Запасной ключ на случай исчерпанной квоты
YOUTUBE_API_KEY3секрет- Третий запасной ключ
YOUTUBE_TRANSCRIPT_LANG- Язык расшифровок по умолчанию, по умолчанию en
Ограничения
- Сервер неофициальный: YouTube и Google его не выпускали.
- Квоту ключа Data API сервер расходует на каждый запрос, кроме расшифровок. Для этого он держит до трех ключей и переходит к следующему, когда у текущего квота кончилась.
- Признак `creatorOnly` опирается на эвристику, а не на данные YouTube, поэтому отбор авторов может ошибаться.
- Сборка образа Docker копирует файл `.env` в итоговый образ, и ключи остаются внутри него. Такой образ нельзя публиковать.
- Образ слушает `0.0.0.0:8088` по HTTP без состояния, а проверку доступа к адресу `/mcp` документация не описывает.
- Расшифровки по умолчанию запрашиваются на английском: другой язык задают параметром `language` или переменной `YOUTUBE_TRANSCRIPT_LANG`.
- Лицензия MIT.
Как отключить. Удалите запись youtube из конфигурации клиента и перезапустите приложение. Если ключи больше не нужны, отключите их или удалите в Google Cloud Console, в разделе учетных данных проекта.
Частые вопросы
Как подключить YouTube MCP к Claude Desktop?
В файл `claude_desktop_config.json` добавьте в `mcpServers` запись с командой `npx`, аргументами `-y` и `zubeid-youtube-mcp-server` и переменной `YOUTUBE_API_KEY` с вашим ключом. Для установки без ручной правки автор предлагает команду `npx -y @smithery/cli install @ZubeidHendricks/youtube --client claude`.
Что умеет YouTube MCP: только читать или еще загружать видео?
Только читать. Десять инструментов ищут и описывают видео, каналы и плейлисты и отдают расшифровки. Загрузки видео, создания Shorts и аналитики канала среди них нет.
Нужен ли ключ, чтобы получить расшифровку видео?
Для расшифровок сервер использует пакет `youtube-transcript`, и код этого инструмента ключ не проверяет. Остальным инструментам нужен хотя бы один ключ YouTube Data API.
Что будет, когда у ключа закончилась квота?
Сервер повторит тот же запрос со следующим ключом из `YOUTUBE_API_KEY2` и `YOUTUBE_API_KEY3`. Если все три исчерпаны, запрос завершится ошибкой, пока квота не обновится.
Как найти авторов на YouTube для сотрудничества через MCP?
Вызовите `channels_findCreators` с темой или упоминанием, задайте границы подписчиков `channelMinSubscribers` и `channelMaxSubscribers` и дату последней загрузки. Параметр `sampleVideosPerChannel` покажет примеры подходящих видео, а `creatorOnly` оставит каналы, которые сервер счел авторскими.
Как запустить сервер по HTTP?
Соберите образ командой `docker build -t youtube-mcp-server .` и запустите `docker run --rm -p 8088:8088 youtube-mcp-server`. Сервер отвечает по адресу `http://localhost:8088/mcp`, а готовность проверяет адрес `/ready`. Ключи берутся из файла `.env`, который был при сборке.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыYouTube Data MCP (kirbah)
YouTube Data MCP Server (kirbah)
YouTube MCP с урезанными ответами: расшифровки без ключа, статистика видео и каналов, тренды, комментарии, кеш в MongoDB и поиск растущих каналов
MCP сервер для расшифровки YouTube: агент получает транскрипт видео по ссылке, с таймкодами и метаданными
yutu управляет YouTube-каналом из терминала: видео, плейлисты, комментарии, субтитры. Есть MCP-сервер, встроенный агент и скилл для Claude Code и Codex
Claude Video Vision
claude-video-vision
MCP-сервер и плагин Claude Code, которые дают агенту смотреть видео: кадры через ffmpeg и расшифровка звука через Gemini, локальный Whisper или OpenAI
MCP Music Forge: загрузка и обработка треков
MCP Music Forge
MCP-сервер с очередью на Redis: скачивает треки с SoundCloud, YouTube, Яндекс Музыки и Spotify, конвертирует и проставляет теги с обложкой
MCP-сервер Яндекс Музыки с анализом жанров
Yandex Music MCP Server
Неофициальный MCP-сервер Яндекс Музыки: лайки, жанровый анализ, поиск и управление плейлистами по HTTP или stdio
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| YouTube MCP (Zubeid) (эта запись) | нет | API-ключ | 588 | |
| YouTube Data MCP (kirbah) | нет | ключ необязателен | 32 | другой сервер на Data API: ответы сжаты по токенам, есть кеш в MongoDB, тренды, комментарии и поиск каналов-выбросов |
| YouTube Transcript MCP Server | нет | не нужна | 491 | только расшифровки по ссылке: простой текст, вариант с таймкодами, метаданные и список языков, без ключа YouTube |
| yutu | нет | 702 | консольная программа для управления своим каналом: видео, плейлисты, комментарии и субтитры, с MCP-сервером |
Коротко о README
Документация открывается таблицей десяти инструментов с обязательными и необязательными параметрами и подробным описанием каждого. Дальше идут установка глобальным пакетом, через `npx` и Smithery, список переменных окружения, настройка для VS Code с запросом ключа при запуске, команды разработки и запуск в Docker с адресами `/mcp` и `/ready`. В репозитории есть дымовой тест, файл `llms.txt`, пример `.mcp.json`, конфигурация для Smithery и страница проекта.