YouTube MCP Server

MCP-сервер, который подключает YouTube к Claude Code, — транскрипты видео, поиск, метаданные, информация о каналах, плейлисты, комментарии, трендовые видео, аналитика вовлечённости, извлечение глав, интеграция со SponsorBlock и тепловые карты самых пересматриваемых моментов. Использует YouTube Data API v3, youtube-transcript и SponsorBlock.

Быстрый старт

Шаг 1: Получите API-ключ

1. Перейдите в Google Cloud Console

2. Создайте проект (или выберите существующий)

3. Включите YouTube Data API v3:

   • Перейдите в API Library

   • Нажмите Enable

4. Создайте API-ключ:

   • Перейдите в Credentials

   • Нажмите Create Credentials > API key

5. Скопируйте ключ (он понадобится на шаге 3)

Шаг 2: Установите предварительные требования

• Node.js 18+ — Скачать здесь

• Claude Code CLI — Руководство по установке

Шаг 3: Установите MCP-сервер

3.1 Клонируйте репозиторий

git clone https://github.com/wynandw87/claude-code-youtube-mcp.git
cd claude-code-youtube-mcp

3.2 Установите зависимости

macOS / Linux / Windows:

npm install

Примечание: зависимости устанавливаются, а сервер собирается автоматически одним шагом.

3.3 Зарегистрируйте сервер в Claude Code

Выберите область установки:

Замените YOUR_API_KEY на ваш реальный API-ключ YouTube Data API и используйте полный путь к dist/index.js.

Совет: чтобы получить полный путь, выполните это из клонированной директории:

• macOS/Linux: echo "$(pwd)/dist/index.js"

• Windows: echo %cd%\dist\index.js

macOS / Linux:

claude mcp add -s user youtube -e YOUTUBE_API_KEY=YOUR_API_KEY -- node /full/path/to/dist/index.js

Windows (CMD):

claude mcp add -s user youtube -e "YOUTUBE_API_KEY=YOUR_API_KEY" -- node "C:\full\path\to\dist\index.js"

Windows (PowerShell):

claude mcp add -s user youtube -e "YOUTUBE_API_KEY=YOUR_API_KEY" '--' node "C:\full\path\to\dist\index.js"

Альтернатива: используйте npm-хелпер (если API-ключ задан в окружении)

export YOUTUBE_API_KEY=YOUR_API_KEY
npm run install:claude

Шаг 4: Перезапустите Claude Code

Закройте и снова откройте Claude Code, чтобы изменения вступили в силу.

Шаг 5: Проверьте установку

claude mcp list

Вы должны увидеть youtube в списке со статусом Connected.

Related MCP server: YouTube Insights MCP Server

Возможности

Транскрипты и субтитры

• Get Transcript (get_transcript) — получает полные транскрипты видео с временными метками, поддерживает несколько языков

• Search Transcript (search_transcript) — находит, где в видео встречается ключевое слово или фраза, с временными метками

• Clean Transcript (get_clean_transcript) — транскрипт без спонсорских вставок, интро, аутро и слов-паразитов с помощью SponsorBlock

• Extract Chapters (extract_chapters) — извлекает временные метки глав из описания видео

Поиск и обнаружение контента

• Search Videos (search_videos) — полноценный поиск по YouTube с фильтрами по дате, длительности, типу и порядку сортировки

• Search Within Channel (search_within_channel) — поиск видео конкретного автора

• Get Trending Videos (get_trending_videos) — текущие трендовые видео по региону и категории

• Get Channel Videos (get_channel_videos) — недавние загрузки с канала, отсортированные по дате или просмотрам

Информация о видео и канале

• Video Metadata (get_video_metadata) — название, описание, длительность, просмотры, лайки, теги и многое другое

• Channel Info (get_channel_info) — количество подписчиков, количество видео, описание, страна

• Playlist Items (get_playlist_items) — все видео в плейлисте с позициями и метаданными

Аналитика и вовлечённость

• Calculate Engagement (calculate_engagement) — коэффициент лайков, коэффициент комментариев и коэффициент вовлечённости на основе публичной статистики

• Most Replayed (get_most_replayed) — данные тепловой карты, показывающие, какие фрагменты зрители пересматривают чаще всего

• Video Comments (get_video_comments) — лучшие комментарии с количеством лайков и ответов

Утилиты

• Parse YouTube URL (parse_youtube_url) — извлекает ID видео, канала или плейлиста из URL YouTube любого формата

Использование

После установки используйте триггерные фразы для вызова инструментов YouTube:

Или просто спросите:

• "Получи транскрипт этого видео YouTube и сделай краткое изложение"

• "Какие части этого видео пересматривают чаще всего?"

• "Найди недавние видео о TypeScript на этом канале"

• "Сколько просмотров и лайков у этого видео?"

• "Получи комментарии к этому видео и резюмируй тональность"

• "Покажи главы этого руководства"

• "Получи чистый транскрипт без спонсорских вставок"

• "Что сейчас в тренде на YouTube в игровой категории?"

Справочник инструментов

parse_youtube_url

Разбирает URL YouTube любого формата и извлекает идентификаторы. API-ключ не требуется.

Параметры:

• url (string, обязательный) — любой URL YouTube или ID видео

Поддерживаемые форматы: youtube.com/watch?v=, youtu.be/, /shorts/, /embed/, /playlist?list=, /channel/, /@handle, /c/, /user/, отдельные ID видео

get_transcript

Получает полный транскрипт/субтитры видео YouTube. API-ключ не требуется.

Параметры:

• url (string, обязательный) — URL видео YouTube или ID видео

• lang (string, необязательный) — код языка субтитров (по умолчанию: "en")

search_transcript

Ищет ключевое слово или фразу в транскрипте видео.

Параметры:

• url (string, обязательный) — URL видео YouTube или ID видео

• query (string, обязательный) — ключевое слово или фраза для поиска

• lang (string, необязательный) — код языка субтитров (по умолчанию: "en")

extract_chapters

Извлекает временные метки глав из описания видео.

Параметры:

• url (string, обязательный) — URL видео YouTube или ID видео

get_clean_transcript

Получает транскрипт без спонсорских вставок, интро, аутро и слов-паразитов с помощью SponsorBlock.

Параметры:

• url (string, обязательный) — URL видео YouTube или ID видео

• lang (string, необязательный) — код языка субтитров (по умолчанию: "en")

get_most_replayed

Получает данные тепловой карты «чаще всего пересматривают», показывающие, какие фрагменты зрители пересматривают чаще всего.

Параметры:

• url (string, обязательный) — URL видео YouTube или ID видео

Примечание: для наличия данных тепловой карты требуется примерно 50K+ просмотров.

search_videos

Ищет по YouTube с полной поддержкой фильтров.

Параметры:

• query (string, обязательный) — поисковый запрос

• max_results (number, необязательный) — количество результатов, 1–50 (по умолчанию: 10)

• order (string, необязательный) — "relevance", "date", "viewCount", "rating" (по умолчанию: "relevance")

• duration (string, необязательный) — "short" (<4min), "medium" (4-20min), "long" (>20min)

• upload_date (string, необязательный) — "hour", "day", "week", "month", "year"

• type (string, необязательный) — "video", "channel", "playlist" (по умолчанию: "video")

get_video_metadata

Получает подробные метаданные видео YouTube.

Параметры:

• url (string, обязательный) — URL видео YouTube или ID видео

Возвращает: название, описание, канал, длительность, количество просмотров/лайков/комментариев, теги, категорию, миниатюры, статус прямого эфира и многое другое.

get_channel_info

Получает информацию о канале YouTube.

Параметры:

• url (string, обязательный) — URL канала YouTube, @handle или ID канала

Возвращает: название, описание, количество подписчиков/видео/просмотров, страну, пользовательский URL и миниатюру.

get_playlist_items

Получает все видео в плейлисте YouTube.

Параметры:

• url (string, обязательный) — URL плейлиста YouTube или ID плейлиста

• max_results (number, необязательный) — количество элементов, 1–50 (по умолчанию: 25)

get_channel_videos

Получает недавние видео с канала YouTube.

Параметры:

• url (string, обязательный) — URL канала YouTube, @handle или ID канала

• max_results (number, необязательный) — количество видео, 1–50 (по умолчанию: 25)

• order (string, необязательный) — "date", "viewCount" (по умолчанию: "date")

get_trending_videos

Получает текущие трендовые/популярные видео YouTube.

Параметры:

• region_code (string, необязательный) — код страны ISO 3166-1 alpha-2 (по умолчанию: "US")

• category_id (string, необязательный) — ID категории YouTube (например, "10" — Музыка, "20" — Игры, "28" — Наука и техника)

• max_results (number, необязательный) — количество результатов, 1–50 (по умолчанию: 10)

search_within_channel

Ищет видео в конкретном канале YouTube.

Параметры:

• url (string, обязательный) — URL канала YouTube, @handle или ID канала

• query (string, обязательный) — поисковый запрос

• max_results (number, необязательный) — количество результатов, 1–50 (по умолчанию: 10)

get_video_comments

Получает комментарии верхнего уровня к видео YouTube.

Параметры:

• url (string, обязательный) — URL видео YouTube или ID видео

• max_results (number, необязательный) — количество комментариев, 1–100 (по умолчанию: 20)

• order (string, необязательный) — "relevance", "time" (по умолчанию: "relevance")

calculate_engagement

Рассчитывает метрики вовлечённости для видео YouTube.

Параметры:

• url (string, обязательный) — URL видео YouTube или ID видео

Возвращает: количество просмотров, лайков, комментариев, коэффициент лайков, коэффициент комментариев и общий коэффициент вовлечённости.

Как это работает

Этот MCP-сервер подключается к Claude Code через stdio-транспорт и предоставляет 15 инструментов:

Примечание: 5 инструментов работают без API-ключа (транскрипты, SponsorBlock, тепловые карты, парсинг URL). Остальные 10 требуют ключ YouTube Data API v3.

Конфигурация

Переменные окружения

Квота YouTube API

У YouTube Data API v3 есть дневная квота в 10 000 единиц. Каждый инструмент расходует разное количество:

Совет: Операции поиска — самые дорогие. Используйте get_channel_videos (1 единица) вместо search_within_channel (100 единиц), когда вам нужны только последние загрузки.

Устранение неполадок

Исправление API-ключа

Если вы ввели неправильный API-ключ, удалите и переустановите сервер:

claude mcp remove youtube

Затем переустановите, используя команду из шага 3.3 выше (используйте ту же область видимости, что и при первоначальной установке).

MCP-сервер не отображается

Проверьте, установлен ли сервер:

claude mcp list

Если его нет в списке, выполните шаг 3, чтобы установить его.

Сервер не запускается

1. Проверьте, что ваш API-ключ действителен в Google Cloud Console

2. Проверьте, что YouTube Data API включён:

   • Перейдите в API Library

   • Там должно быть написано «Enabled»

3. Проверьте версию Node.js (нужна 18+):

node --version

4. Убедитесь, что сервер собран — если dist/index.js отсутствует, выполните npm install заново.

Ошибки подключения

1. Проверьте, что dist/index.js существует — если нет, выполните npm install

2. Убедитесь, что путь является абсолютным в вашей команде claude mcp add

3. Перезапустите Claude Code после любых изменений конфигурации

Превышена квота

Если вы видите ошибки «quotaExceeded»:

• Подождите до полуночи по тихоокеанскому времени (квота сбрасывается ежедневно)

• Используйте другой API-ключ

• Предпочитайте недорогие инструменты (get_video_metadata за 1 единицу) поисковым инструментам (100 единиц)

Транскрипт недоступен

У некоторых видео транскрипты отключены. Инструмент get_transcript вернёт понятное сообщение об ошибке. Попробуйте:

• Другой код языка (например, lang: "es")

• Автоматически созданные субтитры могут быть доступны, даже если ручных нет.

Ошибки тайм-аута

Увеличьте переменную окружения YOUTUBE_TIMEOUT для медленных соединений:

claude mcp add -s user youtube -e YOUTUBE_API_KEY=YOUR_KEY -e YOUTUBE_TIMEOUT=60000 -- node /path/to/dist/index.js

Просмотр текущей конфигурации

claude mcp list

Вклад в проект

Принимаются pull request'ы! Пожалуйста, старайтесь, чтобы проект оставался простым и понятным для новичков.

Лицензия

MIT

Сделано для сообщества Claude Code