Extrapify

Extrapify MCP

在 Claude Desktop、Cursor 或任何兼容 MCP 的客户端中，从任意公开网页提取结构化 JSON。

定义一个架构。输入一个 URL。获取经过验证、带类型的 JSON。

获取 API 密钥 → extrapify.com

---

项目介绍

一个轻量、无状态的 MCP 服务，用于连接 MCP 客户端与托管的 Extrapify API。

提取工作不会在此软件包中进行。MCP 服务会将请求转发到 Extrapify API，由后端负责抓取网页、使用 Browserless 渲染 JavaScript 密集型页面、通过 Claude 提取内容、验证架构、统计配额并进行可观测性监控。

• 基于 stdio 的 MCP 协议服务
• 一个工具：extract_structured_data
• 可用于生产环境的桥接服务，而非爬取框架
• 无提取逻辑、无状态、无副作用

---

安装

npm install

将 .env.example 复制为 .env，并填写你的凭据：

EXTRAPIFY_API_BASE_URL=https://extrapify.com
EXTRAPIFY_API_KEY=sk_live_your_key_here

启动服务：

npm run mcp:start

---

配置 Claude Desktop

将此配置块添加到 Claude Desktop 配置文件（claude_desktop_config.json）中：

{
  "mcpServers": {
    "extrapify": {
      "command": "node",
      "args": ["/absolute/path/to/extrapify-mcp/mcp/server.mjs"],
      "env": {
        "EXTRAPIFY_API_BASE_URL": "https://extrapify.com",
        "EXTRAPIFY_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

重启 Claude Desktop。extract_structured_data 工具将自动显示。

---

配置 Cursor

Cursor 支持 stdio MCP 服务。将其指向 node 和本地的 mcp/server.mjs 入口文件，并设置相同的两个环境变量。

请参阅 docs/mcp-install-examples.md，获取可直接复制粘贴的配置。

---

工具：extract_structured_data

使用你定义的架构，从任意公开网页获取结构化 JSON。

输入：

{
  "url": "https://example.com/article",
  "mode": "auto",
  "schema": {
    "title": "string",
    "author": "string",
    "published_at": "date",
    "tags": "string[]"
  }
}

输出：

{
  "extracted": {
    "title": "How Claude Agents Are Changing Developer Workflows",
    "author": "Jane Smith",
    "published_at": "2026-04-15",
    "tags": ["AI", "agents", "developer tools"]
  },
  "type": "single",
  "count": 1,
  "confidence": 0.96,
  "tokens_used": 1820
}

支持的架构类型： string、number、integer、float、boolean、date、datetime、url，以及这些类型的数组（使用 [] 后缀，例如 string[]）。

支持的 mode 值：

• auto — 由 Extrapify 根据页面结构决定
• single — 仅提取主要条目
• list — 将所有匹配条目提取为数组

---

架构模板

常见用例（产品页面、职位列表、文章、公司数据）的入门架构位于 docs/schema-templates.md。

---

工作流示例

Agent 模式和演示工作流位于 docs/demo-workflows.md。

---

其他兼容客户端

任何支持 stdio 传输的 MCP 客户端都能使用此软件包。通常只需配置：

• command：node
• args：mcp/server.mjs 的绝对路径
• env：EXTRAPIFY_API_BASE_URL 和 EXTRAPIFY_API_KEY

---

故障排除

症状	解决方法
服务立即退出	确认 EXTRAPIFY_API_BASE_URL 是有效的绝对 URL
工具调用返回 401 或 403	在 extrapify.com/dashboard 检查你的 API 密钥
客户端无法发现工具	确认客户端通过 stdio 启动 node 并运行 mcp/server.mjs
请求超时	确认你的设备可以访问 Extrapify API
JavaScript 密集型页面返回空内容	Extrapify 会自动处理 Browserless 回退，无需采取任何操作

---

仓库结构

mcp/
  server.mjs               ← MCP stdio server entrypoint
  tool-registry.mjs        ← tool definitions
  extrapify-client.mjs     ← minimal Extrapify API client
  tools/
    extract-structured-data.mjs
  configs/
    claude-desktop.local.example.json
    claude-desktop.production.example.json
docs/
  mcp-install-examples.md
  schema-templates.md
  demo-workflows.md
  mcp-marketplace-copy.md

---

链接

• API 和定价：extrapify.com
• 文档：extrapify.com/docs
• 控制面板：extrapify.com/dashboard