English Français العربية

io.github.ihen404/x402-scraper-api

Official registry Search and web

Programmatic web-scraping MCP server powered by x402 micro-transactions on Base.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http x402-scraper-api 'https://x402-scraper-api-production-67a4.up.railway.app/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "x402-scraper-api": {
            "type": "http",
            "url": "https://x402-scraper-api-production-67a4.up.railway.app/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. 🌐 x402 Scraper API
  2. ⚡ Quickstart for Developers (Claude Desktop / MCP Clients)
  3. 🛠️ Tool Tiers & Pricing
  4. 🤖 Autonomous Agent Integration (M2M / x402 Protocol)
  5. 📊 Live Telemetry & Monitoring
  6. 🚀 License
  7. 🤖 Claude Code & AI Agent Quickstart

🌐 x402 Scraper API

High-Velocity, Multi-Tiered Web Scraping MCP Server monetized via HTTP 402 micro-payments on Base Mainnet. Designed for autonomous agent swarms, research pipelines, and enterprise LLM workflows.

⚡ Quickstart for Developers (Claude Desktop / MCP Clients)

Add this server configuration to your MCP client settings file (e.g., claude_desktop_config.json) to instantly equip your local AI workspace with paid web scraping tools:

{
  "mcpServers": {
    "x402-scraper": {
      "command": "npx",
      "args": ["-y", "x402-scraper-api"],
      "env": {
        "BASE_RPC_URL": "https://mainnet.base.org"
      }
    }
  }
}

🛠️ Tool Tiers & Pricing

Our scraping infrastructure offers three distinct programmatic tiers tailored for autonomous agents:

Tool NameDescriptionPrice (USDC on Base)
scrape_basicFast DOM parsing & clean Markdown extraction from static HTML.$0.01
scrape_dynamicHeadless browser rendering for JavaScript-heavy, dynamic web apps.$0.05
scrape_structuredScrapes a web page and parses raw content directly into a requested JSON Schema.$0.15

🤖 Autonomous Agent Integration (M2M / x402 Protocol)

Autonomous scout agents and agent swarms can programmatically discover tool definitions via our server card and execute x402 payment challenges on the fly.

Direct Endpoint Usage
  • Base URL: https://x402-scraper-api-production-67a4.up.railway.app
  • MCP Gateway: https://x402-scraper-api-production-67a4.up.railway.app/mcp
  • Server Card: https://x402-scraper-api-production-67a4.up.railway.app/.well-known/mcp/server-card.json
  • Telemetry: https://x402-scraper-api-production-67a4.up.railway.app/telemetry
Sample JavaScript Client Request

Agents can invoke tools using standard JSON-RPC over HTTP:

const response = await fetch("https://x402-scraper-api-production-67a4.up.railway.app/mcp", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    jsonrpc: "2.0",
    method: "tools/call",
    params: {
      name: "scrape_structured",
      arguments: {
        url: "https://example.com/target-data",
        jsonSchema: { title: "string", price: "number" }
      }
    },
    id: 1
  })
});

const result = await response.json();
console.log(result);

📊 Live Telemetry & Monitoring

Our production infrastructure maintains real-time telemetry tracking request velocity, active sessions, and revenue milestones. Inspect current uptime and metrics programmatically:

curl -s https://x402-scraper-api-production-67a4.up.railway.app/telemetry

🚀 License

MIT © 2026 x402 Scraper API

🤖 Claude Code & AI Agent Quickstart

Give your autonomous agents (Claude Code, ElizaOS, Cursor) native paywall-scraping capabilities using x402 micro-payments on Base or Solana. No API key subscriptions required.

Install via Claude Code

Clone the repository into your local workspace or agent environment:

git clone [https://github.com/your-username/x402-scraper-api.git](https://github.com/your-username/x402-scraper-api.git)

Frequently asked questions

What is io.github.ihen404/x402-scraper-api?

Programmatic web-scraping MCP server powered by x402 micro-transactions on Base.

How do I install io.github.ihen404/x402-scraper-api?

It runs as a remote server. In Claude Code: claude mcp add --transport http x402-scraper-api 'https://x402-scraper-api-production-67a4.up.railway.app/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.ihen404/x402-scraper-api need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.ihen404/x402-scraper-api open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.ihen404/x402-scraper-api?

It is published by ihen404. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.