ScreenshotOne

ScreenshotOne MCP Server

Eine offizielle Implementierung eines MCP-Servers (Model Context Protocol) für ScreenshotOne.

Ein paar weitere Worte dazu, warum er entwickelt wurde, und einige Gedanken zur Zukunft von MCP.

ScreenshotOne bietet außerdem einen offiziellen gehosteten MCP-Server an. Eine Anleitung zur Einrichtung und die neuesten Updates findest du unter ScreenshotOne MCP integration.

Tools

• render-website-screenshot: Erstellt einen Screenshot einer Website und gibt die angeforderten temporären URLs für den Screenshot, den Inhalt und die Ausschnitte zurück.
• render-website-screenshot-as-file: Erstellt einen Screenshot oder ein PDF einer Website und gibt die Datei selbst als in die Antwort eingebettete MCP-Ressource mit einer temporären URL zurück.
• extract-website-markdown: Ruft eine Website ab und gibt deren bereinigtes Markdown direkt als Text zurück.
• get-usage: Ruft das Kontingent und die Parallelitätsauslastung der ScreenshotOne-API ab.

Das Screenshot-Tool bietet die folgenden gezielten Optionen:

• url
• block_banners (standardmäßig true)
• block_ads (standardmäßig true)
• image_quality (standardmäßig 80)
• full_page (standardmäßig false)
• full_page_slices (standardmäßig false; erfordert full_page=true)
• metadata_content (standardmäßig false)
• metadata_content_format (html oder markdown; erfordert metadata_content=true)

Die Optionsnamen und Werte für Metadateninhalte und ganzseitige Ausschnitte entsprechen der ScreenshotOne-API. Das Tool bietet keine Steuerungsmöglichkeiten für Antworttyp oder Caching; es fordert immer eine JSON-Antwort an und deaktiviert das API-Caching.

Lege metadata_content=true und metadata_content_format=markdown fest, um zusammen mit dem Screenshot eine temporäre URL für den Markdown-Inhalt zu erhalten. Lege full_page=true und full_page_slices=true fest, um kleinere URLs für vertikale Screenshot-Ausschnitte zu erhalten. Ausschnitte sind vorzuziehen, wenn ein KI-Agent eine lange Seite analysieren muss, die sich möglicherweise nicht zuverlässig als ein großes Bild verarbeiten lässt.

Bei einer erfolgreichen Aufnahme werden die angeforderten URLs als Text und strukturierter Inhalt zurückgegeben:

{
    "url": "https://<screenshotone-cache-domain>/...",
    "content": {
        "url": "https://<screenshotone-cache-domain>/...",
        "expires": "Sun, 07 Sep 2026 12:00:00 GMT",
        "format": "markdown"
    },
    "slices": [
        {
            "index": 0,
            "offset_y": 0,
            "width": 1280,
            "height": 4000,
            "url": "https://<screenshotone-cache-domain>/..."
        }
    ]
}

Die URLs sind temporär. Die Screenshot-URL ist bis zu vier Stunden verfügbar, während der Metadateninhalt den genauen Ablaufzeitpunkt enthält. Lade alle Artefakte herunter, die du behalten möchtest.

render-website-screenshot-as-file ist für Clients gedacht, die die Datei selbst benötigen, etwa um sie zu speichern oder anzuhängen, oder die keine Links herunterladen können. Es akzeptiert url, format (standardmäßig jpg, png, webp, gif, jp2, tiff, avif, heif oder pdf), block_banners, block_ads, image_quality, full_page und full_page_max_height (erfordert full_page=true). Die Datei wird als eingebettete Ressource (type: "resource" mit einer Base64-blob und ihrem MIME-Typ) sowie mit Name, URI, MIME-Typ, Größe und temporärer URL als Text und strukturierter Inhalt zurückgegeben. Dateien mit mehr als 5 MB werden nicht eingebettet; das Tool gibt einen Fehler zurück, der ein kleineres Format, eine niedrigere Qualität oder eine geringere Höhe empfiehlt, und fügt die temporäre URL hinzu.

extract-website-markdown akzeptiert nur url. Es ist eine gezielte Abkürzung für die format=markdown-API-Anfrage von ScreenshotOne und gibt das resultierende Markdown direkt in einer MCP-Textantwort zurück. Verwende es, wenn der Agent Seiteninhalte ohne Screenshot lesen oder analysieren muss.

Verwendung

Erstellen

Installiere immer zuerst die Abhängigkeiten und erstelle das Projekt:

npm install && npm run build

ScreenshotOne-API-Schlüssel abrufen

Registriere dich bei ScreenshotOne und rufe deinen API-Schlüssel ab.

Mit npx ausführen

Führe die CLI direkt aus dem npm-Paket aus, ohne das Repository zu klonen:

SCREENSHOTONE_API_KEY=your_api_key npx --yes @screenshotone/mcp

Mit Claude für Desktop

Füge Folgendes zu deiner ~/Library/Application\ Support/Claude/claude_desktop_config.json hinzu:

{
    "mcpServers": {
        "screenshotone": {
            "command": "npx",
            "args": ["--yes", "@screenshotone/mcp"],
            "env": {
                "SCREENSHOTONE_API_KEY": "<your api key>"
            }
        }
    }
}

Eigenständig oder für andere Projekte

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

Lizenz

ScreenshotOne MCP Server ist unter der MIT-Lizenz lizenziert.