English Français العربية

Shotpipe — Screenshots & OG Images

Registre officiel Médias et design

Screenshot any URL and see it, or mint a social card — hosted, SSRF-safe, cached. No Chrome to run.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package shotpipe-mcp
Claude Code 
claude mcp add shotpipe-screenshots-og-images -e 'SHOTPIPE_KEY=<SHOTPIPE_KEY>' -e 'SHOTPIPE_SECRET=<your shotpipe_secret>' -e 'SHOTPIPE_BASE_URL=<SHOTPIPE_BASE_URL>' -- npx -y shotpipe-mcp@0.1.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "shotpipe-screenshots-og-images": {
            "command": "npx",
            "args": [
                "-y",
                "shotpipe-mcp@0.1.1"
            ],
            "env": {
                "SHOTPIPE_KEY": "<SHOTPIPE_KEY>",
                "SHOTPIPE_SECRET": "<your shotpipe_secret>",
                "SHOTPIPE_BASE_URL": "<SHOTPIPE_BASE_URL>"
            }
        }
    }
}

Variables d'environnement

  • SHOTPIPE_KEY obligatoire Shotpipe API key id (starts with k_). Free at https://shotpipe.io/signup.
  • SHOTPIPE_SECRET obligatoire secret Shotpipe HMAC signing secret. Requests are signed locally; the secret never leaves the process.
  • SHOTPIPE_BASE_URL Override the API base URL for a self-hosted Shotpipe instance. Defaults to https://shotpipe.io.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. shotpipe-mcp
  2. Install
  3. Tools
  4. How it works

shotpipe-mcp

Hosted, SSRF-safe, cached screenshots and Open Graph images for AI agents — no headless Chrome to run.

An MCP server that lets an agent screenshot any URL and see the result, or mint a social-card image, by calling Shotpipe. It's the thing a local browser tool can't be:

  • No Chrome in your agent's sandbox. Rendering happens on Shotpipe's infrastructure. Nothing to install, no memory to babysit, no OOM at 2am.
  • Safe on untrusted URLs. Agents point at URLs their users typed. Shotpipe resolves DNS itself, pins the IP, re-checks every redirect, and refuses private / loopback / cloud-metadata hosts — so a hostile link can't turn your renderer into an SSRF hole.
  • Cached. The first capture renders; every identical one after is served from the edge in milliseconds and costs nothing.

Ad and cookie-consent banners are stripped by default.

Install

// Claude Desktop (claude_desktop_config.json), Claude Code (.mcp.json),
// Cursor, Cline, or any MCP client:
{
  "mcpServers": {
    "shotpipe": {
      "command": "npx",
      "args": ["-y", "shotpipe-mcp"],
      "env": {
        "SHOTPIPE_KEY": "k_your_key",
        "SHOTPIPE_SECRET": "your_signing_secret"
      }
    }
  }
}

Get a free key at shotpipe.io/signup (no card) or run npx shotpipe-init. Self-hosting Shotpipe? Set SHOTPIPE_BASE_URL.

Tools

screenshot

Screenshot a URL and return the image (so the model can see it) plus a permanent, shareable signed URL.

url (required) · format png\|jpeg\|pdf · width · height · dpr · full_page · selector · dark · omit_background · block_ads · block_banners · wait_for · delay · quality · fresh

og_image

Build a signed social-card URL from a hosted template. Returns the URL only by default and renders nothing — the image renders lazily on the first crawler hit, so agent/build time stays fast. Drop it into <meta property="og:image">. Pass render: true to also get a preview image.

title (required) · template · author · tag · accent · logo · width · height · dpr · render

How it works

The signing secret never leaves the process — every request is HMAC-signed locally, exactly like Shotpipe's other clients. The server just builds a signed URL and (for screenshot) fetches the bytes.

MIT · shotpipe.io

Questions fréquentes

Qu'est-ce que Shotpipe — Screenshots & OG Images ?

Screenshot any URL and see it, or mint a social card — hosted, SSRF-safe, cached. No Chrome to run.

Comment installer Shotpipe — Screenshots & OG Images ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add shotpipe-screenshots-og-images -e 'SHOTPIPE_KEY=<SHOTPIPE_KEY>' -e 'SHOTPIPE_SECRET=<your shotpipe_secret>' -e 'SHOTPIPE_BASE_URL=<SHOTPIPE_BASE_URL>' -- npx -y shotpipe-mcp@0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Shotpipe — Screenshots & OG Images ?

Oui. Il attend SHOTPIPE_KEY, SHOTPIPE_SECRET, à renseigner dans sa configuration.

Shotpipe — Screenshots & OG Images est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Shotpipe — Screenshots & OG Images ?

Il est publié par podop29. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.