domscout

io.github.jkresearch8由 GitHub 账号 jkresearch8 发布v1.0.8更新于 Oct 24, 2026

domscout browser API as MCP tools: screenshots, Markdown, structured data, page automation, crawls.

已验证STDIO仅桌面网页搜索与抓取浏览器自动化

概览

AI 生成的概览

本地 MCP 服务器，将 domscout 浏览器 API 封装为工具，让助手把网页读成 Markdown、截图、提取结构化数据、自动化页面操作并抓取站点。

可以做什么
  • 将网页读取为干净的 Markdown，可选择跳过浏览器
  • 截取 PNG、JPEG、WebP 或 PDF 截图
  • 按名称提取字段为带类型的 JSON，并读取无障碍树与可交互元素
  • 执行允许的页面操作并捕获结果，运行有边界且遵守白名单的抓取
  • 轮询或取消持久任务与批次，查询额度、配额与价格，并发送反馈
  • 读取 API 参考与 OpenAPI 契约资源
适用场景
适合需要让助手读取或截取实时网页、从中提取结构化字段、执行简单浏览器流程，或在白名单范围内抓取站点，而不想自建浏览器环境的场景。
运行要求
通过 npx 在本地运行，需要 Node.js 20 或更高版本。调用工具需在 DOMSCOUT_API_KEY 中提供 domscout API 密钥；没有密钥时服务器仍可启动并列出工具。可选 DOMSCOUT_BASE_URL 与 DOMSCOUT_DOCS_BASE_URL 用于覆盖 API 与文档主机。需要能访问 domscout API 的网络。
安装前请注意
工具调用会计费到密钥所属账户，每次调用按积分计价，单次请求最多 10 积分，建议先查询余额。密钥以 x-api-key 请求头发送到所配置的 API 主机，应只放在客户端环境变量中，不要写入提示词或提交到代码库。页面自动化与抓取会作用于真实网站，页面内容会发送给第三方服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 domscout，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@domscout/mcp

Use domscout as MCP tools to read pages as Markdown, capture screenshots, extract structured data, inspect interactive structure, automate browser flows, and crawl allowlisted sites.

Install

Create an API key at https://www.domscout.io/dashboard/api-keys, then add the server to your client. Node.js 20 or newer is the only requirement; npx fetches and runs it, so there is nothing to install or build.

Claude Code

bash
claude mcp add --transport stdio --env DOMSCOUT_API_KEY=YOUR_API_KEY domscout -- npx -y @domscout/mcp

Claude Desktop, Cursor, VS Code, and any other MCP client

json
{  "mcpServers": {    "domscout": {      "command": "npx",      "args": ["-y", "@domscout/mcp"],      "env": {        "DOMSCOUT_API_KEY": "YOUR_API_KEY"      }    }  }}

One-click install buttons for Cursor and VS Code are on the documentation page.

Environment

VariableRequiredPurpose
DOMSCOUT_API_KEYFor tool callsYour API key. The server starts and lists its tools without one; every tool call needs it.
DOMSCOUT_BASE_URLNoOverrides the current production gateway for an intentionally separate deployment.
DOMSCOUT_DOCS_BASE_URLNoWhere the contract resources (/llms-full.txt, /openapi.json) are fetched from. Separate from DOMSCOUT_BASE_URL because the docs are served by the marketing site, not the API gateway, and that host has no /llms-full.txt. Defaults to https://www.domscout.io.

The default targets https://api.domscout.io. API requests do not follow redirects, so the key is never re-sent to another URL: a DOMSCOUT_BASE_URL that answers with a redirect fails with an error naming the status. Point it at the final URL instead. Verify the key in the dashboard before connecting a client; never commit or paste the key into prompts.

Tools

ToolCostWhat it does
domscout_check_creditsfreeBalance, quota, rate limit, and price list
domscout_extract_markdown1Read a page as clean Markdown (fast:true skips the browser)
domscout_capture_screenshot1–3Capture PNG/JPEG/WebP/PDF
domscout_extract_data2Extract named fields as typed JSON
domscout_inspect_page2Read the accessibility tree and interactive elements
domscout_automate_page1–2Run allowed actions and capture the result
domscout_crawl_site1/pageRun a bounded, allowlisted, robots-respecting crawl
domscout_get_jobfreePoll a durable job, batch, or crawl
domscout_cancel_jobfreeCancel one durable job
domscout_send_feedbackfreeSend product feedback

A request never costs more than 10 credits. Tool results include the request cost and remaining balance.

Completed screenshot, grid, skeleton and timeline jobs return images as MCP image blocks. PDF results use the same inline size limit for synchronous captures and completed jobs; larger PDFs return metadata and retrieval guidance. Job status and identifiers remain available alongside the capture result.

Resources

URIContents
domscout://docsAPI reference
domscout://openapiOpenAPI 3.1 contract

Security

The MCP server sends an x-api-key to the configured API host and reads the response. It has no browser, database, or billing credential. Keep the key in the MCP client environment block; do not commit it or paste it into prompts.

Links

License

MIT. See LICENSE.

来源：README.md，提交 181213c

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

4
  1. v1.0.8最新Oct 3, 2026
  2. v1.0.6Sep 23, 2026
  3. v1.0.5Sep 20, 2026
  4. v1.0.4Sep 18, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分