domscout

@domscout/mcp

使用 domscout 作为 MCP 工具，以 Markdown 格式读取网页、截取屏幕截图、 提取结构化数据、检查交互结构、自动化浏览器流程， 并爬取已加入允许列表的网站。

安装

在 https://www.domscout.io/dashboard/api-keys 创建 API 密钥，然后将 服务添加到客户端。唯一要求是 Node.js 20 或更高版本；npx 会获取并运行它，因此无需安装或构建。

Claude Code

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

Claude Desktop、Cursor、VS Code 及任何其他 MCP 客户端

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

Cursor 和 VS Code 的一键安装按钮位于文档页面。

环境变量

变量	必需	用途
DOMSCOUT_API_KEY	用于工具调用	你的 API 密钥。服务无需密钥即可启动并列出工具；但每次工具调用都需要密钥。
DOMSCOUT_BASE_URL	否	替换当前生产网关，指向有意隔离的部署。
DOMSCOUT_DOCS_BASE_URL	否	获取契约资源（/llms-full.txt、/openapi.json）的地址。它与 DOMSCOUT_BASE_URL 分开设置，因为文档由营销网站提供，而非 API 网关，且该主机没有 /llms-full.txt。默认值为 https://www.domscout.io。

默认目标为 https://api.domscout.io。API 请求不会跟随重定向，因此密钥绝不会重新发送到其他 URL：若 DOMSCOUT_BASE_URL 返回重定向，会报错并指出状态码。请改为指向最终 URL。 连接客户端前，请在控制面板中验证密钥；切勿提交密钥或将其粘贴到提示词中。

工具

工具	费用	功能
domscout_check_credits	免费	余额、配额、速率限制和价格列表
domscout_extract_markdown	1	以整洁的 Markdown 格式读取网页（fast:true 可跳过浏览器）
domscout_capture_screenshot	1–3	截取 PNG/JPEG/WebP/PDF
domscout_extract_data	2	将命名字段提取为有类型的 JSON
domscout_inspect_page	2	读取无障碍树和交互元素
domscout_automate_page	1–2	执行允许的操作并捕获结果
domscout_crawl_site	1/页	执行有界、遵循允许列表且尊重 robots 规则的爬取
domscout_get_job	免费	轮询持久化任务、批次或爬取任务
domscout_cancel_job	免费	取消一个持久化任务
domscout_send_feedback	免费	发送产品反馈

单个请求的费用不会超过 10 个点数。工具结果会包含请求费用和剩余余额。

已完成的屏幕截图、网格、骨架和时间线任务会以 MCP 图片块的形式返回图片。PDF 结果对同步截图和已完成任务采用相同的内联大小限制；更大的 PDF 会返回元数据和检索指引。任务状态和标识符会与截图结果一同提供。

资源

URI	内容
domscout://docs	API 参考
domscout://openapi	OpenAPI 3.1 契约

安全

MCP 服务会向配置的 API 主机发送 x-api-key 并读取响应。它不具备浏览器、数据库或账单凭据。请将密钥保存在 MCP 客户端的环境变量块中；不要提交密钥，也不要将其粘贴到提示词中。

链接

• 文档
• API 参考
• 问题反馈

许可证

MIT。请参阅 LICENSE。