# watch-cli

MCP-сервер watch-cli для Claude Code передаёт агенту видео кадрами и транскриптом. Агент превращает ролики с YouTube, X или TikTok в схему, ноутбук или шпаргалку.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 260 у репозитория
- Автор: sonpiaz
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/sonpiaz/watch-cli/tree/HEAD/mcp-server
- Обновлён: 2026-09-13
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — внимание: команда скачивает скрипт с raw.githubusercontent.com и сразу его запускает. Без явного «да» человека такие команды не запускай.
- HTML: https://affpapa.org/nevibecode/mcp/watch-cli

## Что делает

Сервер регистрирует один инструмент, `watch`. Ему передают ссылку на видео с YouTube, X / Twitter, LinkedIn, TikTok, Vimeo, Reddit или Facebook и, если нужно, число кадров от 1 до 64 (без указания берётся 8). В ответ приходит JSON от CLI без правок: кадры, снятые через равные промежутки, и транскрипт. По ним агент может набросать архитектурную схему или собрать запускаемый ноутбук.

Сам сервер — процесс Node.js 18 или новее. Он общается по stdio и просто вызывает команду `watch`. Без неё в `PATH` ничего не заработает: CLI в пакет не входит, его ставят отдельно.

Ошибки приходят с меткой `tag=...` в тексте. Если скачивание упёрлось в авторизацию или регион (`download-auth`, `download-region`), это ошибка параметров: можно передать cookies или другую ссылку. Когда не получился только транскрипт (код 4), кадры всё равно вернутся, а `transcript` будет `null`.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add --env KYMA_API_KEY=<KYMA_API_KEY> --env GROQ_API_KEY=<GROQ_API_KEY> --env WATCH_AUDIO_MODE=<WATCH_AUDIO_MODE> --transport stdio mcp-server -- npx -y @sonpiaz/watch-cli-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add mcp-server --env KYMA_API_KEY=<KYMA_API_KEY> --env GROQ_API_KEY=<GROQ_API_KEY> --env WATCH_AUDIO_MODE=<WATCH_AUDIO_MODE> -- npx -y @sonpiaz/watch-cli-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@sonpiaz/watch-cli-mcp"
            ],
            "env": {
                "KYMA_API_KEY": "<KYMA_API_KEY>",
                "GROQ_API_KEY": "<GROQ_API_KEY>",
                "WATCH_AUDIO_MODE": "<WATCH_AUDIO_MODE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@sonpiaz/watch-cli-mcp"
            ],
            "env": {
                "KYMA_API_KEY": "<KYMA_API_KEY>",
                "GROQ_API_KEY": "<GROQ_API_KEY>",
                "WATCH_AUDIO_MODE": "<WATCH_AUDIO_MODE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e KYMA_API_KEY=<KYMA_API_KEY> -e GROQ_API_KEY=<GROQ_API_KEY> -e WATCH_AUDIO_MODE=<WATCH_AUDIO_MODE> mcp-server npx -y @sonpiaz/watch-cli-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- разобрать ролик с YouTube или TikTok, не смотря его целиком
- набросать архитектурную схему по видео-разбору системы
- собрать запускаемый ноутбук по туториалу из X / Twitter
- превратить видеоурок в шпаргалку по шагам
- снять с видео нужное число кадров, от 1 до 64

## Примеры запросов агенту
- Вызови `watch` для этой ссылки на YouTube и нарисуй по видео архитектурную схему
- Разбери ролик из X через `watch` на 8 кадрах и собери по нему запускаемый ноутбук
- Посмотри видео с Vimeo через watch-cli и сделай шпаргалку по шагам

## Похожие
- [Yueying – Let AI watch videos](https://affpapa.org/nevibecode/mcp/yueying-let-ai-watch-videos.md) — MCP-сервер · ★ 13 у репозитория
- [watch-video](https://affpapa.org/nevibecode/plugins/codepawl-watch-video.md) — плагин · ★ 350 у репозитория
- [Video Extract](https://affpapa.org/nevibecode/mcp/video-extract.md) — MCP-сервер · ★ 12 у репозитория
- [youtube](https://affpapa.org/nevibecode/commands/youtube.md) — команда · ★ 5412 у репозитория
- [youtube-transcript](https://affpapa.org/nevibecode/skills/tubeagentkit-youtube-transcript.md) — скилл · ★ 41 у репозитория
- [youtube-skills](https://affpapa.org/nevibecode/plugins/youtube-skills.md) — плагин · ★ 1596 у репозитория

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