🎬 claude-youtube-transcript

Вставьте URL YouTube в Claude Desktop и получите полную транскрипцию видео.

Это минимальный MCP-сервер, который даёт Клоду инструмент —get_transcript— для чтения субтитров любого видео на YouTube, если они есть. Без API-ключей, без аккаунта Google, без скачивания видео: только текстовая дорожка, сплошным блоком, готовым к тому, чтобы модель могла его резюмировать, переводить или цитировать.

✨ Что делает

• Принимает любой формат URL — watch?v=, youtu.be/, /shorts/, /embed/, /live/ или сам ID из 11 символов.

• Отдаёт приоритет испанскому, запасной вариант — английский, а если ручной дорожки нет, используются автоматические субтитры.

• Совместим с youtube-transcript-api 0.6 и 1.x — пробует классический API, API инстанции и список дорожек, в этом порядке.

• Возвращает сплошной текст, без временных меток и пометок [Música], чтобы не тратить лишний контекст.

Related MCP server: YouTube Transcript MCP Server

📋 Требования

• Claude Desktop (macOS, Windows или Linux).

• Python 3.10 или новее в PATH.

• Больше ничего: без API-ключей, без аккаунта Google, без ffmpeg.

🚀 Быстрая установка

macOS / Linux

git clone https://github.com/Magiprr/claude-youtube-transcript.git && cd claude-youtube-transcript && ./install.sh

Windows

В PowerShell:

git clone https://github.com/Magiprr/claude-youtube-transcript.git; cd claude-youtube-transcript; powershell -ExecutionPolicy Bypass -File .\install.ps1

Параметр -ExecutionPolicy Bypass нужен, потому что Windows по умолчанию блокирует неподписанные скрипты. Он применяется только к этому запуску и не меняет политику системы.

Установщик (в обеих системах):

1. 📦 Устанавливает зависимости через pip --break-system-packages.

2. 🔍 Определяет абсолютный путь к server.py и к бинарнику python3.

3. 💾 Делает резервную копию вашего claude_desktop_config.json перед его изменением.

4. 🤝 Объединяет блок youtube-transcript не перезаписывая уже существующие MCP-серверы.

5. 🔄 Сообщает, что нужно перезапустить Claude Desktop (Cmd + Q, а не просто закрыть окно).

Установка вручную

Если предпочитаете сделать вручную, добавьте это в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "/opt/homebrew/bin/python3",
      "args": ["/ruta/absoluta/a/claude-youtube-transcript/server.py"]
    }
  }
}

Оба пути должны быть абсолютными. Путь к Python вы получите через which python3 (или where python в Windows).

Расположение файла зависит от системы:

В Windows, пути внутри JSON записываются с двойной обратной косой чертой (C:\\Users\\ваше-имя\\...) или обычной косой. Установщик сам всё делает правильно.

🔎 Что получает Claude

Инструмент возвращает сплошной блок, без временных меток и звуковых пометок:

Transcripcion de https://www.youtube.com/watch?v=VIDEO_ID

Hoy vamos a ver como funciona el protocolo MCP y por que cambia la forma
en que las aplicaciones le dan herramientas a un modelo de lenguaje...

Так модель тратит контекст на контент, а не на метаданные.

💬 Примеры промптов

После перезапуска Claude Desktop:

Resúmeme este video en 10 bullets: https://www.youtube.com/watch?v=dQw4w9WgXcQ

Extrae de este video todas las cifras que menciona, con el contexto de cada una:
https://youtu.be/dQw4w9WgXcQ

Traduce al español la transcripción de https://www.youtube.com/shorts/dQw4w9WgXcQ

Compara qué dicen estos dos videos sobre el mismo tema:
<url 1>
<url 2>

De este video, dame solo las partes donde habla de precios, citadas textual:
<url>

🩺 Решение проблем

Закройте приложение полностью и откройте снова. На macOS это Cmd + Q; в Windows, закрытия окна недостаточно — нажмите правой кнопкой на значок в системном трее и выберите Quit. В обоих случаях закрытие окна не останавливает процесс. Затем проверьте, что блок записан правильно:

python3 -m json.tool ~/Library/Application\ Support/Claude/claude_desktop_config.json

Это Python от Homebrew защищает себя. Установщик уже использует --break-system-packages; если запускаете вручную:

python3 -m pip install -r requirements.txt --break-system-packages

Если не хотите трогать системный Python, используйте venv и пропишите command в конфиге на путь /ruta/al/venv/bin/python.

Claude Desktop использует другой Python, не тот, которым установлены зависимости. Проверьте, какой указан в конфиге, и что именно у него установлен пакет:

/opt/homebrew/bin/python3 -c "import mcp, youtube_transcript_api; print('ok')"

Не на всех видео есть субтитры: автор мог их отключить, видео может быть приватным, с возрастным ограничением или являться текущей прямой трансляцией. Убедитесь в YouTube, что кнопка CC есть.

YouTube ограничивает количество запросов по IP. Обычно происходит в общих сетях или через VPN. Подождите несколько минут или попробуйте с другого подключения.

Это политика выполнения PowerShell. Запустите так:

powershell -ExecutionPolicy Bypass -File .\install.ps1

Если кроме того Windows пометил скачанный файл как полученный из интернета:

Unblock-File .\install.ps1

Это встроенная заглушка-ссилка. Установите Python с python.org, таким образом отметив «Add python.exe to PATH». Установщик уже игнорирует эту заглушку при поиске интерпретатора.

# macOS
tail -f ~/Library/Logs/Claude/mcp-server-youtube-transcript.log

# Windows
Get-Content -Wait "$env:APPDATA\Claude\Logs\mcp-server-youtube-transcript.log"

🛠️ Разработка

Вы можете запустить сервер вручную, чтобы проверить, что он поднимается:

python3 server.py

Он останется ждать данных через stdio (так его использует Claude Desktop): отсутствие вывода — знак того, что всё в порядке.

📄 Лицензия

MIT © 2026

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.