English Français العربية

io.github.webmox/screenshotrun-mcp

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

Capture website screenshots in AI agents. Full-page, dark mode, mobile, OG images, base64.

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

ماذا يمكنك أن تفعل مع io.github.webmox/screenshotrun-mcp؟

  • Capture screenshots of any public webpage as PNG, JPEG, WebP, or PDF
  • Device emulation — desktop, mobile, and tablet viewports
  • Dark mode rendering with prefers-color-scheme: dark
  • Full-page capture with automatic scrolling
  • Block ads and cookie consent banners
  • Inject custom CSS/JavaScript before capture
  • Target specific elements with CSS selectors
  • Retina (2x) resolution support

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package screenshotrun-mcp
Claude Code 
claude mcp add screenshotrun-mcp -e 'SCREENSHOTRUN_API_KEY=<SCREENSHOTRUN_API_KEY>' -- npx -y screenshotrun-mcp@1.0.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "screenshotrun-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "screenshotrun-mcp@1.0.3"
            ],
            "env": {
                "SCREENSHOTRUN_API_KEY": "<SCREENSHOTRUN_API_KEY>"
            }
        }
    }
}

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

  • SCREENSHOTRUN_API_KEY إلزامي Your ScreenshotRun API key. Get one free at screenshotrun.com (200 screenshots/month).

التوثيق

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

المحتويات
  1. screenshotrun-mcp
  2. Features
  3. Quick Start
  4. Available Tools
  5. Example Prompts
  6. How It Works
  7. Requirements
  8. Other Projects by ScreenshotRun
  9. License

screenshotrun-mcp

Give your AI agent the ability to see any webpage. MCP server for ScreenshotRun Screenshot API.

Features

  • Capture screenshots of any public webpage as PNG, JPEG, WebP, or PDF
  • Device emulation — desktop, mobile, and tablet viewports
  • Dark mode rendering with prefers-color-scheme: dark
  • Full-page capture with automatic scrolling
  • Block ads and cookie consent banners
  • Inject custom CSS/JavaScript before capture
  • Target specific elements with CSS selectors
  • Retina (2x) resolution support
  • Monitor your API usage and remaining quota

Quick Start

1. Get your API key

Sign up for a free API key at screenshotrun.com.

2. Configure your AI client
Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "screenshotrun": {
      "command": "npx",
      "args": ["-y", "screenshotrun-mcp"],
      "env": {
        "SCREENSHOTRUN_API_KEY": "sr_live_your_key_here"
      }
    }
  }
}
Claude Code
claude mcp add screenshotrun \
  npx -y screenshotrun-mcp \
  -e SCREENSHOTRUN_API_KEY=sr_live_your_key_here
Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "screenshotrun": {
      "command": "npx",
      "args": ["-y", "screenshotrun-mcp"],
      "env": {
        "SCREENSHOTRUN_API_KEY": "sr_live_your_key_here"
      }
    }
  }
}
Windsurf

Add to your Windsurf MCP configuration with the same npx -y screenshotrun-mcp command and set the SCREENSHOTRUN_API_KEY environment variable.

Available Tools

take_screenshot

Capture a screenshot of any webpage. Returns the image as base64-encoded data that AI agents can analyze and describe.

ParameterTypeDefaultDescription
urlstringrequiredURL to screenshot (must include http:// or https://)
formatpng \jpeg \webp \pdfpngOutput image format
widthnumber1280Viewport width in pixels (320–3840)
heightnumber800Viewport height in pixels (200–2160)
full_pagebooleanfalseCapture the entire scrollable page
qualitynumber80Image quality for JPEG/WebP (1–100)
devicedesktop \mobile \tablet—Device preset (overrides width/height with device defaults)
dark_modebooleanfalseEnable dark mode rendering
block_adsbooleanfalseBlock advertisements during capture
block_cookiesbooleantrueBlock cookie consent dialogs
delaynumber0Delay in seconds after page load before capturing (0–10)
retinabooleanfalseCapture at 2x resolution
cssstring—Custom CSS to inject into the page (max 10KB)
jsstring—Custom JavaScript to execute before capture (max 10KB)
selectorstring—CSS selector to capture a specific element
hide_selectorsstring[]—CSS selectors of elements to hide before capture
click_selectorstring—CSS selector of element to click before capture
scroll_tostring—CSS selector of element to scroll into view
check_usage

Check your ScreenshotRun API usage for the current billing period. Returns screenshots used, remaining quota, usage percentage, and days remaining.

No parameters required.

Example Prompts

  • "Take a screenshot of screenshotrun.com"
  • "Screenshot snapshotarchive.com in dark mode on mobile"
  • "Capture full-page screenshot of my website and describe what you see"
  • "Take a retina screenshot of screenshotrun.com in JPEG format"
  • "Screenshot snapshotarchive.com on tablet with ad blocking"
  • "Take a screenshot of my site with the cookie banner hidden using hide_selectors"
  • "Check my ScreenshotRun API usage"

How It Works

  1. Your AI agent receives a user request involving a webpage screenshot
  2. The agent calls the take_screenshot tool with the URL and options
  3. The MCP server sends the request to the ScreenshotRun API
  4. The API renders the page in a real browser and returns the screenshot
  5. The image is returned to the AI agent as base64, which it can analyze and describe

Requirements

Other Projects by ScreenshotRun

  • SnapshotArchive — Automated website monitoring with visual diff detection
  • WatchCron — Cron job & heartbeat monitoring for developers

License

MIT

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

ما هو io.github.webmox/screenshotrun-mcp؟

Capture website screenshots in AI agents. Full-page, dark mode, mobile, OG images, base64.

كيف أثبّت io.github.webmox/screenshotrun-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add screenshotrun-mcp -e 'SCREENSHOTRUN_API_KEY=<SCREENSHOTRUN_API_KEY>' -- npx -y screenshotrun-mcp@1.0.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.webmox/screenshotrun-mcp إلى مفتاح API؟

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

هل io.github.webmox/screenshotrun-mcp مفتوح المصدر؟

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

من يصون io.github.webmox/screenshotrun-mcp؟

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

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