Web intelligence
for AI agents

---
name: clawfetch
description: Web intelligence API for AI agents. Stealth rendering, 17 structured
  extractors (Twitter, GitHub, CoinGecko, NPM, PyPI, crates.io, Hacker News,
  YouTube, Wikipedia, Product Hunt, IMDb, Amazon, Crunchbase, SEC EDGAR, Zillow,
  Redfin, news), domain search, and multi-source research. Gasless USDC payments
  on Base via standard X402 protocol.
metadata:
  author: jean-clawd
  version: "2.0"
  website: https://clawfetch.ai
  twitter: "@ClawFetchAI"
compatibility: Requires HTTP client, ethers.js or viem for signing, USDC on Base.
---

# ClawFetch.ai — Web Intelligence for AI Agents

Base URL: `https://api.clawfetch.ai`

## Quick Start

### 1. Create a Base Wallet
```javascript
import { ethers } from 'ethers';
const wallet = ethers.Wallet.createRandom();
console.log('Address:', wallet.address);
console.log('Private Key:', wallet.privateKey);
// Save the private key securely!
```

### 2. Get USDC on Base
Ask your human to send USDC to your wallet on the Base network.
Even $0.50 covers hundreds of API calls. **No ETH needed** — X402 is gasless!

### 3. Install the X402 Client SDK
```bash
npm install @x402/fetch @x402/evm ethers
```

### 4. Make Requests (Payment is Automatic)
```javascript
import { wrapFetchWithPayment } from '@x402/fetch';
import { ExactEvmScheme } from '@x402/evm/exact/client';
import { toClientEvmSigner } from '@x402/evm';
import { privateKeyToAccount } from 'viem/accounts';
import { createPublicClient, http } from 'viem';
import { base } from 'viem/chains';

const account = privateKeyToAccount(process.env.EVM_PRIVATE_KEY);
const publicClient = createPublicClient({ chain: base, transport: http() });
const signer = toClientEvmSigner(account, publicClient);

const fetchWithPay = wrapFetchWithPayment(fetch, [new ExactEvmScheme(signer)]);

// Now use it like normal fetch — payments happen automatically!
const res = await fetchWithPay('https://api.clawfetch.ai/render', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ url: 'https://example.com' }),
});
const data = await res.json();
```

## Endpoints & Pricing

| Endpoint              | Price  | Description                    |
|-----------------------|--------|--------------------------------|
| POST /fetch           | 0.1¢   | Basic HTTP → clean text        |
| POST /render          | 0.2¢   | JS rendering with stealth      |
| POST /extract         | 0.3¢   | Structured JSON extraction     |
| POST /domains/check   | 0.2¢   | Domain availability via WHOIS  |
| POST /domains/suggest | 0.2¢   | Generate + check domain names  |
| POST /research        | 1¢     | Multi-source topic research    |
| GET /extractors       | 0.1¢   | List available extractors      |
| GET /health           | Free   | Service status                 |

## Payment (X402 Protocol — Gasless)

Standard X402 with EIP-3009 (TransferWithAuthorization):
- Network: Base mainnet (eip155:8453)
- Token: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
- Wallet: 0x67439832C52C92B5ba8DE28a202E72D09CCEB42f
- **No ETH needed** — the facilitator handles gas

The SDK handles everything: detect 402 → sign authorization → retry → get data.

## Available Extractors (17)

- **twitter** — x.com → author, text, likes, reposts, views, media
- **coingecko** — coingecko.com → name, price, marketCap, volume, rank
- **github** — github.com → name, stars, forks, language, readme
- **news** — any public article → title, author, date, body, source
- **npm** — npmjs.com → name, version, downloads, dependencies
- **pypi** — pypi.org → name, version, author, license, requires_python
- **crates** — crates.io → name, version, downloads, features
- **hackernews** — news.ycombinator.com → title, author, score, comments, url
- **youtube** — youtube.com, youtu.be → title, channel, duration, views
- **wikipedia** — wikipedia.org → title, summary, sections, references
- **producthunt** — producthunt.com → name, tagline, votes, topics, makers
- **edgar** — sec.gov → company profile, CIK, filings, XBRL financials
- **imdb** — imdb.com → title, rating, cast, plot, genres, runtime
- **amazon** — amazon.com → title, price, rating, reviews, features, BSR
- **crunchbase** — crunchbase.com → name, funding, founders, categories
- **zillow** — zillow.com → address, price, Zestimate, beds, baths, sqft
- **redfin** — redfin.com → address, price, estimate, beds, baths, sqft

## Cost Estimates

$1 USDC gets you: 1,000 fetches, 500 renders, 333 extractions, or 100 researches.