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

   • Нажмите Включить

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

   • Перейдите в Учётные данные

   • Нажмите Создать учётные данные > API-ключ

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 на ваш реальный ключ YouTube Data API и укажите полный путь к dist/index.js.

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

• macOS/Linux: echo "$(пwd)/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-mcp

Возможности

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

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

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

• Очищенный транскрипт (get_clean_transcript) — Транскрипт, из которого через SponsorBlock удалены рекламные вставки, интро, аутро и слова-паразиты

• Извлечение глав (extract_chapters) — Разбирает временные метки глав из описаний видео

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

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

• Поиск по каналу (search_within_channel) — Поиск видео у конкретного атора

• Трендовые видео (get_trending_videos) — Актуальные трендовые видео по региону и категории

• Видео канала (get_channel_videos) — Недавние видео канала, отсотированные по дате или количеству просмотров

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

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

• Информация о канале (get_channel_info) — Количество подписчиков, число видео, опсание, страна

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

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

• Расчёт вовлечённости (calculate_engagement) — Доля лайков, доля коментариев и показатель вовлечённости на оснве публичной статистики

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

• Коментарии к видео (get_video_comments) — Основные коментарии с количеством лайков и ответов

Утилиты

• Разбор YouTube-ссылки (parse_youtube_ul) — Извлекает ID видео, канала или плейлиста из любого

Примечание: 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

Участие в разрботке

Пул-реквесты приветствутся! Пожалуйста, сохраняйте простоту и доступность для начинающих.

Лицензия

MIT

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