# ClawFetch.ai — Web Intelligence API for AI Agents

> Web intelligence API. Stealth rendering, structured extraction, domain search,
> and multi-source research. Pay per request with USDC on Base via X402.
> No API keys, no subscriptions, no accounts needed.

## API Base URL

https://api.clawfetch.ai

## Official SDKs

- TypeScript: `npm install @clawfetch/sdk` — auto-payment, retry, typed errors
- Python: `pip install clawfetch` — sync + async, auto-payment, retry, typed errors

## Quick Start (TypeScript)

```typescript
import { ClawFetch } from '@clawfetch/sdk';
const cf = new ClawFetch({ privateKey: '0x...' }); // wallet with USDC on Base

const page = await cf.fetch('https://example.com');       // $0.001
const data = await cf.extract('https://coingecko.com/en/coins/bitcoin'); // $0.003
const report = await cf.research('AI agent frameworks');   // $0.010
```

## Quick Start (Python)

```python
from clawfetch import ClawFetch
with ClawFetch(private_key="0x...") as cf:
    page = cf.fetch("https://example.com")       # $0.001
    data = cf.extract("https://coingecko.com/en/coins/bitcoin")  # $0.003
    report = cf.research("AI agent frameworks")   # $0.010
```

## Endpoints & Pricing

| Endpoint              | Method | Price  | Description                         |
|-----------------------|--------|--------|-------------------------------------|
| /fetch                | POST   | $0.001 | URL → clean markdown (no JS)        |
| /render               | POST   | $0.002 | JS-rendered page → markdown         |
| /extract              | POST   | $0.003 | Structured data from 17+ sites      |
| /research             | POST   | $0.010 | Multi-source topic research         |
| /domains/check        | POST   | $0.002 | Domain availability via WHOIS       |
| /domains/suggest      | POST   | $0.002 | Domain name suggestions + check     |
| /extractors           | GET    | $0.001 | List available extractors           |
| /health               | GET    | Free   | API status check                    |

## Supported Extractors (17)

twitter (x.com), coingecko, github, news (any article), npm, pypi,
crates.io, hackernews, youtube, wikipedia, producthunt, edgar (SEC),
imdb, amazon, crunchbase, zillow, redfin

## Payment

Uses X402 protocol (gasless USDC micropayments on Base).
- Network: Base mainnet (Chain ID 8453)
- Token: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
- Protocol: EIP-3009 TransferWithAuthorization (gasless — no ETH needed)
- SDKs handle the entire payment flow automatically

## Cost Estimates

$1 USDC = 1,000 fetches OR 500 renders OR 333 extractions OR 100 researches

## Links

- Website: https://clawfetch.ai
- OpenAPI Spec: https://clawfetch.ai/openapi.yaml
- AgentSkill: https://clawfetch.ai/skill/SKILL.md
- X402 Protocol: https://x402.org
- Twitter: https://x.com/ClawFetchAI