Позволяет ИИ-агентам обрабатывать видео из социальных сетей, извлекая кадры и транскрипты для автоматизированного анализа и документирования.
Также известен как sonpiaz/watch-cli, @sonpiaz/watch-cli-mcp
- Звёзды
- 260
- Инструменты
- 1
- Загрузки, 30 дней
- —
- Последняя версия
- 0.3.1
- Последний коммит
- 13 сент. 2026 г.
- Лицензия
- MIT
Что такое watch-cli MCP?
Позволяет ИИ-агентам обрабатывать видео из социальных сетей, извлекая кадры и транскрипты для автоматизированного анализа и документирования. Он предоставляет 1 инструмент, например watch.
Сводка сгенерирована из README проекта
О watch-cli MCP server
Этот сервер позволяет извлекать визуальные кадры и транскрипты из видео в социальных сетях для автоматического создания документации. Разработчики, использующие агентов с поддержкой MCP, таких как Claude Desktop, Cursor или Windsurf, могут передать URL-адрес видео и получить структурированные данные для построения архитектурных диаграмм, описания работающих компонентов или создания пошаговых шпаргалок. Работа сервера реализована через обертку над инструментом watch-cli, который должен быть установлен в вашей локальной системе и доступен в PATH для корректного функционирования.
Сервер предоставляет единый инструмент watch, который принимает URL-адрес видео с таких платформ, как YouTube, X, TikTok, LinkedIn, Vimeo, Reddit и Facebook. Вы можете указать количество кадров с равными интервалами для извлечения (от 1 до 64 кадров). Сервер взаимодействует через stdio и обрабатывает различные ошибки, такие как проблемы с аутентификацией или региональные ограничения на загрузку, передавая клиенту специальные теги для восстановления работы.
Что вы можете с ним делать
- 1Генерация технической документации из видеоПопросите ИИ-агента преобразовать видео из соцсетей в структурированную архитектурную диаграмму или исполняемый блокнот (notebook).
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить watch-cli MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка watch-cli MCP в Claude Code
$ claude mcp add --env 'GROQ_API_KEY=<YOUR_GROQ_API_KEY>' --env 'KYMA_API_KEY=<YOUR_KYMA_API_KEY>' watch-cli -- npx -y @sonpiaz/watch-cli-mcpУстановка watch-cli MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"watch-cli": {
"command": "npx",
"args": [
"-y",
"@sonpiaz/watch-cli-mcp"
],
"env": {
"GROQ_API_KEY": "<YOUR_GROQ_API_KEY>",
"KYMA_API_KEY": "<YOUR_KYMA_API_KEY>"
}
}
}
}Установка watch-cli MCP в VS Code
.vscode/mcp.json
{
"servers": {
"watch-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sonpiaz/watch-cli-mcp"
],
"env": {
"GROQ_API_KEY": "<YOUR_GROQ_API_KEY>",
"KYMA_API_KEY": "<YOUR_KYMA_API_KEY>"
}
}
}
}Установка watch-cli MCP в VS Code CLI
$ code --add-mcp '{"name":"watch-cli","type":"stdio","command":"npx","args":["-y","@sonpiaz/watch-cli-mcp"],"env":{"GROQ_API_KEY":"<YOUR_GROQ_API_KEY>","KYMA_API_KEY":"<YOUR_KYMA_API_KEY>"}}'Установка watch-cli MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"watch-cli": {
"command": "npx",
"args": [
"-y",
"@sonpiaz/watch-cli-mcp"
],
"env": {
"GROQ_API_KEY": "<YOUR_GROQ_API_KEY>",
"KYMA_API_KEY": "<YOUR_KYMA_API_KEY>"
}
}
}
}Установка watch-cli MCP в Codex
$ codex mcp add watch-cli --env 'GROQ_API_KEY=<YOUR_GROQ_API_KEY>' --env 'KYMA_API_KEY=<YOUR_KYMA_API_KEY>' -- npx -y @sonpiaz/watch-cli-mcpУстановка watch-cli MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.watch-cli] command = "npx" args = ["-y", "@sonpiaz/watch-cli-mcp"] [mcp_servers.watch-cli.env] GROQ_API_KEY = "<YOUR_GROQ_API_KEY>" KYMA_API_KEY = "<YOUR_KYMA_API_KEY>"
Установка watch-cli MCP в Gemini CLI
$ gemini mcp add -s user -e 'GROQ_API_KEY=<YOUR_GROQ_API_KEY>' -e 'KYMA_API_KEY=<YOUR_KYMA_API_KEY>' watch-cli npx -- -y @sonpiaz/watch-cli-mcpУстановка watch-cli MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"watch-cli": {
"command": "npx",
"args": [
"-y",
"@sonpiaz/watch-cli-mcp"
],
"env": {
"GROQ_API_KEY": "<YOUR_GROQ_API_KEY>",
"KYMA_API_KEY": "<YOUR_KYMA_API_KEY>"
}
}
}
}Запущено HostedMCP 16 нояб. 2026 г.
Мы выполнили эту команду для @sonpiaz/watch-cli-mcp 0.3.1 в изолированном контейнере без сети и без ключей. Сервер ответил и показал 1 инструмент.
Инструменты watch-cli MCP 1
Получено от сервера через tools/listwatchWatch any social video → get an architecture diagram, working component, runnable notebook, or step-by-step cheat sheet — automatically.
| watch | Watch any social video → get an architecture diagram, working component, runnable notebook, or step-by-step cheat sheet — automatically. |
Конфигурация
GROQ_API_KEYСекретGroq API key for direct BYOK transcription (alternative to Kyma). Set this instead of KYMA_API_KEY if you prefer direct provider.
KYMA_API_KEYСекретKyma API key (default backend). Get one at https://kymaapi.com — first $0.50 free, then pay-per-use (~$0.05 per 1-hour video). Optional if WATCH_AUDIO_MODE=local (whisper.cpp) or GROQ_API_KEY is set instead.
WATCH_AUDIO_MODEBackend routing override. Values: kyma (default), byok (use GROQ_API_KEY), local (whisper.cpp on $PATH, fully offline).
| Название | Описание | Тип |
|---|---|---|
| GROQ_API_KEY | Groq API key for direct BYOK transcription (alternative to Kyma). Set this instead of KYMA_API_KEY if you prefer direct provider. | Секрет |
| KYMA_API_KEY | Kyma API key (default backend). Get one at https://kymaapi.com — first $0.50 free, then pay-per-use (~$0.05 per 1-hour video). Optional if WATCH_AUDIO_MODE=local (whisper.cpp) or GROQ_API_KEY is set instead. | Секрет |
| WATCH_AUDIO_MODE | Backend routing override. Values: kyma (default), byok (use GROQ_API_KEY), local (whisper.cpp on $PATH, fully offline). |
Автоматические проверки
Запущено 16 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийsonpiaz/watch-cli is public and reachablegithub.com/sonpiaz/watch-cli ↗Пройдено
- Пакет указывает этот репозиторий как источник@sonpiaz/watch-cli-mcp names sonpiaz/watch-cli as sourcenpmjs.com/package/@sonpiaz/watch-cli-mcp ↗Пройдено
- Происхождение сборки (аттестация Sigstore)No build attestation published for this releaseНе проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-09-13github.com/sonpiaz/watch-cli ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетNo popular package one edit away from @sonpiaz/watch-cli-mcpПройдено
- Нет критических предупреждений в пакете или его зависимостях99 resolved dependencies checked; no critical advisoryosv.dev ↗Пройдено
- Нет скрытых инструкций для модели1 tool description and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыNo tool named like delete, drop or execПройдено
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на GitHub@sonpiaz/watch-cli-mcp
MCP (Model Context Protocol) stdio server that exposes watch-cli as a callable tool.
Watch any social video → get an architecture diagram, working component, runnable notebook, or step-by-step cheat sheet — automatically.
A single MCP server reaches every MCP-capable agent runtime — Claude Desktop, Claude Code, Cursor, OpenClaw, hermes-agent, Cline, Continue.dev, Windsurf, Zed, Codex, Kiro, VS Code Copilot — without per-IDE plugin work. This package wraps watch-cli so any of them can call it through one channel.
Prerequisites
-
Node.js >= 18.
-
The
watchCLI installed and onPATH. Install with:curl -fsSL https://raw.githubusercontent.com/sonpiaz/watch-cli/main/install.sh | bash
The MCP server shells out to watch; it does not bundle the CLI.
Install
npm install -g @sonpiaz/watch-cli-mcp
Or run on demand via npx:
npx -y @sonpiaz/watch-cli-mcp
The binary is watch-cli-mcp. It reads JSON-RPC on stdin, writes JSON-RPC on stdout, and logs to stderr.
Tool
One tool is registered: watch.
Input schema:
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A social video URL. Supported: YouTube, X / Twitter, LinkedIn, TikTok, Vimeo, Reddit, Facebook."
},
"frames": {
"type": "integer",
"minimum": 1,
"maximum": 64,
"description": "Number of evenly-spaced frames to extract. Default 8."
}
},
"required": ["url"],
"additionalProperties": false
}
Output: the v1 JSON object from docs/output-schema.md, passed through verbatim. Read the schema for the field reference.
Error mapping
| CLI exit | MCP response |
|---|---|
0 |
Tool result with the v1 JSON as content[0].text. |
2 |
InternalError, message includes tag=missing-dep:<bin>. |
3 download-auth / download-region |
InvalidParams, message includes the tag — caller can recover with cookies or a different URL. |
3 download-network / download-other |
InternalError, message includes the tag. |
4 (partial success) |
Tool result with isError: false. Frames populated, transcript null, exit_code: 4 in the JSON payload. Caller branches on obj.exit_code === 4. |
64 |
InvalidParams, message includes tag=usage-error. |
1 / other |
InternalError, message includes the CLI stderr tail (≤ 1 KB). |
Tags always ride in the MCP error message field so callers can grep for the same tag=... token they would see in CLI stderr.
Client configuration
Claude Desktop
Config path:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Merge into the existing mcpServers object:
{
"mcpServers": {
"watch-cli": {
"command": "npx",
"args": ["-y", "@sonpiaz/watch-cli-mcp"]
}
}
}
Restart Claude Desktop after editing.
Cursor
Config path: .cursor/mcp.json (project-scoped) or ~/.cursor/mcp.json (user-global). Same mcpServers object shape as Claude Desktop:
{
"mcpServers": {
"watch-cli": {
"command": "npx",
"args": ["-y", "@sonpiaz/watch-cli-mcp"]
}
}
}
hermes-agent
Config path: optional-skills/mcp.json inside the hermes-agent install, or ~/.hermes-agent/mcp.json user-global. Same mcpServers shape as above.
Other MCP clients
Any MCP-capable agent that accepts an npx command will work with the snippet above. Substitute the client's config path; the command / args pair is portable.
Build from source
git clone https://github.com/sonpiaz/watch-cli
cd watch-cli/mcp-server
npm install
npm run build
node dist/index.js
License
MIT. © 2026 Son Piaz.
Вопросы о watch-cli MCP
Как добавить watch-cli MCP в Claude Code?
Выполните claude mcp add --env 'GROQ_API_KEY=<YOUR_GROQ_API_KEY>' --env 'KYMA_API_KEY=<YOUR_KYMA_API_KEY>' watch-cli -- npx -y @sonpiaz/watch-cli-mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить watch-cli MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие инструменты предоставляет watch-cli MCP?
Он предоставляет 1 инструмент, включая watch.
Какие платформы социальных сетей поддерживаются?
Инструмент поддерживает YouTube, X / Twitter, LinkedIn, TikTok, Vimeo, Reddit и Facebook.
Нужно ли устанавливать watch CLI отдельно?
Да, MCP server вызывает watch CLI и не включает его в свой состав, поэтому он должен быть установлен в вашей PATH.