# DiagnoseURL

> Website intelligence API built for AI agents. Pay per request in USDC over x402. No API key, no subscription, no signup.

DiagnoseURL lets an autonomous agent submit a public URL and get back structured
website diagnostics: HTTP status, latency, redirects, DNS records, TLS/SSL
certificate info, response headers, page title/description, robots.txt and
sitemap presence, and basic security-header checks.

## Payment

Payment is handled with the x402 protocol (HTTP 402 Payment Required) using
USDC on Base (mainnet) (eip155:8453). Call a paid endpoint
without payment and you will receive HTTP 402 with the payment requirements
base64-JSON-encoded in a `PAYMENT-REQUIRED` response header (the JSON body
is empty). Sign a payment, attach it as an `X-PAYMENT` request header, and
retry the same request to get your JSON result. Most x402-aware HTTP clients
(e.g. @x402/fetch) do all of this automatically — see docs/AGENT_INTEGRATION.md
in the source repository for a full worked example.

## Endpoints

- GET /health — free. Service health check.
- GET /api/v1/pricing — free. Machine-readable pricing.
- GET /api/v1/capabilities — free. Full capability description for agents.
- GET /api/v1/quick?url=<https://example.com> — $0.01 USDC. Fast website check: HTTP status, latency, final URL, HTTPS status, page title, SSL expiration.
- GET /api/v1/probe?url=<https://example.com> — $0.02 USDC. Full website intelligence: HTTP, DNS, TLS, headers, redirects, page metadata, security headers, robots.txt/sitemap discovery.
- GET /.well-known/agent.json — free. Structured agent-discovery document.
- GET /openapi.json — free. Full OpenAPI 3.0 spec.

## Constraints

Only http:// and https:// URLs are accepted. Requests to localhost, private
IP ranges, link-local addresses, and cloud metadata endpoints are rejected.
No JavaScript is executed on the target site and no headless browser is used.
No authentication is attempted against scanned sites — only publicly
available information is inspected.

## Docs

Full integration guide (curl examples, x402 client code):
see docs/AGENT_INTEGRATION.md in the source repository, or GET /openapi.json
for the machine-readable spec.