# Agent Data Tools

> Pay-per-call tools for AI agents: web page text extraction and summaries, screenshots, image generation, speech-to-text, image description, domain and email-auth intelligence, and live Base token and wallet lookups. No account or API key; pay per request in USDC on Base via x402.

All endpoints are GET, return JSON, and cost a fixed price per successful call. An unpaid request returns HTTP 402 with a PAYMENT-REQUIRED header (x402 v2, exact scheme, USDC on Base). Sign the payment and retry with the PAYMENT-SIGNATURE header. Failed calls (4xx/5xx) are not charged.

## Endpoints

### GET /extract — $0.002
Fetch any public web page and get clean readable text for LLM input: title, meta description, language, canonical URL, H1-H3 headings, main body text with navigation, scripts and boilerplate removed, and the page's outbound links. Use for web scraping, article reading, research and RAG ingestion.
- `url` (string, required): Absolute http(s) URL of the page to fetch
- `maxChars` (integer): Maximum characters of body text to return (500-100000, default 20000)
Example: https://agent-data-tools.peterbellbring.workers.dev/extract?url=https%3A%2F%2Fexample.com

### GET /domain — $0.005
Domain intelligence in one call: DNS records (A, AAAA, CNAME, MX, NS, TXT, CAA), DNSSEC status, registrar, registration and expiry dates with domain age in days (RDAP/WHOIS), and email authentication (SPF and DMARC records and policies, whether the domain accepts mail). Use for lead qualification, phishing and trust checks, and deliverability audits.
- `name` (string, required): Domain name, e.g. cloudflare.com
Example: https://agent-data-tools.peterbellbring.workers.dev/domain?name=cloudflare.com

### GET /token — $0.01
Live on-chain facts for any ERC-20 token on Base: name, symbol, decimals, total supply, owner address and whether ownership is renounced, paused state, proxy detection (EIP-1967 and minimal proxy) with implementation and admin addresses, and bytecode heuristics for mint, pause, blacklist and fee-setter functions. Use for token due diligence and rug-pull or honeypot screening before a swap.
- `address` (string, required): Token contract address on Base (0x...)
Example: https://agent-data-tools.peterbellbring.workers.dev/token?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

### GET /wallet — $0.005
Live snapshot of any address on Base: ETH balance, balances of major tokens (USDC, WETH, cbBTC, DAI, USDbC, cbETH, AERO, EURC) plus up to 20 extra token addresses you pass, transaction count, and whether the address is an EOA, a smart contract or an EIP-7702 delegated account. Use for portfolio checks, counterparty screening and payment verification.
- `address` (string, required): Wallet or contract address on Base (0x...)
- `tokens` (string): Optional comma-separated extra ERC-20 addresses to check (max 20)
Example: https://agent-data-tools.peterbellbring.workers.dev/wallet?address=0x4200000000000000000000000000000000000006

### GET /summarize — $0.01
Give a URL, get a short summary of the page plus three to six key points, ready to drop into an agent's context. Fetches the page, strips navigation and boilerplate, and summarizes the main text with an LLM. Use for research, news triage, link previews and deciding whether a page is worth reading in full.
- `url` (string, required): Absolute http(s) URL of the page to summarize
Example: https://agent-data-tools.peterbellbring.workers.dev/summarize?url=https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FHTTP_402

### GET /screenshot — $0.02
Render any public web page in a real headless Chrome browser, with JavaScript executed, and get a JPEG screenshot (1280 px wide, base64) plus the final URL, HTTP status and page title. Set fullPage=true to capture up to 4000 px of page height. Use for visual checks, page previews, monitoring and feeding pages to vision models.
- `url` (string, required): Absolute http(s) URL of the page to capture
- `fullPage` (string): Set to true to capture the full page height (max 4000 px) instead of the 1280x800 viewport
Example: https://agent-data-tools.peterbellbring.workers.dev/screenshot?url=https%3A%2F%2Fexample.com

### GET /image — $0.02
Text-to-image generation with FLUX.1 schnell. Send a prompt, get a 1024x1024 JPEG back as base64 in a few seconds. Use for illustrations, thumbnails, mockups, avatars and social media images. Optional steps parameter (1-8, default 4) trades speed for detail.
- `prompt` (string, required): What the image should show (3-800 characters)
- `steps` (integer): Diffusion steps, 1-8 (default 4)
Example: https://agent-data-tools.peterbellbring.workers.dev/image?prompt=a%20lighthouse%20on%20a%20cliff%20at%20sunset%2C%20watercolor

### GET /transcribe — $0.02
Transcribe speech from an audio file at a public URL using Whisper large-v3-turbo. Returns the transcript text, detected language, duration and word count. Accepts common formats such as MP3, WAV, M4A and OGG up to 5 MB. Use for voice notes, podcast clips, meeting snippets and voice messages.
- `url` (string, required): Absolute http(s) URL of an audio file (max 5 MB)
Example: https://agent-data-tools.peterbellbring.workers.dev/transcribe?url=https%3A%2F%2Fcommons.wikimedia.org%2Fwiki%2FSpecial%3AFilePath%2FEn-us-hello.ogg

### GET /describe — $0.01
Vision model for an image at a public URL: get a detailed description including any visible text, or pass a question to ask something specific about the image. Accepts PNG, JPEG, WebP and GIF up to 3 MB. Use for alt text, OCR-style reading of screenshots, chart reading and content checks.
- `url` (string, required): Absolute http(s) URL of a PNG, JPEG, WebP or GIF image (max 3 MB)
- `question` (string): Optional question about the image (max 300 characters); default is a detailed description
Example: https://agent-data-tools.peterbellbring.workers.dev/describe?url=https%3A%2F%2Fupload.wikimedia.org%2Fwikipedia%2Fcommons%2F4%2F47%2FPNG_transparency_demonstration_1.png

## Machine-readable

- MCP server (streamable HTTP, same tools and prices): https://agent-data-tools.peterbellbring.workers.dev/mcp
- [OpenAPI 3.1](https://agent-data-tools.peterbellbring.workers.dev/openapi.json)
- [Service card](https://agent-data-tools.peterbellbring.workers.dev/)
- [x402 resource list](https://agent-data-tools.peterbellbring.workers.dev/.well-known/x402)