English Français العربية

Shotpipe — Screenshots & OG Images

السجل الرسمي الوسائط والتصميم

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • SHOTPIPE_KEY إلزامي Shotpipe API key id (starts with k_). Free at https://shotpipe.io/signup.
  • SHOTPIPE_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.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو Shotpipe — Screenshots & OG Images؟

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

كيف أثبّت Shotpipe — Screenshots & OG Images؟

يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Shotpipe — Screenshots & OG Images إلى مفتاح API؟

نعم. يتطلب SHOTPIPE_KEY, SHOTPIPE_SECRET، وتضبطها في إعداداته.

هل Shotpipe — Screenshots & OG Images مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Shotpipe — Screenshots & OG Images؟

ينشره podop29. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.