# AgentReady

> AgentReady provides free website triage and deterministic, pay-per-request audit and remediation APIs for the agentic web.

## Endpoints

- GET /services — indexable buyer-intent catalog for all 10 paid tools, including exact prices, methods, routes, inputs, outputs, and links to the live discovery contract and OpenAPI schema.
- GET /api/audit/preview?url=https://example.com — free score, category breakdown, top three fixes, and lowest-cost relevant paid next steps with exact POST bodies, USDC prices, and x402 retry instructions.
- POST /api/audit — audits a website for AI-search visibility (AEO/GEO) and agent readiness, returning a deterministic 100-point report with a robots.txt access matrix for 7 major AI crawlers, optional llms-full.txt evidence, structured data, content clarity, trust, and ranked fixes.
- Price: 0.10 USDC on Base mainnet using x402 v2 exact payments.
- POST /api/audit/compare — compares two to four websites for AI-search visibility, citation readiness, AEO/GEO, and agent access, returning a ranked competitor benchmark, category leaders, gaps, priority fixes, and full underlying audits.
- Price: 0.75 USDC on Base mainnet using x402 v2 exact payments.
- POST /api/audit/fix-pack — generates deployable website fixes from one public URL: a full audit plus JSON-LD structured data, metadata, tailored llms.txt, robots crawler policy, security headers, projected score, and a safe rollout and verification plan.
- Price: 1.50 USDC on Base mainnet using x402 v2 exact payments.
- POST /api/extract/agent-text — extracts clean, LLM-ready Markdown or token-efficient text for RAG ingestion, research, summarization, and agent context, stripping navigation and boilerplate while preserving headings and resolved links, with an explicit untrusted-content warning and a 50,000-character cap.
- GET /api/extract/agent-text?url=https%3A%2F%2Fexample.com&format=markdown — compatibility form of the same paid tool for GET-only clients and directory probes; POST remains canonical.
- Price: 0.005 USDC on Base mainnet using x402 v2 exact payments.
- POST /api/extract/metadata — extracts technical-SEO and link-preview data including canonical links, Open Graph, Twitter Cards, parsed JSON-LD, headings, robots policy, and selected response headers for research, URL enrichment, indexing, and link unfurling.
- Price: 0.005 USDC on Base mainnet using x402 v2 exact payments.
- POST /api/generate/llms-txt — generates a tailored, ready-to-review llms.txt from a site's public content and same-origin links.
- Price: 0.05 USDC on Base mainnet using x402 v2 exact payments.
- POST /api/generate/citation-copy — returns source-grounded hero copy, metadata, citation cards, and FAQ drafts derived from one public page.
- Price: 0.02 USDC on Base mainnet using x402 v2 exact payments.
- POST /api/preflight/url-check — checks whether robots.txt allows a specific crawler to access a URL before fetching, then verifies page reachability without downloading the page.
- Price: 0.005 USDC on Base mainnet using x402 v2 exact payments.
- POST /api/x402/inspect — a live x402 payment trust preflight that fetches an endpoint's unpaid HTTP 402 PAYMENT-REQUIRED challenge and enforces the buyer budget before paying, or inspects a decoded/base64 challenge directly. Reports price, network, asset, recipient, and protocol risks without signing or sending payment or forwarding caller authorization headers.
- Price: 0.02 USDC on Base mainnet using x402 v2 exact payments.
- POST /api/x402/receipt — verifies a Base transaction receipt, confirmation count, canonical USDC Transfer logs, and optional expected payer, recipient, and amount.
- Price: 0.01 USDC on Base mainnet using x402 v2 exact payments.
- No account or API key is required.

## Free resources

- GET /api/health — current payment configuration and service status.
- GET /SKILL.md — agent-executable instructions for free-first selection, budget enforcement, x402 challenge validation, and safe paid retries.
- GET /examples/buy-agent-text.mjs — runnable official-client buyer example that validates the live challenge before signing and caps payment at 0.005 USDC.
- GET /examples/buy-fix-pack.mjs — runnable official-client fix-pack buyer that validates the live challenge, Base USDC contract, resource URL, recipient, and exact 1.50 USDC amount before signing.
- GET /.well-known/agent-card.json — current A2A Agent Card using an accurately declared x402/OpenAPI custom binding; /.well-known/agent.json is a marketplace-compatible alias with endpoint and price metadata.
- GET /openapi.json — OpenAPI 3.1 contract.
- GET or HEAD /.well-known/api-catalog — RFC 9727 API catalog listing all 2 free and 10 paid endpoints as an RFC 9264 JSON Linkset.
- GET /.well-known/x402 — machine-readable service discovery document with compact URL lists, detailed services, and Bazaar-compatible items[] resource objects for the same 10 paid URLs.

## Data handling

AgentReady fetches only supplied public URLs. Audit products also check four same-origin public files: robots.txt, llms.txt, optional llms-full.txt, and sitemap.xml. URL preflight checks robots.txt before requesting the target page. Settlement receipt verification reads public Base JSON-RPC data and never sends a transaction. The service does not retain submitted URLs, transaction hashes, or results.