Screenshot Scout

Screenshot Scout MCP Sunucusu

Screenshot Scout bir MCP istemcisinden HTTP veya HTTPS web sayfalarını görüntü veya PDF olarak yakalamak için kullanın.

Bu sunucu bir araç sunar: capture_screenshot. Tam sayfa ve öğe yakalamalarını, cihaz ve görünüm alanı kontrollerini, konum seçimini, sayfa etkileşimi ve engelleme seçeneklerini, görüntü boyutlandırma ve kalitesini, PDF düzenini, önbelleği, geçici sonuç URL'lerini ve uygun MCP görüntü içeriğini destekler.

Gereksinimler

• Bir Screenshot Scout hesabı ve API anahtarları sayfasından bir erişim anahtarı.
• npm/stdio kurulumu için Node.js 22 veya daha yenisi. Claude Desktop'un MCPB çalışma zamanı Claude ile birlikte gelir.
• İsteğe bağlı gizli anahtar yalnızca seçtiğiniz API anahtarı imzalı Screenshot Scout istekleri gerektirdiğinde kullanılır.

Her yakalama, Screenshot Scout hesabınızı kullanır ve planınıza, kotanıza ve hız sınırlarınıza tabidir.

npm ile yerel stdio

Bu yerel stdio yapılandırmasıyla başlayın:

{
  "mcpServers": {
    "screenshotscout": {
      "command": "npx",
      "args": ["-y", "@screenshotscout/mcp"],
      "env": {
        "SCREENSHOTSCOUT_ACCESS_KEY": "YOUR_ACCESS_KEY"
      }
    }
  }
}

Erişim anahtarı istek imzalama gerektiriyorsa, gizli anahtarı yerel olarak ekleyin:

"SCREENSHOTSCOUT_SECRET_KEY": "YOUR_SECRET_KEY"

Kişisel yapılandırma dosyalarını sürüm kontrolü dışında tutun. Kimlik bilgileri araç bağımsız değişkenleri değil, süreç ortam değerleridir. Claude Desktop, Claude Code, Cursor, VS Code/GitHub Copilot, Devin ve Cline için istemciye özel kopyala-yapıştır yapılandırmalarına bakın.

Kaynak kopyasından çalıştırma

npm ci
npm run build

İstemciyi node ile dist/stdio.js mutlak yoluna yönlendirin ve yukarıda gösterilen ortam değişkenlerini sağlayın.

Claude Desktop MCPB

Claude Desktop uzantısını yüklemek için:

1. Bu sürümün GitHub sürümünden screenshotscout-mcp-<version>.mcpb indirin.
2. Claude Desktop'ta Ayarlar → Uzantılar → Gelişmiş ayarlar bölümünü açın ve Uzantı Yükle… seçeneğini seçin.
3. İndirilen dosyayı seçin.
4. Gerekli erişim anahtarını girin. Gizli anahtarı yalnızca imzalı istek gerektiren bir API anahtarı için girin.

Claude Desktop her iki alanı da hassas ayarlar olarak ele alır. v0.1.0 MCPB Windows'u destekler.

Barındırılan Streamable HTTP

Barındırılan API anahtarı uç noktası şu adreste çalışır:

https://mcp.screenshotscout.com/mcp/api-key

Yalnızca statik bir HTTP başlığı ekleyebilen istemciler için tasarlanmıştır:

Authorization: Bearer YOUR_ACCESS_KEY

Uç nokta yalnızca bir erişim anahtarı kabul eder. Screenshot Scout gizli anahtarını asla ona göndermeyin ve iki anahtarı da URL'ye veya bir araç bağımsız değişkenine koymayın. Statik Bearer başlığı ekleyemeyen istemciler bu uç noktayı kullanamaz.

İstek imzası gerektiren API anahtarları bunun yerine yerel stdio veya MCPB kullanmalı veya barındırılan uç nokta için ayrılmış imzasız bir erişim anahtarı kullanmalıdır.

Docker ile yerel stdio

Üretim görüntüsünü bir kaynak kopyasından oluşturun:

docker build --tag screenshotscout-mcp:local .

Kimlik bilgilerini yerel ortamdan geçirin ve MCP stdio trafiği için stdin'i bağlı tutun:

docker run --rm -i --init --cap-drop=ALL --security-opt=no-new-privileges --read-only \
  -e SCREENSHOTSCOUT_ACCESS_KEY \
  -e SCREENSHOTSCOUT_SECRET_KEY \
  screenshotscout-mcp:local

SCREENSHOTSCOUT_SECRET_KEY isteğe bağlı kalır. Görüntü, ayrıcalıksız bir kullanıcı olarak çalışır ve yalnızca derlenmiş stdio sunucusunu ve üretim bağımlılıklarını içerir. Bağlantı noktası veya kapsayıcı sağlık denetimi bildirmez: bir MCP istemcisi stdio sürecine sahiptir ve hazır olma durumunu MCP başlatmayı tamamlayarak doğrular. Görüntü ve docker-mcp-catalog.yaml içindeki Docker MCP Katalog meta verileri yerel hazırlık içindir; bu komutlar herhangi bir genel görüntü ima etmez.

Araç: capture_screenshot

capture_screenshot, sağlanan URL ve seçenekler için bir yakalama isteği gönderir. Hedef web sayfası haricidir ve döndürülen içeriğine güvenilmemelidir.

Girdiler

Yalnızca url gereklidir. Yakalamalar varsayılan olarak 1280×720 görünüm alanı kullanır. Biçim belirtilmediğinde, araç kalite 60'ta JPEG döndürür. resultMode varsayılan olarak "auto" değerini kullanır.

Grup	Girdiler
Hedef ve çıktı	url; format (png, jpg, jpeg, webp, gif, tiff, pdf); resultMode (auto, url_only)
Konum ve görünüm alanı	country (iki harfli ülke kodu), device, deviceViewportWidth, deviceViewportHeight, colorScheme (auto, dark, light), fullPage
Sayfa hazırlığı	blockCookieBanners, blockAds, blockChatWidgets, selector, hideSelectors, clickSelectors
Zamanlama	waitUntil (load, domcontentloaded, networkidle0, networkidle2), delay (0–30 saniye), navigationTimeout (5–90 saniye), timeout (1–240 saniye)
Önbellek	cache, cacheTtl (14,400–2,592,000 saniye)
Çıktı boyutlandırma	imageWidth, imageHeight (1–8,192; görüntüler ve PDF'ler için kullanılabilir)
Yalnızca görüntü	imageQuality (0–100, yalnızca JPEG/WebP)
Yalnızca PDF	pdfPaperFormat (letter, legal, tabloid, a4, a3, content), pdfLandscape, pdfPrintBackground, pdfMargin, kenar başına kenar boşluğu alanları, pdfScale (0'dan büyük ve en fazla 3)

Her iki çıktı boyutu da sağlandığında, çarpımları 64,000,000 pikseli aşamaz. PDF kenar boşlukları px, in, mm veya cm cinsinden negatif olmayan değerler kabul eder. imageQuality, JPEG veya WebP çıktısı gerektirir ve yalnızca PDF seçenekleri format: "pdf" gerektirir.

Sonuçlar

• PNG, JPEG, WebP ve GIF, resultMode auto olduğunda, MIME türü uygun olduğunda, boyutlar bilindiğinde ve kenar başına en fazla 8,000 piksel olduğunda, ham veri en fazla 5 MiB olduğunda ve tam serileştirilmiş sonuç geçerli 128,000 baytlık sunucu sınırına sığdığında MCP görüntü içeriği olarak dahil edilebilir.
• Gömülmeye uygun olmayan bir yakalama başarılı kalır ve geçici URL'sini ve eyleme geçirilebilir bir atlama nedenini döndürür.
• TIFF yalnızca URL'dir.
• PDF baytları asla gömülmez. Bir PDF sonucu güvenli metin ve yapılandırılmış meta verilerin yanı sıra Screenshot Scout bir sonuç URL'si sağladığında bir kaynak bağlantısı içerir.
• resultMode: "url_only", her biçim için görüntü baytlarını atlar.

MCP istemcileri, döndürülen görüntü içeriğinin veya kaynak bağlantılarının bir modele görüntülenip görüntülenmeyeceğini veya kullanılabilir olup olmayacağını kontrol eder.

Yapılandırılmış meta veriler screenshotUrl, screenshotUrlExpiresAt, cacheStatus, format, mimeType, imageWidth, imageHeight, inlineImageIncluded ve inlineImageOmissionReason içerebilir.

Sonuç URL'lerini hassas, geçici bağlantılar olarak ele alın ve bildirilen süre sonlarına saygı gösterin.

Örnek komutlar

• "Karanlık modda https://example.com tam sayfa PNG olarak yakala. Yalnızca bir URL döndür."
• "https://example.com/pricing 1280×720 JPEG ekran görüntüsü al, çerez bildirimlerini ve reklamları engelle ve kalite 80 kullan."
• "https://example.com/report arka planlar etkin ve 10 mm kenar boşluklarıyla A4 PDF oluştur."

Gizlilik ve güvenlik

Sunucu, hedef URL'yi ve seçilen yakalama seçeneklerini, hedef web sitesini yükleyen Screenshot Scout'a gönderir. Özel veya düzenlemeye tabi materyalleri yakalamadan önce Screenshot Scout gizlilik politikasını inceleyin.

• Erişim yetkiniz olmayan sayfaları yakalamayın.
• Kimlik bilgilerini komutlara, araç girdilerine, URL'lere, sorun raporlarına veya günlüklere yapıştırmayın.
• Yerel erişim ve gizli anahtarları istemci tarafından yönetilen gizli depolamada veya özel ortam yapılandırmasında saklayın.
• Yerel stdio sunucusu telemetri eklemez. Barındırılan hizmet için uygulama günlüğü; istek yöntemi, yanıt durumu, süre ve temizlenmiş beklenmeyen hatalarla sınırlıdır. Kimlik bilgileri, hedef URL'ler, ekran görüntüsü URL'leri, istek veya yanıt içeriği veya görüntü baytlarını içermeyecek şekilde tasarlanmıştır.
• Araç kullanımına izin vermeden önce her hedefi ve yakalama isteğini inceleyin. Araç açık dünyadır, kota tüketir ve harici bir web sitesiyle etkileşime girer.
• Güvenlik açıklarını SECURITY.md içinde açıklandığı gibi özel olarak bildirin.

Geliştirme

npm ci
npm run format:check
npm run lint
npm run typecheck
npm test
npm run metadata:check
npm run registry:validate
npm run mcpb:validate
npm run mcpb:pack

Lisans

MIT © Oleksii Velykyi