YouTube MCP (Zubeid)

Zubeid YouTube MCP Server

YouTube MCP на ключе Data API: агент ищет видео и каналы с фильтром по числу подписчиков, читает плейлисты, статистику и расшифровки

  • 588 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Каждый запрос расходует дневную квоту ключей YouTube Data API вашего проекта в Google Cloud
  • Ответы по каналам включают найденные адреса почты и ссылки для связи: это публичные, но контактные данные людей
Все причины и проверки

zubeidhendricks/youtube-mcp-server

Установка

В терминале, через 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-серверРасширенный доступ32Звезды репозитория

MCP сервер для расшифровки YouTube: агент получает транскрипт видео по ссылке, с таймкодами и метаданными

MCP-серверРасширенный доступ491Звезды репозитория

yutu управляет YouTube-каналом из терминала: видео, плейлисты, комментарии, субтитры. Есть MCP-сервер, встроенный агент и скилл для Claude Code и Codex

CLIШирокий доступ702Звезды репозитория

Claude Video Vision

claude-video-vision

MCP-сервер и плагин Claude Code, которые дают агенту смотреть видео: кадры через ffmpeg и расшифровка звука через Gemini, локальный Whisper или OpenAI

MCP-серверРасширенный доступ1,4 тыс.Звезды репозитория
Российский стек

MCP-сервер с очередью на Redis: скачивает треки с SoundCloud, YouTube, Яндекс Музыки и Spotify, конвертирует и проставляет теги с обложкой

MCP-серверРасширенный доступ5Звезды репозитория
Российский стек

Неофициальный MCP-сервер Яндекс Музыки: лайки, жанровый анализ, поиск и управление плейлистами по HTTP или stdio

MCP-серверРасширенный доступ2Звезды репозитория

Сравнение с похожими

Записи с тем же главным запросом: чем они отличаются.

ЗаписьОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
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 и страница проекта.

Бейдж для README

Сообщить о проблеме

Foxx AIYouTube MCP (Zubeid)
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.