English Français العربية

io.github.ihen404/x402-scraper

Official registry Search and web

Autonomous HTTP 402 Web Scraping Mesh on Base for $0.02 USDC.

Source code Documentation

What can you do with io.github.ihen404/x402-scraper?

  • Zero API Keys Required: Agents discover, pay, and execute scraping requests mid-task without unhandled API key exceptions or rate limits.
  • Predictable Operational Cost: Flat $0.02 USDC/request settlement on Base, offering a transparent OpEx alternative to dynamic per-gigabyte proxy services.
  • Token-Optimized Markdown: HTML, navigation boilerplate, and DOM elements are automatically stripped into clean, token-dense Markdown to reduce LLM context window costs.
  • Asynchronous Queue Resilience: Underpinned by a decoupled better-sqlite3 queue and PM2 worker mesh to prevent payload failures under high concurrency.
  • Ecosystem Ready: Native support for Model Context Protocol (MCP) manifests (/mcp.json) and ERC-8004 identity registration on Base.

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 'https://your-domain.com/mcp.json'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "x402-scraper": {
            "type": "http",
            "url": "https://your-domain.com/mcp.json"
        }
    }
}

Documentation

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

Contents
  1. @ihentrel/x402-scraper-langchain
  2. Key Features & Strategic Positioning
  3. Quickstart
  4. Model Context Protocol (MCP) Integration
  5. On-Chain Verification
  6. License

@ihentrel/x402-scraper-langchain

Protocol-native web scraping utility tool engineered for autonomous AI agents, powered by Coinbase AgentKit, LangChain, and x402 on-chain micro-settlements.

Key Features & Strategic Positioning

  • Zero API Keys Required: Agents discover, pay, and execute scraping requests mid-task without unhandled API key exceptions or rate limits.
  • Predictable Operational Cost: Flat $0.02 USDC/request settlement on Base, offering a transparent OpEx alternative to dynamic per-gigabyte proxy services.
  • Token-Optimized Markdown: HTML, navigation boilerplate, and DOM elements are automatically stripped into clean, token-dense Markdown to reduce LLM context window costs.
  • Asynchronous Queue Resilience: Underpinned by a decoupled better-sqlite3 queue and PM2 worker mesh to prevent payload failures under high concurrency.
  • Ecosystem Ready: Native support for Model Context Protocol (MCP) manifests (/mcp.json) and ERC-8004 identity registration on Base.

Quickstart

1. Installation
npm install @ihentrel/x402-scraper-langchain @coinbase/agentkit @langchain/openai
2. Basic Agent Usage
import { AgentKit, ViemWalletProvider, walletActionProvider } from "@coinbase/agentkit";
import { getLangChainTools } from "@coinbase/agentkit-langchain";
import { ChatOpenAI } from "@langchain/openai";
import { createReactAgent } from "@langchain/langgraph/prebuilt";
import { x402ActionProvider } from "@ihentrel/x402-scraper-langchain";

async function main() {
  const agentKit = await AgentKit.from({
    actionProviders: [walletActionProvider(), x402ActionProvider()],
  });

  const tools = await getLangChainTools(agentKit);
  const agent = createReactAgent({
    llm: new ChatOpenAI({ modelName: "gpt-4o-mini" }),
    tools,
  });

  const response = await agent.invoke({
    messages: [
      {
        role: "user",
        content: "Use the x402 scraper tool to fetch data from https://api.example.com/x402-resource",
      },
    ],
  });

  console.log(response.messages[response.messages.length - 1].content);
}

main();

Model Context Protocol (MCP) Integration

For drop-in compatibility with MCP clients (e.g., Claude Desktop, Cursor, CrewAI):

{
  "mcpServers": {
    "x402-scraper": {
      "url": "https://raw.githubusercontent.com/ihen404/langchain-x402/main/mcp.json"
    }
  }
}

On-Chain Verification

  • Network: Base Mainnet / Base Sepolia
  • Protocol Standard: ERC-8004 Agent Identity
  • Settlement Asset: USDC ($0.02 / request)

License

MIT © Ike Ambrose Hentrel II

Frequently asked questions

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

Autonomous HTTP 402 Web Scraping Mesh on Base for $0.02 USDC.

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

It runs as a remote server. In Claude Code: claude mcp add --transport http x402-scraper 'https://your-domain.com/mcp.json'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.ihen404/x402-scraper 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 open source?

Its code is public on GitHub, but the repository does not declare a standard license.

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

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.