shotbot-mcp

Name: shotbot-mcp
Author: shotbot.net

本地服务

@shotbot.net浏览器自动化

关于 shotbot-mcp

面向 AI Agent 的截图 API：可将任意公开 URL 截取为 JPEG、PNG、WebP、AVIF 或 PDF。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "net-shotbot-shotbot": {
      "command": "npx",
      "args": [
        "-y",
        "shotbot-mcp"
      ],
      "env": {
        "SHOTBOT_API_KEY": "<SHOTBOT_API_KEY>"
      }
    }
  }
}

启动命令npx -y shotbot-mcp

需要配置的环境变量

SHOTBOT_API_KEY密钥Your Shotbot API key (12 characters). Get a free one at https://www.shotbot.net/screenshot-api-key/

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmshotbot-mcp2.0.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
cdn	boolean	否	为 true 时，将结果发布到公共 CDN 并返回永久图像 URL。默认情况下，捕获内容为私有（不会上传到 CDN）；请通过 get_status 返回的下载 URL 获取，这些内容会一直可供获取，直到短暂的保留期结束后自动过期。
url	string	是	要捕获的公开 http/https URL（必填）
nojs	boolean	否	加载页面前禁用 JavaScript。
wait	integer	否	页面加载后、捕获前等待的秒数。免费版：0-5，Pro：0-30。默认值：5。
frame	enum	否	渲染图像周围合成的装饰边框（PDF 时忽略）。变体：rounded（圆角裁切，无内边距）、shadow（投影 + 圆角）、browser_chrome / browser_chrome_dark（带红绿灯按钮 + URL 栏的浏览器窗口，浅色/深色）、mobile/mobile_light（智能手机模型，深色/浅色边框）、tablet/tablet_light（平板模型，深色/浅色边框）、laptop（笔记本电脑模型）、polaroid（白色边框 + 柔和阴影）、gradient（浅绿渐变背景上的圆角截图）、shotbot_brand（浅绿角括号）。免费账户在任何非空边框的右下角都会显示一个很小的 shotbot.fr/.net 标记。Pro 账户的所有变体均使用干净边框。 \| rounded \| shadow \| browser_chrome \| browser_chrome_dark \| mobile \| mobile_light \| tablet \| tablet_light \| laptop \| polaroid \| gradient \| shotbot_brand
hidpi	boolean	否	以 2× 设备像素比（Retina / HiDPI）渲染。输出分辨率翻倍。
ratio	string	否	裁剪比例，例如 "16:9"（默认）、"4:3"、"1:1"、"9:16"。
format	enum	否	输出格式。默认值：jpg。png、webp、webp_lossless、avif、pdf 仅限 Pro（非 Pro 账户仅可使用 jpg）。jpg \| png \| webp \| webp_lossless \| avif \| pdf
preset	enum	否	命名的输出组合 \| 填充 viewport_width / output_size / crop_height。og=1200×630（社交卡片），mobile=390×844（iPhone），square=1080×1080，reel=1080×1920，pinterest=1000×1500，youtube_thumbnail=1280×720，tablet=768×1024。Pro 预设：desktop=1440×900，desktop_hd=1920×1080，twitter_header=1500×500，linkedin_banner=1584×396，hero_banner=1920×600。 \| og \| mobile \| youtube_thumbnail \| square \| reel \| pinterest \| tablet \| desktop \| desktop_hd \| twitter_header \| linkedin_banner \| hero_banner
cookies	array	否	导航前注入的 Cookies（例如，用于捕获需要登录的页面）。最多 50 个。仅限 Pro。
fullpage	boolean	否	捕获整个页面的高度（最多 30000 px）。默认值：false。
selector	string	否	CSS 选择器：将输出裁剪为匹配的元素。仅限 Pro，PDF 除外。
block_ads	boolean	否	屏蔽广告和跟踪器。仅限 Pro。
http_auth	object	否	用于受密码保护页面的 HTTP Basic Auth 凭据。仅限 Pro。
http_auth.pass	string	否
http_auth.user	string	是
pdf_scale	number	否	PDF 渲染缩放比例，0.10-2.00（仅当 format=pdf 时）。默认值：1.0。
scroll_to	string	否	捕获前滚动到视口中的元素 CSS 选择器（框架顶部对齐）。通常为元素 ID，例如 "#pricing"。通过 querySelector 解析。与 selector 不同，它不会裁剪输出。不能与 scroll_offset_px 同时使用；找不到元素时不执行任何操作。fullpage/PDF/selector 时不执行任何操作。仅限 Pro。
crop_height	integer	否	自定义输出高度（px），从顶部裁剪。最大 30000。仅限 Pro。
output_size	integer	否	输出图像宽度（px）。默认为 viewport_width。
callback_url	string	否	完成后将结果 POST 到此 HTTPS URL。跳过轮询。
color_scheme	enum	否	模拟 prefers-color-scheme 媒体查询。dark \| light
pdf_landscape	boolean	否	以横向方向渲染 PDF（仅当 format=pdf 时）。
pdf_margin_mm	integer	否	PDF 页面边距，单位为毫米，范围为 0–50（仅适用于 format=pdf）。默认值为 10。
pdf_page_size	enum	否	PDF 页面尺寸（仅适用于 format=pdf）。默认值为 A4。A4 \| A3 \| A5 \| Letter \| Legal \| Tabloid
render_region	enum	否	地理渲染位置，使用真实的本地 IP。默认位置 fr-paris 免费；ca-montreal、sg-singapore（测试版）、au-sydney（测试版）、vn-hanoi（测试版）为 Pro 功能。 \| fr-paris \| ca-montreal \| sg-singapore \| au-sydney \| vn-hanoi
viewport_width	integer	否	浏览器视口宽度，单位为 px。免费可选：390、768、1280。Shotbot Pro：可自定义任意宽度，范围为 280–3840（用于 CSS／响应式测试）。默认值：1280。
autoplay_videos	boolean	否	使用 --autoplay-policy=no-user-gesture-required 启动 Chromium，使未静音的 <video autoplay> 元素无需用户手势即可开始播放。适用于带有主视觉视频的页面。仅限 Pro。
callback_secret	string	否	在回调负载中回传的共享密钥，用于验证。
dismiss_cookies	enum	否	自动处理 Cookie 横幅。仅限 Pro。 \| accept \| reject
omit_background	boolean	否	使用透明的视口背景进行渲染（Chromium omitBackground）。PNG/WebP/AVIF 中可见；JPG 会填充为黑色。对 PDF 无效。仅限 Pro。
scroll_offset_px	integer	否	捕获前向下滚动指定的 px 数（0–30000），使画面从更靠下的位置开始。不能与 scroll_to 同时使用。对 fullpage/PDF/selector 无效。仅限 Pro。
emulate_print_media	boolean	否	捕获前应用页面的打印样式表（page.emulateMediaType("print")）。适用于将打印布局捕获为图像。对 PDF 没有额外影响（PDF 已处于打印模式）。仅限 Pro。
scroll_before_capture	boolean	否	捕获前滚动浏览整个页面，以渲染延迟加载的内容（图像、无限滚动内容以及首屏以下的内容）。建议与 fullpage=true 一起使用。仅限 Pro。
prefers_reduced_motion	boolean	否	模拟 prefers-reduced-motion: reduce CSS 媒体特性。构建良好的网站会利用它跳过或缩短动画（framer-motion、GSAP、AOS、IntersectionObserver reveals），使捕获结果显示动画稳定后的状态，而不是动画中途的画面。免费套餐可用。