youtube-video-analyzer — MCP-сервер для Claude Code: анализ YouTube
MCP-сервер youtube-video-analyzer для анализа публичных роликов YouTube через Google Gemini. Извлекает речь, метаданные, кадры, работает с длинными стримами.
MIT ★ 5 обновлён 2026-05-21
claude mcp add --env GEMINI_API_KEY=<GEMINI_API_KEY> --env GEMINI_MODEL=<GEMINI_MODEL> --env YT_DLP_PATH=<YT_DLP_PATH> --transport stdio youtube-video-analyzer -- npx -y @ludylops/youtube-video-analyzer-mcpЧто делает youtube-video-analyzer
Сервер подключает инструменты Gemini к Claude Code, Cursor и другим MCP-клиентам. Он умеет суммировать ролики, извлекать текст из речи, получать метаданные через YouTube Data API и вырезать кадры в высоком разрешении с помощью yt-dlp и ffmpeg. Для длинных видео и VOD сервер предлагает два пути: MCP-задачи (если клиент их поддерживает) или фоновые джобы с опросом статуса. Когда локальные инструменты недоступны, сервер переключается на стратегию url_chunks — медиафайлы не скачиваются, но вызовов Gemini больше.
Требуется Node.js 20 или новее и ключ Gemini API. YouTube Data API нужен только для получения метаданных. Без yt-dlp и ffmpeg в PATH сервер не сможет извлечь кадры или обработать длинное видео через локальные файлы — останется только стратегия по URL.
Сервер отправляет URL ролика, промпты и фрагменты медиа в Gemini. Приватные, удалённые, возрастные и заблокированные по региону ролики могут не сработать.
Какие задачи решает
- суммировать длинный стрим или подкаст
- извлечь текст из речи в видео
- вытащить кадр из ролика по таймкоду
- получить метаданные ролика через YouTube Data API
- задать уточняющий вопрос по уже проанализированному видео
Примеры запросов агенту
- Проанализируй ролик и выдели главные тезисы
- Извлеки кадр на 2:30 из этого видео
- Получи метаданные ролика и покажи длительность
Как установить youtube-video-analyzer
Командой платформы
claude mcp add --env GEMINI_API_KEY=<GEMINI_API_KEY> --env GEMINI_MODEL=<GEMINI_MODEL> --env YT_DLP_PATH=<YT_DLP_PATH> --transport stdio youtube-video-analyzer -- npx -y @ludylops/youtube-video-analyzer-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add youtube-video-analyzer --env GEMINI_API_KEY=<GEMINI_API_KEY> --env GEMINI_MODEL=<GEMINI_MODEL> --env YT_DLP_PATH=<YT_DLP_PATH> -- npx -y @ludylops/youtube-video-analyzer-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"youtube-video-analyzer": {
"command": "npx",
"args": [
"-y",
"@ludylops/youtube-video-analyzer-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"GEMINI_MODEL": "<GEMINI_MODEL>",
"YT_DLP_PATH": "<YT_DLP_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"youtube-video-analyzer": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ludylops/youtube-video-analyzer-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"GEMINI_MODEL": "<GEMINI_MODEL>",
"YT_DLP_PATH": "<YT_DLP_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e GEMINI_API_KEY=<GEMINI_API_KEY> -e GEMINI_MODEL=<GEMINI_MODEL> -e YT_DLP_PATH=<YT_DLP_PATH> youtube-video-analyzer npx -y @ludylops/youtube-video-analyzer-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о youtube-video-analyzer
Как установить youtube-video-analyzer в Claude Code?
Выполни claude mcp add youtube-video-analyzer -e GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y @ludylops/youtube-video-analyzer-mcp в терминале. Ключ Gemini обязателен, YouTube API — только для метаданных.
Что делает youtube-video-analyzer?
Подключает Google Gemini к MCP-клиентам для анализа публичных роликов YouTube: суммирует содержание, извлекает речь, достаёт метаданные и кадры, работает с длинными видео через задачи или фоновые джобы.
Можно ли анализировать длинные стримы без yt-dlp?
Да, через стратегию url_chunks. Она не скачивает медиафайлы локально, но требует больше вызовов Gemini. Для работы с локальными файлами нужны yt-dlp и ffmpeg в PATH.