Screenshotrun Mcp

io.github.webmox由 GitHub 帳號 webmox 發布v1.0.3更新於 Oct 30, 2026

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

已驗證STDIO僅桌面瀏覽器自動化媒體與設計

概覽

AI 產生的概覽

讓助理透過 ScreenshotRun API 擷取公開網頁的截圖，並查詢帳戶剩餘額度。

可以做什麼
  • 將網頁擷取為 PNG、JPEG、WebP 或 PDF，可設定視窗尺寸、裝置預設、深色模式、2 倍解析度、整頁截圖與元素選擇器
  • 截圖前修改頁面：注入 CSS 或 JavaScript、隱藏元素、點擊或捲動至指定選擇器、封鎖廣告與 Cookie 彈窗
  • 查詢目前計費週期的 API 用量，包括已用截圖數、剩餘額度、使用百分比與剩餘天數
適用情境
適合需要讓助理查看或描述線上網頁、產生視覺快照供審閱，或在不執行本機瀏覽器的情況下取得行動版、深色模式、整頁等不同呈現結果時使用。
執行需求
透過 npx 在本機執行，需要 Node.js 18+。需要 ScreenshotRun API 金鑰，透過環境變數 SCREENSHOTRUN_API_KEY 提供；可免費申請，含每月截圖額度。需要能連線至 ScreenshotRun API 的網路。
安裝前請注意
API 金鑰是可計費的憑證，會存放在用戶端設定中，請避免放入共用檔案。每次截圖都會傳送至 ScreenshotRun 服務，所截取的網址會揭露給該第三方。注入的 JavaScript 與 CSS 會在目標頁面上執行，截圖會消耗帳戶的每月額度。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Screenshotrun Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

screenshotrun-mcp

[npm version] [License: MIT]

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):

json
{  "mcpServers": {    "screenshotrun": {      "command": "npx",      "args": ["-y", "screenshotrun-mcp"],      "env": {        "SCREENSHOTRUN_API_KEY": "sr_live_your_key_here"      }    }  }}
Claude Code
bash
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:

json
{  "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

來源：README.md，提交 8ce67d5

工具

2

take_screenshot

Capture a screenshot of any webpage. Returns the image as base64-encoded data. Supports custom viewport sizes, device emulation, dark mode, full-page capture, ad blocking, and more.

輸入參數jscssurl必填delaywidthdeviceformatheightretinaqualityselectorblock_ads另有 6 個

check_usage

Check your ScreenshotRun API usage for the current billing period. Shows screenshots used, remaining, and limits.

無需輸入參數。

版本歷史

1
  1. v1.0.3最新Oct 22, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分