Yapay zeka ajanlarının, otomatik analiz ve dokümantasyon için kareleri ve transkriptleri çıkararak sosyal medya videolarını işlemesine olanak tanır.
Ayrıca bilinen adı sonpiaz/watch-cli, @sonpiaz/watch-cli-mcp
- Yıldızlar
- 260
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.3.1
- Son commit
- 13 Eyl 2026
- Lisans
- MIT
watch-cli MCP nedir?
Yapay zeka ajanlarının, otomatik analiz ve dokümantasyon için kareleri ve transkriptleri çıkararak sosyal medya videolarını işlemesine olanak tanır.
Özet, projenin README dosyasından oluşturuldu
watch-cli MCP sunucusu hakkında
Bu server, otomatik dokümantasyon oluşturmak amacıyla sosyal medya videolarından görsel karelerin ve transkriptlerin çıkarılmasını sağlar. Claude Desktop, Cursor veya Windsurf gibi MCP yetenekli ajanları kullanan geliştiriciler, mimari diyagramlar, çalışan bileşenler veya adım adım kılavuzlar oluşturmak için yapılandırılmış veri almak amacıyla bir video URL'si sağlayabilirler. Sistem, yerel sisteminizde kurulu olması ve çalışması için PATH üzerinde erişilebilir olması gereken watch-cli aracını sarmalayarak çalışır.
Server; YouTube, X, TikTok, LinkedIn, Vimeo, Reddit ve Facebook dahil olmak üzere çeşitli platformlardan video URL'si kabul eden tek bir watch aracı sunar. 1 ile 64 kare arasında bir sınırla, eşit aralıklarla çıkarılacak kare sayısını belirleyebilirsiniz. Server, stdio üzerinden iletişim kurar ve kimlik doğrulama veya bölgesel indirme sorunları gibi çeşitli hata durumlarını, kurtarma işlemi için istemciye belirli etiketler göndererek yönetir.
Neler yapabilirsiniz
- 1Videolardan teknik dokümantasyon oluşturunBir yapay zeka ajanından, sosyal bir videoyu yapılandırılmış bir mimari diyagrama veya çalıştırılabilir bir notebook dosyasına dönüştürmesini isteyin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
watch-cli MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a eklewatch-cli MCP'yi Claude Code içine yükleyin
$ 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-mcpwatch-cli MCP'yi Cursor içine yükleyin
~/.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'yi VS Code içine yükleyin
.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'yi VS Code CLI içine yükleyin
$ 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'yi Claude Desktop içine yükleyin
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'yi Codex içine yükleyin
$ 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-mcpwatch-cli MCP'yi Codex config.toml içine yükleyin
~/.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'yi Gemini CLI içine yükleyin
$ 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-mcpwatch-cli MCP'yi Gemini settings.json içine yükleyin
~/.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>"
}
}
}
}Yapılandırma
GROQ_API_KEYGizliGroq API key for direct BYOK transcription (alternative to Kyma). Set this instead of KYMA_API_KEY if you prefer direct provider.
KYMA_API_KEYGizliKyma 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).
| Ad | Açıklama | Sunucu |
|---|---|---|
| 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. | Gizli |
| 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. | Gizli |
| WATCH_AUDIO_MODE | Backend routing override. Values: kyma (default), byok (use GROQ_API_KEY), local (whisper.cpp on $PATH, fully offline). |
Otomatik kontroller
Çalıştırıldı 12 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorKontrol edilmedi
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
@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 soruları
watch-cli MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde 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 komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
watch-cli MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Hangi sosyal medya platformları destekleniyor?
Araç; YouTube, X / Twitter, LinkedIn, TikTok, Vimeo, Reddit ve Facebook platformlarını destekler.
watch CLI aracını ayrıca kurmam gerekiyor mu?
Evet, MCP server watch CLI aracını dışarıdan çağırır ve içinde barındırmaz; bu nedenle aracın PATH üzerinde kurulu olması gerekir.