Extracto Mcp

io.github.massanaRoger由 GitHub 帳號 massanaRoger 發布v0.1.2更新於 Oct 24, 2026

Turn any URL plus a schema into validated, typed JSON via the Extracto API.

已驗證STDIO僅桌面網頁搜尋與抓取資料與分析

概覽

AI 產生的概覽

透過 Extracto API 把網址加上欄位結構轉成經過驗證、帶型別的 JSON，並支援同步與非同步擷取工作。

可以做什麼
把 Extracto 擷取 API 提供給 MCP 用戶端。extract 工具對單一網址執行同步擷取（最長約 90 秒），回傳資料與中繼資訊。extract_async 會把繁重或具反爬機制的頁面送出為背景工作並立即回傳工作 id，get_job 可輪詢工作狀態與結果，list_jobs 列出最近的工作。欄位透過名稱對應型別的結構描述來要求，缺少的資料會以 null 回傳，而不是憑空猜測。
適用情境
適合讓助理在不撰寫 HTML 解析器或提示詞的情況下，從網頁取得結構化資料，例如從程式碼倉庫頁面擷取標題、語言與星號數。非同步工具適合會超過同步請求時限的繁重或受機器人防護的頁面。
執行需求
以 stdio 在本機執行，通常透過 npx 啟動 npm 套件 extracto-mcp，因此需要 Node.js 與網路存取。必要的 EXTRACTO_API_KEY 由 MCP 用戶端傳入；選用的 EXTRACTO_BASE_URL 與 EXTRACTO_TIMEOUT_MS 可覆寫 API 主機與單次請求逾時。僅支援桌面用戶端。
安裝前請注意
EXTRACTO_API_KEY 是存放在用戶端設定中的密鑰，會傳送給 Extracto 服務，因此你提交的網址與結構描述也會傳給該第三方。擷取對目標頁面是唯讀的，但非同步工作會被保留並可透過 list_jobs 列出。將 EXTRACTO_BASE_URL 指向其他主機會把密鑰送到該處。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Extracto Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

extracto-mcp

Model Context Protocol server for Extracto. It gives Claude, Cursor, Claude Code, and any MCP client the ability to turn a URL plus a schema into validated, typed JSON — no prompt engineering, no HTML parsing, and no hallucinated fields (missing data comes back as null).

Quick start

You need an Extracto API key. Get one at app.getextracto.dev/keys.

The server runs over stdio and is published to npm, so most clients just need this config block.

Claude Desktop

Edit claude_desktop_config.json (Settings → Developer → Edit Config):

json
{  "mcpServers": {    "extracto": {      "command": "npx",      "args": ["-y", "extracto-mcp"],      "env": { "EXTRACTO_API_KEY": "exa_live_your_key_here" }    }  }}

Cursor

Add to ~/.cursor/mcp.json (or the project .cursor/mcp.json) with the same block.

Claude Code

bash
claude mcp add extracto -e EXTRACTO_API_KEY=exa_live_your_key_here -- npx -y extracto-mcp

Restart the client and ask it to extract something, e.g. "Use extracto to pull the title, language and star count from github.com/facebook/react."

Tools

ToolWhat it does
extractSynchronous extraction from a single URL (up to ~90s). Returns { data, meta }.
extract_asyncSubmit an async job for heavy or anti-bot pages. Returns a job id immediately.
get_jobPoll an async job for status and result.
list_jobsList your recent async jobs.

The schema argument

A schema is an object mapping field names to types. A type is:

  • a literal: "string", "number", "boolean", "array", "object"
  • a one-element array for a list: ["string"], or [{ "title": "string" }]
  • a nested object: { "author": { "name": "string" } }
json
{  "title": "string",  "price": "number",  "tags": ["string"],  "reviews": [{ "user": "string", "stars": "number" }]}

Only fields that are actually found on the page are returned; anything missing is null rather than guessed.

Configuration

All configuration is via environment variables passed by your MCP client:

VariableRequiredDescription
EXTRACTO_API_KEYyesYour key from app.getextracto.dev/keys.
EXTRACTO_BASE_URLnoOverride the API host (defaults to https://app.getextracto.dev).
EXTRACTO_TIMEOUT_MSnoPer-request timeout in ms (default 90000).

Development

bash
npm installnpm run dev        # run from source with tsxnpm run typechecknpm run build      # bundle to dist/ with tsup

Related

License

MIT

來源：README.md，提交 0403e82

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分