Site-Shot MCP server

Geben Sie Claude, Cursor und anderen KI-Agenten die Fähigkeit, jede Webseite zu sehen — machen Sie Website-Screenshots mit Site-Shot über das Model Context Protocol.

Echtes Chromium-Rendering · Ganzseiten-Erfassung · Länder-Proxys · automatische Entfernung von Werbung & Cookie-Bannern (sauberere Bilder, weniger Vision-Tokens).

Schnellstart (Claude Desktop)

1. Holen Sie sich einen Site-Shot-API-Schlüssel unter https://www.site-shot.com/start/.

2. Fügen Sie dies zu Ihrer Claude-Desktop-Konfiguration hinzu (claude_desktop_config.json):

{
  "mcpServers": {
    "site-shot": {
      "command": "npx",
      "args": ["-y", "site-shot-mcp"],
      "env": { "SITESHOT_API_KEY": "YOUR_API_KEY" }
    }
  }
}

3. Starten Sie Claude Desktop neu. Bitten Sie es, "einen Ganzseiten-Screenshot von https://news.ycombinator.com zu machen", und es wird den Server aufrufen und Ihnen das Bild zeigen.

Funktioniert auf die gleiche Weise in jedem MCP-Client (Cursor, Cline, VS Code, LangChain, CrewAI) — weisen Sie den Client auf npx -y site-shot-mcp mit SITESHOT_API_KEY in der Umgebung hin.

Related MCP server: ScreenshotOne MCP Server

Tools

capture_screenshot

Machen Sie einen Screenshot einer Webseite (standardmäßig Viewport).

Gibt den Screenshot als MCP-Bild zurück.

„API-Standard" ist keine Zahl, die dieses Paket angeben kann. width, height und wait_ms werden nur weitergeleitet, wenn Sie sie übergeben. Was also gilt, wenn Sie sie nicht übergeben, entscheidet die Site-Shot-API und kann sich ohne eine Veröffentlichung hier ändern. Versionen bis 1.1.0 druckten Pixelgrößen für width / height, die die API nicht verwendet — ein Agent, der sie wegließ, um „den Standard" zu nehmen, erhielt einen anderen Viewport, ohne dass das zurückgegebene Bild dies erkennen ließ. Übergeben Sie explizite Werte, wann immer die Größe wichtig ist.

Ländercodes sind ISO-Codes, keine Namen. Übergeben Sie "DE", nicht "Germany". Die API gleicht Codes exakt ab und würde andernfalls über einen US-Proxy rendern, ohne Sie zu informieren. Daher lehnt der Server vollständige Namen ab, bevor er ein Rendering ausgibt. strict_country (standardmäßig aktiviert) verwandelt ein nicht verfügbares Land ebenfalls in einen Fehler anstelle eines stillen US-Screenshots — übergeben Sie false, um wieder auf den Fallback zu setzen. Unterstützte Länder →

capture_full_page

Gleich wie capture_screenshot mit aktivierter Ganzseiten-Erfassung.

Warum diesen Server anstelle des eigenen Browsers des Agenten aufrufen?

Wenn Ihr Agent einen Browser steuert, kann er selbst Screenshots von Seiten machen — und für Seiten, die angemeldet sein müssen oder durch einen Ablauf geführt werden, ist das das richtige Werkzeug. Für öffentliche URLs ist es in der Regel bessere Technik, die Erfassung an diesen Server zu delegieren: Jede Erfassung läuft durch dieselbe Pipeline (keine Neuplanung zwischen den Läufen), kann aus einem bestimmten Land mit passender Locale und Zeitzone erfolgen (country + strict_country), wird von einem Bildklassifikator mit einer eskalierenden Wiederholungsleiter bewertet, bevor sie zurückgegeben wird, und kostet einen Bruchteil eines Cents anstelle einer Browsersitzung plus Vision-Tokens pro Blick. Der vollständige Vergleich, beide Richtungen ehrlich dargelegt: KI-Agent vs. Screenshot-API — wer sollte die Seite erfassen.

Konfiguration

Der Server ist ein dünner Wrapper über die bestehende Site-Shot-HTTP-API (https://api.site-shot.com/) — kein separates Backend.

Lokale Entwicklung

npm install
npm run check   # syntax check
npm run smoke   # offline tests (stubbed fetch, no API key needed)
SITESHOT_API_KEY=yourkey npm start   # run the server on stdio

Anforderungen

Node.js ≥ 18 (verwendet das eingebaute fetch).

Lizenz

MIT