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.

概覽

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 分