ScreenshotOne

ScreenshotOne MCP Server

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

Ein paar weitere Worte darüber, warum es gebaut wurde, und einige Gedanken zur Zukunft von MCP.

ScreenshotOne bietet auch einen offiziell gehosteten MCP-Server an. Siehe die ScreenshotOne MCP-Integration für Einrichtungsanweisungen und die neuesten Updates.

Werkzeuge

• render-website-screenshot: Rendert einen Website-Screenshot und gibt temporäre Screenshot-, Inhalts- und Slice-URLs wie angefordert zurück.
• extract-website-markdown: Rendert eine Website und gibt deren bereinigtes Markdown direkt als Text zurück.
• get-usage: Ruft das ScreenshotOne-API-Kontingent und die Nebenläufigkeitsnutzung ab.

Das Screenshot-Werkzeug bietet diese fokussierten Optionen:

• url
• block_banners (Standard: true)
• block_ads (Standard: true)
• image_quality (Standard: 80)
• full_page (Standard: false)
• full_page_slices (Standard: false; erfordert full_page=true)
• metadata_content (Standard: false)
• metadata_content_format (html oder markdown; erfordert metadata_content=true)

Die Optionsnamen und -werte für Metadateninhalte und Vollseiten-Slices entsprechen der ScreenshotOne-API. Das Werkzeug legt keine Antworttyp- oder Cache-Steuerungen offen; es fordert immer eine JSON-Antwort mit deaktiviertem API-Caching an.

Setzen Sie metadata_content=true und metadata_content_format=markdown, um eine temporäre Markdown-Inhalts-URL mit dem Screenshot zu erhalten. Setzen Sie full_page=true und full_page_slices=true, um kleinere vertikale Screenshot-URLs zu erhalten. Slices werden bevorzugt, wenn ein KI-Agent eine lange Seite analysieren muss, die möglicherweise nicht zuverlässig als ein großes Bild verarbeitet werden kann.

Eine erfolgreiche Erfassung gibt die angeforderten URLs als Text und strukturierten Inhalt zurück:

{
    "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 Metadateninhalte ihre genaue Ablaufzeit enthalten. Laden Sie alle Artefakte herunter, die Sie behalten möchten.

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

Verwendung

Erstellen

Installieren Sie immer zuerst die Abhängigkeiten und erstellen Sie es:

npm install && npm run build

Holen Sie sich Ihren ScreenshotOne-API-Schlüssel

Melden Sie sich bei ScreenshotOne an und holen Sie sich Ihren API-Schlüssel.

Mit npx ausführen

Führen Sie 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ügen Sie Folgendes zu Ihrer ~/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.