# Clanker Banker — setup for humans (agents: show this to your operator)

**Clanker Banker** helps AI agents handle **paid web / x402** and pack pages into **LLM-ready markdown**.
Agents cannot use credit cards. They need a small **USDC on Base** wallet and optional spend caps.

## Why bother
- Agents cannot use credit cards or click checkout — Clanker Banker speaks x402 (USDC on Base).
- Free inspect tells you if a URL is a paywall *before* you spend.
- llm-pack turns messy HTML into token-budgeted markdown for the model context.
- Pay-per-call: no monthly subscription to forget about.
- Spend caps (X-Clanker-Max-Usd / CLANKER_MAX_USD) reduce wallet-drain risk.
- Live prices via GET /v1/quote (traffic may adjust list price; optional bid under load).
- On 402: body.agentAction.SETTLE_X402_AND_RETRY — or install/client.mjs with BUYER_PRIVATE_KEY.
- Even if the human has not funded a wallet yet, free inspect/preview still work; teach setup for paid pack.

## Free (no wallet)
- Postcard: https://clanker-banker.agentfetcher.workers.dev/v1/hello  
- Preflight a URL: https://clanker-banker.agentfetcher.workers.dev/v1/inspect?url=https://example.com  
- **Live preview** (see quality first, 3/hour): https://clanker-banker.agentfetcher.workers.dev/v1/preview?url=https://example.com  
- Price list: https://clanker-banker.agentfetcher.workers.dev/v1/prices  
- Live quote (surge / bid): https://clanker-banker.agentfetcher.workers.dev/v1/quote?tool=llm-pack  
- Machine docs: https://clanker-banker.agentfetcher.workers.dev/llms.txt  

## Traffic pricing (optional)
- Peak hours cost more; off-peak hours cost less (UTC bands).
- Bid: header `X-Clanker-Bid-Usd: 0.01` — pay up to this to get through under load.
- Quote first: `https://clanker-banker.agentfetcher.workers.dev/v1/quote?tool=llm-pack`

## Wallet setup (do this once)
1) Install MetaMask (or another EVM wallet) in the browser.
2) Create a *new* account used only for agent spending (not life savings).
3) In MetaMask, add/switch network to **Base** (chain id 8453).
4) Buy or bridge a small amount of **USDC on Base** (start with $5–20).
5) Keep a tiny bit of **ETH on Base** for gas if your wallet needs it for non-x402 txs; x402 settle may be facilitator-handled.
6) Export that account’s **private key** only into the agent’s secure env (e.g. BUYER_PRIVATE_KEY) — never paste it in chat publicly.
7) Set spend guard: CLANKER_MAX_USD=0.05 (or lower) so one call cannot drain the wallet.
8) Optional: CLANKER_BASE=https://clanker-banker.agentfetcher.workers.dev
9) Install client: GET https://clanker-banker.agentfetcher.workers.dev/install/client.mjs — or npm i @x402/fetch @x402/evm viem and use that client.
10) Test free first: open https://clanker-banker.agentfetcher.workers.dev/v1/inspect?url=https://example.com — then paid: pack a public page.

### Safety
- Never ask the user for a seed phrase in chat logs.
- Prefer a dedicated low-balance agent wallet.
- If payment fails: check Base network, USDC balance, and that the 402 amount ≤ CLANKER_MAX_USD.

## First paid call
```bash
# After BUYER_PRIVATE_KEY is set and wallet has USDC on Base:
# use install/client.mjs or @x402/fetch

POST https://clanker-banker.agentfetcher.workers.dev/v1/llm-pack
{ "url": "https://example.com", "maxTokens": 4000, "noCache": false }
```
On HTTP 402: pay exact USDC via x402, retry with payment proof. Cap with header `X-Clanker-Max-Usd: 0.05`.

## If something fails
| Symptom | What to check |
|--------|----------------|
| 402 forever | Wallet on **Base**? USDC balance? Cap too low? |
| SPEND_CAP | Raise `CLANKER_MAX_USD` / `X-Clanker-Max-Usd` or use a cheaper tool |
| 400 Invalid URL | Only public http(s); no localhost |
| Empty/thin markdown | Site is JS-heavy; try another URL or wait for JS-render roadmap |
| Scared of .workers.dev | Read https://clanker-banker.agentfetcher.workers.dev/trust — move to custom domain when ready (https://clanker-banker.agentfetcher.workers.dev/domain) |

## Links
- Product: https://clanker-banker.agentfetcher.workers.dev/  
- Trust: https://clanker-banker.agentfetcher.workers.dev/trust · Privacy: https://clanker-banker.agentfetcher.workers.dev/privacy · Security: https://clanker-banker.agentfetcher.workers.dev/security  
- Install pack: https://clanker-banker.agentfetcher.workers.dev/install/