Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

API Screenshot

by matbronsversion 0.1.2i★ 0iComputer or cloudOfficial site ↗
Registry nameio.github.matbrons/api-screenshot

How to install

What it does

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

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

Use together with

Skills that teach the AI this kind of work; they work alongside this one

timesfm

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

by google-research★ 35,6291 skills

Skill · How-to guide

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…

by BigBodyCobain★ 11,6021 skills

Skill · How-to guide

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

by gosom★ 8,2091 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score12/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install API Screenshot. Follow https://mcp.popnx.com/i/matbrons-api-screenshot.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · What you ask goes through the maker’s server ({host}) · ✓ Commands checked Nov 16, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

You need a API Screenshot key (create it on the maker’s site) · The address has {…} parts you must replace with your own first · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Sign up and create a API Screenshot key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the API Screenshot site ↗

  2. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

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

    Under Request headers, add this name and value

    Header nameAuthorization
    ValueBearer <paste your key here>

    Paste the key only into the app’s field, never into a chat or to anyone

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  4. Turn it on in a chat

    +ConnectorsAPI Screenshot

  5. Try it

    Use API Screenshot and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using API Screenshot or shows a API Screenshot tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect API Screenshot yet

API Screenshot needs your own key to connect, but OpenAI’s help page only describes OAuth sign-in; there is no key option we could verify

What you can do instead

A · Use an app that can connect API Screenshot

  • You need a API Screenshot key (create it on the maker’s site) · The address has {…} parts you must replace with your own first · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it
  • You need a API Screenshot key (create it on the maker’s site) · The address has {…} parts you must replace with your own first
  • You need a API Screenshot key (create it on the maker’s site) · The address has {…} parts you must replace with your own first
  • You need a API Screenshot key (create it on the maker’s site) · The address has {…} parts you must replace with your own first

B · Others in Web & browsers that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

You need a API Screenshot key (create it on the maker’s site) · The address has {…} parts you must replace with your own first

  1. Sign up and create a API Screenshot key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the API Screenshot site ↗

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

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

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  4. Type /mcp in Claude Code

    You should see API Screenshot listed as connected

  5. Try it

    Use API Screenshot and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using API Screenshot or shows a API Screenshot tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a API Screenshot key (create it on the maker’s site) · The address has {…} parts you must replace with your own first

  1. Sign up and create a API Screenshot key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the API Screenshot site ↗

  2. Open Cursor’s MCP settings file

    ~/.cursor/mcp.json

    Paste these settings, fill in the empty values and save

    {
      "mcpServers": {
        "api-screenshot": {
          "url": "https://{host}/mcp",
          "headers": {
            "Authorization": "Bearer {api_key}"
          }
        }
      }
    }
  3. Fill in your key

    In the API Screenshot settings, Authorization is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  4. Open the AI chat in Cursor in Agent mode

  5. Try it

    Use API Screenshot and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using API Screenshot or shows a API Screenshot tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a API Screenshot key (create it on the maker’s site) · The address has {…} parts you must replace with your own first

  1. Sign up and create a API Screenshot key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the API Screenshot site ↗

  2. Open VS Code’s MCP settings file

    MCP: Open User Configuration

    Paste these settings, fill in the empty values and save

    {
      "servers": {
        "api-screenshot": {
          "type": "http",
          "url": "https://{host}/mcp",
          "headers": {
            "Authorization": "Bearer {api_key}"
          }
        }
      }
    }
  3. Fill in your key

    In the API Screenshot settings, Authorization is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  4. Open the AI chat in VS Code in Agent mode

  5. Try it

    Use API Screenshot and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using API Screenshot or shows a API Screenshot tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://{host}/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use API Screenshot💬 Discussion →
For developers: Terminal commands and JSON settings

Over the 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}"
      }
    }
  }
}

Installed on your computer

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"
      }
    }
  }
}

Values you fill in

  • API_KEY secret required env
    Key every request must carry, 16 characters or more. Make one with: openssl rand -hex 32
  • PORT env
    Port the API listens on
  • Authorization secret required HTTP header

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Computer or cloud
Transport
streamable-http
Latest versioni
0.1.2
Published to registryi
Nov 16, 2026
Code last changedi
Nov 16, 2026
Last checked
Nov 16, 2026
Maker
matbrons
Packages
oci: ghcr.io/matbrons/api-screenshot:0.1.2
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

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

Run on your computer in

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

All apps, with pros and cons →

Related guides

What it can do

The address needs your own values, so we cannot read the tool list for you.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account matbrons, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 3 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    The address needs your own account values, so we cannot check it for you

  • – Not applicable

    Sign-in with OAuth

    The address needs your own account values, so we cannot check it for you

  • … Not checked yet

    No hidden instructions in tool descriptions

    Not checked yet; we read the tool list when we check the endpoint

Published vulnerabilities (OSV.dev)

Not checked: only npm and PyPI packages with a version can be checked

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

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

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Web & browsersi

  • More stars than 0% of the other 1613 servers in this category
  • Published to the registry more recently than 88% of the other 1613 servers in this category
  • Basic checks equal to or better than 99% of the other 1613 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is API Screenshot safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: Authorization, API_KEY

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed 3 days ago, and the latest version (0.1.2) reached the registry 3 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: Browser Use, changedetection.io (official), Apify MCP Server, Pomerado, Actionbook

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Browser Use

Lets AI do web tasks for you, such as filling forms, searching and extracting data, in the maker’s cloud browsers or on your computer.

by browser-useWidely used↓ 1.7M/wk★ 121.4KUpdated 29 days ago

Computer or cloud✓ service owner · browser-use.com

Apify MCP Server

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

by apifyWidely used★ 16.9KUpdated 2 days ago

Runs in the cloud✓ service owner · apify.com

Pomerado

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

by PomeradoGrowing★ 1.8KUpdated yesterday

Runs in the cloud✓ service owner · pomerado.ai

Actionbook

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

by actionbookGrowing★ 1.6KUpdated 31 days ago

Runs in the cloud✓ service owner · actionbook.app
Compared with similar ones
This one
API Screenshot
Browser Usechangedetection.io (official)Apify MCP ServerPomeradoActionbook
Runs whereCloud or install on your computerCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyYesYesNoYesNoNo
Add with + in ClaudeNoYesNoNoNoNo
Basic checks3/35/53/34/44/44/4
LicenseMITMITApache-2.0MITMITApache-2.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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

Only the beginning is shown; read the rest in the repo