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 分