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 "$( 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-research

Возможности

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

• Получение транскрипта (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) — топ-комментарии с количеством лайков и ответов

Утилиты

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

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

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

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

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

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

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

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

• "Получи коментарии к этому виео и обобщи их тональность"

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

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

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

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

parse_youtube_url

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

Параметры:

• url (string, required) — любой URL YouTube или ID виео

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

get_transcript

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

Параметры:

• url (string, required) — URL виео YouTube или ID виео

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

search_transcript

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

Параметры:

• url (string, required) — URL виео YouTube или ID виео

• query (string, required) — ключевое слово или фраза для поиска

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

extract_chapters

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

Параметры:

• url (string, required) — URL виео YouTube или ID виео

get_clean_transcript

Загружает транскрипт без спонсорских вставок, интро, аутро и лишних слов, удалённых с помощью SponsorBlock.

Параметры:

• url (string, required) — URL видео YouTube или ID видео

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

get_most_replayed

Пол

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