# youtube-video-analyzer

MCP-сервер youtube-video-analyzer для анализа публичных роликов YouTube через Google Gemini. Извлекает речь, метаданные, кадры, работает с длинными стримами.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 у репозитория
- Автор: ludmila-omlopes
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ludmila-omlopes/youtube-video-analyzer-mcp
- Обновлён: 2026-05-21
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/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. Приватные, удалённые, возрастные и заблокированные по региону ролики могут не сработать.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `GEMINI_API_KEY`, `GEMINI_MODEL`, `YT_DLP_PATH` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- суммировать длинный стрим или подкаст
- извлечь текст из речи в видео
- вытащить кадр из ролика по таймкоду
- получить метаданные ролика через YouTube Data API
- задать уточняющий вопрос по уже проанализированному видео

## Примеры запросов агенту
- Проанализируй ролик и выдели главные тезисы
- Извлеки кадр на 2:30 из этого видео
- Получи метаданные ролика и покажи длительность

## Похожие
- [video-content-analyzer](https://affpapa.org/nevibecode/skills/video-content-analyzer.md) — скилл · 918 установок
- [Video URL Analyzer](https://affpapa.org/nevibecode/mcp/video-url-analyzer.md) — MCP-сервер · ★ 5 у репозитория
- [youtube-research](https://affpapa.org/nevibecode/skills/manojbajaj95-youtube-research.md) — скилл · 200 установок
- [youtube-transcribe](https://affpapa.org/nevibecode/skills/youtube-transcribe.md) — скилл · 1700 установок
- [youtube-video-generation](https://affpapa.org/nevibecode/skills/youtube-video-generation.md) — скилл · 370 установок
- [youtube-publishing-and-metadata](https://affpapa.org/nevibecode/skills/youtube-publishing-and-metadata.md) — скилл · 1300 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
