terradeed-mcp-server

Terradeed MCP Server

由 x402 驱动的网页抓取和结构化数据提取工具，适用于 AI Agent。

概述

此 MCP 服务将你的 AI Agent 连接到 Terradeed Scrape API，支持：

• 网页抓取 — 从任意 URL 获取整洁、适用于大模型的 Markdown（$0.01 USDC）
• 结构化提取 — 从任意页面获取由架构定义的 JSON 数据（$0.05 USDC）
• 钱包余额查询 — 免费查询 Base 主网上的 USDC 余额

付款通过 Base 主网上的 x402 protocol 使用 USDC 自动处理。

安装

通过 npx 安装（推荐）

TERRADEED_PRIVATE_KEY=0x... npx terradeed-mcp-server

全局安装

npm install -g terradeed-mcp-server
TERRADEED_PRIVATE_KEY=0x... terradeed-mcp-server

环境变量

变量	必填	说明
TERRADEED_PRIVATE_KEY	是	用于签署 x402 付款的 Ethereum 私钥。必须在 Base 主网上持有 USDC。

工具

terradeed_scrape_url

抓取任意公开 URL 并返回整洁的 Markdown。

费用： 每次调用 $0.01 USDC

{
  "url": "https://example.com",
  "render_js": false
}

terradeed_extract_structured

使用架构提取结构化 JSON 数据。

费用： 每次调用 $0.05 USDC

{
  "url": "https://example.com",
  "schema": {
    "type": "object",
    "properties": {
      "title": { "type": "string" },
      "price": { "type": "number" }
    }
  },
  "instructions": "Extract the product title and price"
}

terradeed_check_wallet

查询 Base 主网上的 USDC 余额。免费。

{
  "address": "0x..."
}

配置

添加到你的 MCP 客户端配置中（例如 Claude Desktop、Cursor）：

{
  "mcpServers": {
    "terradeed": {
      "command": "npx",
      "args": ["terradeed-mcp-server"],
      "env": {
        "TERRADEED_PRIVATE_KEY": "your-private-key"
      }
    }
  }
}

链接

• Terradeed
• API 文档
• x402 协议

许可证

MIT