English Français العربية

ai.clawfetch/mcp

السجل الرسمي البحث والويب

Web intelligence for AI agents: fetch, render, extract, research. x402 micropayments, no API keys.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @clawfetch/mcp
Claude Code 
claude mcp add ai-clawfetch-mcp -e 'CLAWFETCH_PRIVATE_KEY=<your clawfetch_private_key>' -- npx -y @clawfetch/mcp@0.4.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "ai-clawfetch-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@clawfetch/mcp@0.4.0"
            ],
            "env": {
                "CLAWFETCH_PRIVATE_KEY": "<your clawfetch_private_key>"
            }
        }
    }
}

متغيرات البيئة

  • CLAWFETCH_PRIVATE_KEY إلزامي سري EVM private key for a Base wallet holding USDC (pays x402 micropayments gaslessly)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @clawfetch/mcp
  2. Access and payment
  3. 💻 Self-Hosted Mode
  4. Tools
  5. Environment Variables
  6. Development
  7. License

@clawfetch/mcp

MCP (Model Context Protocol) server for ClawFetch — Web Intelligence API for AI Agents.

Gives any MCP-compatible client (Claude Desktop, Cursor, Windsurf, OpenClaw, etc.) instant access to ClawFetch's web intelligence tools: fetch pages as markdown, render JS-heavy SPAs, extract structured data from 17+ site types, research topics multi-source, enrich companies from a domain, and check domain availability.

Payments are handled automatically via the x402 protocol — USDC on Base. No API keys, no billing dashboards.

Access and payment

The public hosted MCP endpoint is retired and returns HTTP 410 Gone. Run the MCP locally using the setup below, or call https://api.clawfetch.ai directly. Paid tool calls use your own USDC-funded wallet on Base; ClawFetch does not subsidize requests.

💻 Self-Hosted Mode

Run your own instance with full control over the payment wallet.

Install
npm install -g @clawfetch/mcp
Configure (stdio — for local MCP clients)

Add to your MCP client config (e.g., Claude Desktop):

{
  "mcpServers": {
    "clawfetch": {
      "command": "clawfetch-mcp",
      "env": {
        "CLAWFETCH_PRIVATE_KEY": "0xYOUR_ETHEREUM_PRIVATE_KEY"
      }
    }
  }
}

The private key signs x402 micropayments (USDC on Base). Fund the corresponding address with USDC on Base mainnet.

Run as HTTP Server

Expose the MCP server over HTTP for remote clients:

CLAWFETCH_PRIVATE_KEY=0x... CLAWFETCH_TRANSPORT=http CLAWFETCH_PORT=3001 clawfetch-mcp

This starts a server at http://localhost:3001/mcp using the Streamable HTTP transport (MCP spec compliant). By default it binds to 127.0.0.1 and accepts only loopback Host headers, which blocks DNS-rebinding attacks from web pages. To serve remote clients, set CLAWFETCH_HOST=0.0.0.0 and list your public hostnames in CLAWFETCH_ALLOWED_HOSTS.

HTTP Endpoints
EndpointMethodDescription
/mcpPOSTInitialize session — returns Mcp-Session-Id header
/mcpGETSSE stream for server-to-client notifications (requires session ID)
/mcpDELETEClose a session
/healthGETServer health check (JSON)
Session Flow
  1. Initialize: POST /mcp with JSON-RPC initialize request → get Mcp-Session-Id header
  2. Call tools: POST /mcp with Mcp-Session-Id header + JSON-RPC tools/call request
  3. Stream: GET /mcp?sessionId=... for SSE notifications (optional)
  4. Close: DELETE /mcp with Mcp-Session-Id header

Tools

ToolDescriptionCost
fetch_urlFetch any URL as clean markdown$0.001
render_pageRender JS-heavy pages (SPAs, React apps)$0.005
extract_dataExtract structured data from 17+ site types$0.008
research_topicMulti-source research with citations$0.02
check_domainsCheck domain name availability$0.003
suggest_domainsGenerate available domain suggestions$0.003
parse_documentParse office docs (docx/pptx/xlsx/pdf/…) to markdown$0.005
enrich_companyCompany profile from a domain: socials, emails, tech stack, key pages$0.02
list_extractorsList supported structured data extractors$0.001
health_checkCheck API health statusFree
wallet_infoShow payment wallet addressFree
Supported Extractors

GitHub repos/profiles, npm packages, PyPI packages, Twitter/X profiles, LinkedIn profiles/companies, YouTube videos/channels, Product Hunt, Hacker News, Reddit, Crunchbase, Wikipedia, and more.

Use list_extractors to see all available types with their schema.

Environment Variables

VariableRequiredDefaultDescription
CLAWFETCH_PRIVATE_KEYYes*—Ethereum private key (0x-prefixed) for x402 payments
CLAWFETCH_BASE_URLNohttps://api.clawfetch.aiAPI base URL
CLAWFETCH_TRANSPORTNostdioTransport: stdio or http
CLAWFETCH_HOSTNo127.0.0.1HTTP server bind address
CLAWFETCH_ALLOWED_HOSTSNolocalhost,127.0.0.1,[::1]Comma-separated Host header allowlist for the HTTP transport (DNS-rebinding protection)
CLAWFETCH_PORTNo3001HTTP server port
CLAWFETCH_TIMEOUT_MSNo60000Request timeout in ms
CLAWFETCH_DEBUGNofalseEnable debug logging (1 or true)

\* Required for tool calls. Without it the server still starts and lists its tools, resources and prompts (so registries can inspect it), and every call returns setup instructions. Keep this key in your local configuration; never submit it to the ClawFetch website.

Development

git clone https://github.com/clawfetch/clawfetch-mcp.git
cd clawfetch-mcp
npm install
npm run build
npm test

License

MIT

الأسئلة الشائعة

ما هو ai.clawfetch/mcp؟

Web intelligence for AI agents: fetch, render, extract, research. x402 micropayments, no API keys.

كيف أثبّت ai.clawfetch/mcp؟

يعمل على جهازك. في Claude Code: claude mcp add ai-clawfetch-mcp -e 'CLAWFETCH_PRIVATE_KEY=<your clawfetch_private_key>' -- npx -y @clawfetch/mcp@0.4.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج ai.clawfetch/mcp إلى مفتاح API؟

نعم. يتطلب CLAWFETCH_PRIVATE_KEY، وتضبطها في إعداداته.

هل ai.clawfetch/mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون ai.clawfetch/mcp؟

ينشره clawfetch. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.