localscreenshot

localscreenshot - 截图 API 和 MCP 服务

从 227 个国家/地区截取任意公开网页的屏幕截图，并隐藏 Cookie 横幅和广告。你可以通过 REST API 在代码中使用，也可以通过 Model Context Protocol 在 AI 助手中使用。

此仓库是托管服务的公开文档，包含 MCP 端点、工具、客户端配置和注册清单。服务本身运行于 localscreenshot.com，命令行客户端位于 localscreenshot-cli。

快速开始，无需 API 密钥

任何 HTTP MCP 客户端都可以连接到免费端点。真实截图，无需注册：

{
  "mcpServers": {
    "localscreenshot": {
      "type": "http",
      "url": "https://api.localscreenshot.com/mcp/free"
    }
  }
}

它无需凭据即可响应 initialize、tools/list、prompts/list 和 resources/list，并提供三个工具：截取三个示例页面之一的真实截图、获取国家/地区列表，以及查看价格。它无法截取你指定的页面。

作为插件使用

此仓库遵循 Open Plugins 标准，因此目录扫描可以发现它：plugin.json 记录其身份，mcp.json 声明连接信息。两者都指向上面的免费端点，因此安装后即可使用，并提供下方列出的三个演示工具。

若要通过同一个插件截取你指定的页面，请将 mcp.json 中的 url 替换为下一节中的密钥配置，并添加 headers 块。其他内容无需更改，工具也相同，只是不再局限于示例页面。

使用自己的密钥

免费账户每月可获得 50 个积分，无需银行卡：localscreenshot.com/signup。在控制面板的 Connect 下创建密钥。

{
  "mcpServers": {
    "localscreenshot": {
      "type": "http",
      "url": "https://api.localscreenshot.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code，一行配置：

claude mcp add --transport http localscreenshot https://api.localscreenshot.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

各工具的配置均根据其自身文档编写：localscreenshot.com/mcp 和 docs.localscreenshot.com/agent。

工具

使用密钥时：

工具	功能
take_screenshot	截取屏幕截图。返回图像、页面标题、最终地址和状态，以及剩余积分。
list_countries	列出可以从中截取屏幕截图的国家/地区。
get_credits	显示剩余积分。

使用免费端点时：

工具	功能
take_demo_screenshot	在两种设备之一上截取三个示例页面之一的真实截图。
list_countries	相同的国家/地区列表，无需密钥。
get_pricing	显示服务的积分费用。

take_screenshot 接受与 API 相同的选项，但不包括 async 和 response：服务会等待图片生成，并决定如何返回图片。除非你指定其他宽度，否则图片会缩小至 1,568 像素宽，以便视觉模型清晰读取，同时避免浪费令牌。PDF 或超过 4 MB 的图像会以短时有效的下载链接返回，而不是作为附件。错误会以包含错误代码的纯文本句子返回。

选项

take_screenshot 提供 API 的 28 个参数，不包括 async 和 response：服务会等待图片生成，并决定如何返回图片。

参数	类型	作用
url	string	要截取的公开 http 或 https 页面。
country	string	从此国家加载页面，使用 ISO 3166-1 alpha-2 代码。费用为 2 个额度，而不是 1 个。响应会报告实际检测到的国家。如果无法获取，请求将失败且不收费。
viewport	string	屏幕尺寸，格式为 WIDTHxHEIGHT，例如 1440x900。这是下面两个参数的快捷方式。
viewport_width	integer	浏览器窗口的宽度，单位为像素。
viewport_height	integer	浏览器窗口的高度，单位为像素。启用 full_page 时，图片会比此高度更高。
full_page	boolean	截取整个可滚动页面，而不是仅截取可见部分。
device	string	以此设备进行截取，包括屏幕尺寸、像素密度和移动浏览器。可选值：desktop、desktop_hd、laptop、ipad、ipad_pro、ipad_mini、iphone_15、iphone_15_pro_max、iphone_se、pixel_8、galaxy_s24。
orientation	string	将手机或平板竖着（portrait）或横着（landscape）使用。需要选择手机或平板设备。
device_scale_factor	number	像素密度。2 会生成更清晰、尺寸更大的图片。
format	string	png、jpeg、webp，或将整个页面保存为文档的 pdf。
quality	integer	jpeg 和 webp 的质量。对 png 和 pdf 无效。
selector	string	仅截取与此 CSS 选择器匹配的第一个元素。
max_width	integer	将图片缩小到此宽度。适合缩小图片，以便视觉模型处理。
click_text	string	点击一个可见的按钮、标签页或其他可点击元素，通过访客看到的文字指定，例如“显示全部”。只点击一次，不输入文字。额外收费 1 个额度。
click_selector	string	执行相同的点击操作，通过恰好匹配一个元素的 CSS 选择器指定。了解页面代码时可使用。只点击一次，不输入文字。额外收费 1 个额度。
wait_for	string	等待与此 CSS 选择器匹配的元素显示。
delay_ms	integer	截取前额外等待的时间，单位为毫秒。
block_cookie_banners	boolean	移除大多数 Cookie 横幅。过滤器无法识别的横幅仍会出现在图片中。
block_ads	boolean	屏蔽广告。
block_chat_widgets	boolean	隐藏聊天气泡。
close_popups	boolean	关闭弹出窗口和新闻通讯浮层。
hide_sticky_elements	boolean	隐藏固定在屏幕上的页眉、栏和按钮。
hide_selectors	array	隐藏所有与这些 CSS 选择器匹配的元素。
disable_animations	boolean	冻结动画和过渡效果。
color_scheme	string	要求页面使用 light 或 dark 主题。
language	string	浏览器语言，例如 fr 或 fr-FR。如果未设置，从某个国家截取的屏幕截图会使用该国的主要语言。
timezone	string	浏览器时区，例如 Europe/Paris。如果未设置，从某个国家截取的屏幕截图会使用该国的主要时区。
user_agent	string	页面接收的 User-Agent。可以使用预设值（googlebot、googlebot_mobile），也可以填写自己的字符串。适合比较网站向爬虫和访客展示的内容。无法骗过会检查爬虫地址的网站。

详细信息：截取屏幕截图。

费用

• 截取屏幕截图需 1 个额度，从指定国家截取需 2 个额度。截取失败不收费。
• 每个自然月有 50 个免费额度，无需提供银行卡。未用完的额度不会结转。
• 免费账户每分钟可发送 10 个请求，并可同时运行 2 个屏幕截图任务。
• 套餐和额度包：localscreenshot.com/pricing。

国家/地区

227 个国家/地区，从 AD 安道尔开始。列表由 GET https://localscreenshot.com/v1/countries 提供，详见国家/地区与证明。针对特定国家/地区的截图响应会报告实际检测到的国家/地区；如果无法从该国家/地区获取截图，请求会失败且不会收费。

REST API

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://localscreenshot.com/v1/screenshot?url=https://example.com"

响应内容是图像。添加 response=json 可获取图像链接、页面详情和证明。使用 JSON 请求体发送 POST 请求效果相同。后台截图会返回一个 ID，可通过 /v1/screenshots/{id} 查询。

• OpenAPI：localscreenshot.com/v1/openapi.json
• 文档：docs.localscreenshot.com/overview
• 面向 AI 工具：llms.txt

命令行

npx localscreenshot https://example.com --full-page
pipx run localscreenshot https://example.com --country BR

这两个软件包均基于 localscreenshot-cli 构建，无需依赖，也不包含遥测。密钥来自 LOCALSCREENSHOT_API_KEY，或通过 localscreenshot login 获取。

它不提供的功能

它无法登录网站、破解 CAPTCHA 或绕过付费墙。它只会截取公开页面。

链接

• 服务：localscreenshot.com
• 文档：docs.localscreenshot.com
• 控制面板和 API 密钥：localscreenshot.com/dashboard
• 命令行客户端：localscreenshot-cli
• MCP 注册表条目：com.localscreenshot/localscreenshot

许可证

MIT。参见 LICENSE。