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"
🔐 Solana Ed25519 Signature (Optional Identity)
Signing is optional and is request identity, not billing. Your Solana keypair signs the request for identity plus a higher rate limit. format and max_tokens never require a top-up.
⚠️ Credit top-up (POST /v1/topup), USDC 402 auto-payment, and programmatic wallet guides below are kept for compatibility — out of grant scope.
- Solana USDC Transfer: Transfer $20 USDC or more 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-signature, and x-timestamp headers in your GET requests
🤖 AI Agent Solana USDC Wallet Creation & Auto-Payment
Learn how human developers and autonomous AI Agents generate Solana USDC wallets and handle HTTP 402 auto-topup.
Method 1. Human / Developer Wallet (Phantom / Solflare)
Install Phantom or Solflare wallet app, buy/deposit Solana USDC, 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 Ed25519 Keypair programmatically using @solana/web3.js or solana-py inside agent code. Store secret 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 Solana SDK ➔ 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.
Solana Ed25519 Identity (Optional)
No accounts or API key management. Sign requests with your Solana Ed25519 keypair for identity — conversion itself is free and anonymous.
🛠️ Planned — @aznp/mcp-server (stdio + remote HTTP) wrapping this Worker. Not yet started.