Documentation
Getting Started with AZNP
AZNP strips noise from web pages for AI Agents and LLMs. No signups, logins, or API keys required.
⚡ Quickstart (Free Tier, Instant)
Convert any URL instantly — no authentication, API key, or wallet needed. All formats and max_tokens are free:
# Basic Conversion
curl "https://aznp-proxy.kerberos79.workers.dev/?url=https://news.ycombinator.com"
# Structured JSON (free)
curl "https://aznp-proxy.kerberos79.workers.dev/?url=https://example.com&format=json"
# Token budget max_tokens=2000 (free)
curl "https://aznp-proxy.kerberos79.workers.dev/?url=https://example.com&max_tokens=2000"
🔐 Base (EVM) Wallet Signature (Optional Identity)
Signing is optional and is request identity, not billing. Your Base (EVM) wallet signs the request (EIP-191 / EIP-712) for identity plus a higher rate limit. format and max_tokens never require a top-up.
- Base USDC Transfer: Transfer $20 USDC or more on Base for your credit top-up
- Submit Top-up API: Call POST /v1/topup with wallet and tx_hash to receive 12,000 request credits
- Sign Requests: Include x-wallet-address, x-timestamp, x-signature, and x-chain: base headers in your GET requests
🤖 AI Agent Base (EVM) Wallet Creation & Auto-Payment
Learn how human developers and autonomous AI Agents generate Base (EVM) wallets and handle HTTP 402 auto-topup.
Method 1. Human / Developer Wallet (Coinbase Wallet / MetaMask)
Install Coinbase Wallet or MetaMask (Base supported), buy/deposit Base USDC (ERC-20), send $20+ USDC to AZNP receiving wallet, and submit the transaction hash (tx_hash) to POST /v1/topup.
Method 2. AI Agent Programmatic Wallet Generation (Node.js / Python)
Generate an EVM wallet programmatically using viem (privateKeyToAccount) inside agent code. Store the private key in environment variables securely.
🔄 HTTP 402 Payment Required Auto-Topup Workflow
1. Agent sends request ➔ 2. Receives HTTP 402 Payment Required when credits expire ➔ 3. Agent executes USDC transfer via Base SDK (viem) ➔ 4. Calls POST /v1/topup automatically to resume credits.
📚 Core Concepts
3-Tier Cascading Engine
Cloudflare Native → Self Conversion → Browser Rendering (JS). Tries the fastest, lowest-cost method first.
Multi-Tier Caching (Cache API + KV)
L1 Cache API (Ultra-fast Edge) → L2 KV (Long-term). Saves 70~90% CPU on repeated requests.
Base (EVM) Wallet Identity (Optional)
No accounts or API key management. Sign requests with your Base (EVM) wallet (EIP-191 / EIP-712) for identity — conversion itself is free and anonymous.
🛠️ Planned — @aznp/mcp-server (stdio + remote HTTP) wrapping this Worker. Not yet started.