YouTube Data MCP (kirbah)

Установка

Работает в

• Claude Desktop
• Cursor
• SourceCraft
• Koda
• Coddy

npx skillfoxx add mcp/youtube-data-mcp-server-kirbah

Что делает

YouTube MCP от автора kirbah отдает агенту данные YouTube в урезанном виде: без вложенных eTag, дублей миниатюр и локализаций, которые не нужны модели. Сравнения сырых и сжатых ответов лежат в папке `examples/comparisons`. Сервер ставится как npm-пакет `@kirbah/mcp-youtube` и запускается через `npx` по stdio. Без настройки он уже отдает расшифровки, а ключ YouTube Data API v3 в переменной `YOUTUBE_API_KEY` открывает остальное. Инструментов девять. `getVideoDetails` и `getChannelStatistics` возвращают метаданные, статистику и соотношения вовлеченности для нескольких видео или каналов сразу. `searchVideos` ищет видео и каналы с фильтрами, `getChannelTopVideos` показывает лучшие ролики канала, `getTrendingVideos` и `getVideoCategories` работают по региону и категории, `getVideoComments` читает комментарии с ограничением числа и ответов. `getTranscripts` отдает расшифровки нескольких видео целиком или ключевыми фрагментами начала и конца. Расшифровку одного видео можно открыть и как ресурс `youtube://transcript/{videoId}`. Девятый инструмент, `findConsistentOutlierChannels`, ищет каналы, чьи видео стабильно набирают больше просмотров, чем у них подписчиков. Он проходит четыре этапа: поиск кандидатов, фильтрация по возрасту канала, расчет «вирусного фактора» последних видео и ранжирование. Ему нужна MongoDB. Она же по желанию кеширует остальные ответы, чтобы повторный запрос не тратил квоту. Для разбора ниши есть готовый промпт `analyze-niche`.

Для кого. Для авторов каналов, маркетологов и аналитиков, которые через Claude Desktop, Cursor или другой клиент MCP изучают ниши YouTube, сравнивают каналы и разбирают комментарии и расшифровки, и для тех, кто бережет контекст модели и квоту ключа.

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

Возьми расшифровки трех этих роликов, сведи основные тезисы и покажи, какие из них набрали больше всего комментариев

MCP

Транспорт

stdio

Авторизация

ключ необязателен

Ограничения

• Сервер неофициальный: YouTube и Google его не выпускали.
• Квота Data API по умолчанию равна 10 000 единиц в сутки. `getVideoDetails`, `getChannelStatistics` и `getTrendingVideos` стоят по единице за вызов, `getVideoComments` добавляет еще единицу за каждый комментарий верхнего уровня, у которого запрошены ответы. `searchVideos` стоит 100 единиц, `getChannelTopVideos` 101, `getTranscripts` ничего не стоит.
• Без ключа сервер отдает только расшифровки, а `findConsistentOutlierChannels` недоступен без строки подключения MongoDB.
• По умолчанию `getTranscripts` возвращает ключевые фрагменты начала и конца, а полный текст запрашивается параметром `format` со значением `full_text`.
• В описании инструмента поиска выбросов параметры названы по-разному в таблице и в разборе, поэтому точный набор полей сверяйте со схемой в `src/tools`.
• Пользователям Windows, у которых `npx` не запускается, документация советует команду `cmd` с аргументами `/k`, `npx`, `-y`.
• Лицензия MIT.

Как отключить. Удалите запись youtube из конфигурации клиента и перезапустите приложение. Ключ Data API при ненадобности удалите в Google Cloud Console, а кеш лежит в вашей MongoDB и стирается вместе с ее базой.

Коротко о README

Документация начинается со сравнения расхода токенов на сырых и сжатых ответах и объяснения кеша, затем идут установка без ключа и с ключом, список девяти инструментов с параметрами и стоимостью в квоте, подробный разбор поиска каналов-выбросов, получение ключа Data API и требования к системе. В репозитории есть тесты с покрытием, примеры сырых и сжатых ответов, конфигурация CI и публикации, файл AGENTS.md и ссылка на скилл CreatorLens, который строит на этих данных рекомендации для канала.