Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

API Screenshot

von matbronsVersion 0.1.2i★ 0iComputer oder CloudOffizielle Website ↗
Name in der Registryio.github.matbrons/api-screenshot

So installierst du es

What it does

Clean full-page screenshots of real sites: cookie banners, pop-ups, chat widgets and ads removed.

  • Connects Computer oder Cloud
  • Account or key Cloud: Needs Authorization · Local: Needs API_KEY
  • Category Web & Browser

Zusammen nutzen mit

Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

von google-research★ 35.6291 Skills

Skill · Anleitung

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

von BigBodyCobain★ 11.6021 Skills

Skill · Anleitung

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

von gosom★ 8.2091 Skills

Skill · Anleitung

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert12/100

Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte API Screenshot. Folge https://mcp.popnx.com/i/matbrons-api-screenshot.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

3/3 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters ({host}) · ✓ Befehle geprüft am 16. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von API Screenshot (auf der Seite des Anbieters erstellen) · Die Adresse enthält {…}-Teile, die du erst durch deine eigenen ersetzt · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Bei API Screenshot registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von API Screenshot öffnen ↗

  2. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameAPI Screenshot
    Remote MCP server URL · Adressehttps://{host}/mcp

    Unter Request headers diesen Namen und Wert hinzufügen

    Header-NameAuthorization
    WertBearer <Schlüssel hier einfügen>

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  4. Im Chat einschalten

    +ConnectorsAPI Screenshot

  5. Ausprobieren

    Nutze API Screenshot und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es API Screenshot nutzt, oder ein Werkzeug von API Screenshot in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann API Screenshot noch nicht verbinden

API Screenshot braucht zum Verbinden deinen eigenen Schlüssel, aber die OpenAI-Hilfe beschreibt nur die Anmeldung per OAuth; eine Schlüssel-Option konnten wir nicht bestätigen

Das kannst du stattdessen tun

A · Eine App nutzen, die API Screenshot verbinden kann

  • Du brauchst einen Schlüssel von API Screenshot (auf der Seite des Anbieters erstellen) · Die Adresse enthält {…}-Teile, die du erst durch deine eigenen ersetzt · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu
  • Du brauchst einen Schlüssel von API Screenshot (auf der Seite des Anbieters erstellen) · Die Adresse enthält {…}-Teile, die du erst durch deine eigenen ersetzt
  • Du brauchst einen Schlüssel von API Screenshot (auf der Seite des Anbieters erstellen) · Die Adresse enthält {…}-Teile, die du erst durch deine eigenen ersetzt
  • Du brauchst einen Schlüssel von API Screenshot (auf der Seite des Anbieters erstellen) · Die Adresse enthält {…}-Teile, die du erst durch deine eigenen ersetzt

B · Andere in Web & Browser, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von API Screenshot (auf der Seite des Anbieters erstellen) · Die Adresse enthält {…}-Teile, die du erst durch deine eigenen ersetzt

  1. Bei API Screenshot registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von API Screenshot öffnen ↗

  2. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  3. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user api-screenshot 'https://{host}/mcp' --header 'Authorization: Bearer {api_key}'

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. /mcp in Claude Code eingeben

    API Screenshot sollte in der Liste als verbunden erscheinen

  5. Ausprobieren

    Nutze API Screenshot und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es API Screenshot nutzt, oder ein Werkzeug von API Screenshot in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von API Screenshot (auf der Seite des Anbieters erstellen) · Die Adresse enthält {…}-Teile, die du erst durch deine eigenen ersetzt

  1. Bei API Screenshot registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von API Screenshot öffnen ↗

  2. MCP-Einstellungsdatei von Cursor öffnen

    ~/.cursor/mcp.json

    Diese Einstellungen einfügen, leere Werte ausfüllen und speichern

    {
      "mcpServers": {
        "api-screenshot": {
          "url": "https://{host}/mcp",
          "headers": {
            "Authorization": "Bearer {api_key}"
          }
        }
      }
    }
  3. Schlüssel eintragen

    In den Einstellungen von API Screenshot ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in Cursor im Agent-Modus öffnen

  5. Ausprobieren

    Nutze API Screenshot und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es API Screenshot nutzt, oder ein Werkzeug von API Screenshot in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von API Screenshot (auf der Seite des Anbieters erstellen) · Die Adresse enthält {…}-Teile, die du erst durch deine eigenen ersetzt

  1. Bei API Screenshot registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von API Screenshot öffnen ↗

  2. MCP-Einstellungsdatei von VS Code öffnen

    MCP: Open User Configuration

    Diese Einstellungen einfügen, leere Werte ausfüllen und speichern

    {
      "servers": {
        "api-screenshot": {
          "type": "http",
          "url": "https://{host}/mcp",
          "headers": {
            "Authorization": "Bearer {api_key}"
          }
        }
      }
    }
  3. Schlüssel eintragen

    In den Einstellungen von API Screenshot ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in VS Code im Agent-Modus öffnen

  5. Ausprobieren

    Nutze API Screenshot und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es API Screenshot nutzt, oder ein Werkzeug von API Screenshot in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://{host}/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die API Screenshot nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user api-screenshot 'https://{host}/mcp' --header 'Authorization: Bearer {api_key}'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "api-screenshot": {
      "url": "https://{host}/mcp",
      "headers": {
        "Authorization": "Bearer {api_key}"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "api-screenshot": {
      "type": "http",
      "url": "https://{host}/mcp",
      "headers": {
        "Authorization": "Bearer {api_key}"
      }
    }
  }
}

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user api-screenshot --env API_KEY=your-value -- docker run -i --rm -e API_KEY ghcr.io/matbrons/api-screenshot:0.1.2

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "api-screenshot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "API_KEY",
        "ghcr.io/matbrons/api-screenshot:0.1.2"
      ],
      "env": {
        "API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "api-screenshot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "API_KEY",
        "ghcr.io/matbrons/api-screenshot:0.1.2"
      ],
      "env": {
        "API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "api-screenshot": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "API_KEY",
        "ghcr.io/matbrons/api-screenshot:0.1.2"
      ],
      "env": {
        "API_KEY": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • API_KEY geheim erforderlich env
    Schlüssel, den jede Anfrage enthalten muss, mindestens 16 Zeichen. Erzeugen mit: openssl rand -hex 32
    Englisches Original anzeigenKey every request must carry, 16 characters or more. Make one with: openssl rand -hex 32
  • PORT env
    Port, auf dem die API lauscht
    Englisches Original anzeigenPort the API listens on
  • Authorization geheim erforderlich HTTP header

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Verbindung
Computer oder Cloud
Transport
streamable-http
Neueste Versioni
0.1.2
In der Registry veröffentlichti
16. Nov. 2026
Code zuletzt geänderti
16. Nov. 2026
Zuletzt geprüft
16. Nov. 2026
Entwickler
matbrons
Pakete
oci: ghcr.io/matbrons/api-screenshot:0.1.2
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Die Adresse braucht deine eigenen Werte, deshalb können wir die Tool-Liste nicht für dich lesen.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto matbrons bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 3 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • – Nicht zutreffend

    Endpunkt antwortet

    Die Adresse braucht Werte aus deinem eigenen Konto, deshalb können wir sie nicht für dich prüfen

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Die Adresse braucht Werte aus deinem eigenen Konto, deshalb können wir sie nicht für dich prüfen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Veröffentlichte Schwachstellen (OSV.dev)

Nicht geprüft: nur npm- und PyPI-Pakete mit Version lassen sich prüfen

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/matbrons-api-screenshot.svg)](https://mcp.popnx.com/en/servers/matbrons-api-screenshot)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Web & Browseri

  • Mehr Sterne als 0 % der anderen 1613 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 88 % der anderen 1613 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 1613 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist API Screenshot sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: Authorization, API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 3 Tagen geändert, und die neueste Version (0.1.2) kam vor 3 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: Browser Use, changedetection.io (official), Apify MCP Server, Pomerado, Actionbook

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Browser Use

Browser agents and stealth cloud browsers for AI: run web tasks, fill forms, extract data.

von browser-useWeit verbreitet↓ 1,7 Mio./Wo.★ 121.385Aktualisiert vor 29 Tagen

Computer oder Cloud✓ vom Dienst · browser-use.com

changedetection.io (official)

Official changedetection.io MCP: web page change tracking, back-in-stock and price alerts.

von dgtlmoonWeit verbreitet★ 35.875Aktualisiert vor 14 Tagen

Läuft in der Cloud✓ vom Dienst · changedetection.io

Apify MCP Server

Extract data from any website with thousands of scrapers, crawlers, and automations on Apify Store ⚡

von apifyWeit verbreitet★ 16.866Aktualisiert vorgestern

Läuft in der Cloud✓ vom Dienst · apify.com

Pomerado

Connect your agents to any website. The cheaper, faster and more reliable alternative to browser use

von PomeradoWachsend★ 1798Aktualisiert gestern

Läuft in der Cloud✓ vom Dienst · pomerado.ai

Actionbook

Let your AI agent operate any website through a real, logged-in browser session.

von actionbookWachsend★ 1631Aktualisiert vor 31 Tagen

Läuft in der Cloud✓ vom Dienst · actionbook.app
Im Vergleich mit ähnlichen
Dieser
API Screenshot
Browser Usechangedetection.io (official)Apify MCP ServerPomeradoActionbook
Läuft woIn der Cloud oder auf deinem RechnerIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaJaNeinJaNeinNein
Mit + in Claude hinzufügenNeinJaNeinNeinNeinNein
Basisprüfungen3/35/53/34/44/44/4
LizenzMITMITApache-2.0MITMITApache-2.0
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

api-screenshot

A screenshot API you run yourself. It takes full-page shots of real sites with the cookie banners, pop-ups, chat widgets and ads removed. It runs on your own Cloudflare account or on any server with Docker.

Examples and docs: apiscreenshot.com. Measured: how many shots Cloudflare's free plan gives and what a server needs to run it.

curl -H "Authorization: Bearer $API_KEY" \

"https://api-screenshot.your-subdomain.workers.dev/screenshot?url=https://www.theguardian.com&full_page=true" -o shot.png

  • Cookie banners, pop-ups, chat widgets and ads removed by default.
  • A captcha, bot check or error page comes back as an error that says so, never as a picture of it.
  • Safe to put on the internet: its own API key, a guard against requests to private addresses, and limits.
  • One API, on your Cloudflare account or on any server with Docker.

Contents: Run it (Cloudflare, your own server, safe by default) · Use it (JSON, signed URLs, caching, options, errors) · Use it from an AI agent · Settings · Ads, trackers and filter lists · Sites that block bots (retries) · Safety · Limits · Develop

Run it

On Cloudflare

The button asks you to sign in to Cloudflare and connect GitHub, then copies this repo to your GitHub account and deploys it to your Cloudflare account. It asks for one secret, API_KEY: paste a long random string, for example from openssl rand -hex 32, and keep it. Your API is then at https://api-screenshot. .workers.dev.

Or from a clone:

git clone https://github.com/matbrons/api-screenshot && cd api-screenshot

npm install npx wrangler login npx wrangler deploy API_KEY=$(openssl rand -hex 32); echo "Your API key: $API_KEY" echo "$API_KEY" | npx wrangler secret put API_KEY

On a new account, the first deploy asks you to pick your workers.dev subdomain. It also creates the KV namespace for the cache and writes its id into wrangler.jsonc, so that file shows as changed afterwards; keep the change. To check it all works (this takes one real shot):

APISHOT_TEST_URL=https://api-screenshot.<your-subdomain>.workers.dev APISHOT_TEST_KEY=$API_KEY ops/watch.sh

It uses Browser Rendering, which the free Workers plan includes with a daily limit (see Limits).

On your own server
API_KEY=$(openssl rand -hex 32); echo "Your API key: $API_KEY"

docker run -d --restart unless-stopped -p 3000:3000 -e API_KEY="$API_KEY" ghcr.io/matbrons/api-screenshot

The image runs on amd64 and arm64. It is published when a version is tagged, so it appears after the first release. To build it yourself instead: docker build -t api-screenshot .

Or without Docker, with Node 22.19 or newer and Chrome or Chromium installed:

npm install

API_KEY=$(openssl rand -hex 32); echo "Your API key: $API_KEY" API_KEY="$API_KEY" HOST=127.0.0.1 npm start

It finds Chrome or Chromium on its own; set CHROME_PATH if it doesn't. HOST=127.0.0.1 keeps it to your own machine; leave it out on a server, where it listens on every address.

The server path uses a real Chromium. Whether it gets past more bot walls than the Worker depends mostly on your server's IP address: see Sites that block bots.

Safe by default

A screenshot API on a public URL lets anyone spend your browser time. So until API_KEY (or SIGNING_SECRET, for signed URLs) is set, every screenshot request is refused with not_configured, and so is a key shorter than 16 characters or one copied from an example. If you really want it open, for example on a private network, set ALLOW_PUBLIC_ACCESS=true.

Use it

# GET with query options

curl -H "Authorization: Bearer $API_KEY" \ "http://localhost:3000/screenshot?url=https://example.com&full_page=true&format=jpeg" -o shot.jpg

POST with a JSON body

curl -X POST http://localhost:3000/screenshot \ -H "Authorization: Bearer $API_KEY" -H "content-type: application/json" \ -d '{"url": "https://example.com", "viewport_width": 390, "viewport_mobile": true}' -o shot.png

The key can also go in an X-API-Key header. It is never taken from the URL, where it would end up in logs and browser history: a request with access_key in the query is refused. To put a shot in an tag or a link, use a signed URL.

A shot comes back as the image (or PDF) itself, with these headers:

HeaderValue
x-final-urlThe URL after redirects
x-target-statusThe HTTP status the site answered with
x-removed-elementsHow many things were removed from the shot: the cookie banner, whether it was answered or hidden, plus each pop-up, backdrop, chat widget or ad that was showing. A banner and its own parts count as one. 0 when there was nothing to remove.
x-consent-managerThe consent tool behind the cookie banner that was removed (see below). Not sent when no banner was removed.
x-page-heightThe page's full height in CSS pixels
x-truncatedtrue when the shot was cut off: the page (or the selector element) was taller than full_page_max_height, or than 16384 device pixels (see Limits)
x-cacheHIT when the shot came from the cache, MISS when it was taken now and kept, BYPASS when the cache wasn't read (fresh, or caching off). See Caching.
ageOn a HIT: seconds since the shot was taken
x-overlay-remainingcookie_banner or popup when one is still on screen in the shot, after every attempt to remove it. Not sent when the shot is clean.

x-consent-manager is one of:

  • The tool's name, for the common ones: OneTrust, Cookiebot, Didomi, Usercentrics, Sourcepoint, TrustArc, Quantcast, consentmanager, CookieYes, Complianz, iubenda, Osano, Shopify and others.
  • For a site with a banner of its own, the name of autoconsent's rule for it, usually the site (airbnb).
  • generic: a banner recognised by its look and words, not by a known tool.

Before the shot, a last check looks for a cookie banner or pop-up that is still covering part of the screen. If it finds one, it presses Escape, then the banner's reject or close button (never accept), and cleans up again. One that survives all that is left in the shot and named in x-overlay-remaining, so you can retry or flag it. A site's own sticky header or menu doesn't count, even when it has a "Sign up" link.

JSON and page details

With response_type=json the answer is JSON instead of the file: the page's details plus the image or PDF in base64. response_type=metadata gives the details alone and skips the shot, which is quicker.

{

"url": "https://example.com/", "final_url": "https://example.com/", "status": 200, "title": "Example Domain", "description": null, "icon": "https://example.com/favicon.ico", "open_graph": { "title": "...", "image": "https://..." }, "page_height": 800, "removed_elements": 0, "consent_manager": null, "overlay_remaining": null, "truncated": false, "content_type": "image/png", "size": 18734, "image": "iVBORw0KGgo..." }

open_graph holds the page's og: tags without the prefix. icon is the page's own icon link, or /favicon.ico when it has none (which may not exist).

Signed URLs

To put a shot straight into an or og:image tag without giving away your key, sign the URL instead. Set a second secret, SIGNING_SECRET (16 characters or more, for example from openssl rand -hex 32; on Cloudflare echo "$SIGNING_SECRET" | npx wrangler secret put SIGNING_SECRET, or add it under the Worker's settings), then add a signature to each URL:

  1. Take every parameter, including expires if you want the link to stop working at some point (a Unix time in seconds).
  2. Sort them by name, percent-encode names and values (everything except A-Z a-z 0-9 - _ . ~) and join them as name=value&name=value.
  3. signature is the HMAC-SHA256 of that string with SIGNING_SECRET, in hex.

Anyone can read a signed URL, but changing, adding or removing any parameter breaks it. A wrong signature gets unauthorized with reason: signature_invalid, an expired one reason: signature_expired. Only GET requests can be signed. Make signed URLs on your server, never in the browser, so the secret stays with you.

In Node.js:

import { createHmac } from 'node:crypto';

const encode = (s) => encodeURIComponent(s).replace(/[!'()*]/g, (c) => %${c.charCodeAt(0).toString(16).toUpperCase()});

function signedUrl(base, options, secret) { const query = Object.keys(options).sort() .map((name) => ${encode(name)}=${encode(String(options[name]))}) .join('&'); const signature = createHmac('sha256', secret).update(query).digest('hex'); return ${base}/screenshot?${query}&signature=${signature}; }

signedUrl('https://api-screenshot.your-subdomain.workers.dev', { url: 'https://example.com', full_page: true, expires: Math.floor(Date.now() / 1000) + 7 * 24 * 3600, // optional: valid for a week }, process.env.SIGNING_SECRET);

In a shell, with the query already sorted and encoded:

QUERY='full_page=true&url=https%3A%2F%2Fexample.com'

SIG=$(printf '%s' "$QUERY" | openssl dgst -sha256 -hmac "$SIGNING_SECRET" -r | cut -d' ' -f1) echo "https://api-screenshot.your-subdomain.workers.dev/screenshot?$QUERY&signature=$SIG"

With only SIGNING_SECRET set and no API_KEY, the API takes signed URLs and nothing else.

Caching

A finished shot is kept for a day, so the same request again comes back at once and costs no browser time. Requests count as the same when their options are, after defaults are filled in: url=example.com and url=https://example.com/ share one shot. Only real shots are kept. A blocked, blank or any other error is never cached, so the next request tries again.

The cache is checked after the key or signature, so a cached shot never goes to someone who couldn't have asked for it. The x-cache header says whether a shot came from the cache. cache-control tells browsers how long they may keep it too: private for requests with the key, public for signed URLs (never past their expires), so a CDN in front can serve them.

On Cloudflare, shots are kept in Workers KV; the deploy creates the namespace for you. On a server they are kept in a folder, CACHE_DIR, up to CACHE_MAX_MB, and the shots used longest ago make room for new ones. In Docker that folder is /var/cache/api-screenshot; add -v api-screenshot-cache:/var/cache/api-screenshot to docker run to keep the shots when the container is replaced.

Options

Option names match the ones common to hosted screenshot APIs, so most requests written for one of those work here unchanged. An unknown option is refused, so a typo doesn't fail silently.

OptionDefaultWhat it does
urlrequiredThe page to shoot. https:// is added when missing.

| html | | Markup to

Nur der Anfang wird gezeigt; den Rest findest du im Repo