← Docs

Scanner API

The scanner evaluates HTML or text against active AEO/GEO rules. Same engine powers MCP, CLI, GitHub Action, and the web UI.

Free tier (grades + fundamental fixes)

• MCP: scan_url with no API key — grades plus findings: each failed L0–L3 check with its fix. No rule IDs, evidence or severity.
• Web: /scan — paste a public URL
• HTTP: POST https://aeogeo.site/api/scan with {"url":"https://example.com"} — CORS open; grades plus L0–L3 findings

Keyed tier (detailed)

• MCP: lint_html, lint_text — per-check results with executable fix objects
• API: POST /api/scan with Authorization: Bearer <key>

Machine-readable contract

The customer REST surface (POST /api/scan, keyed GET /api/checks, keyed GET /api/rules) is published as a parseable OpenAPI 3 document for agents and tooling:

• https://aeogeo.site/openapi.json — static apex (same file is also served by the Worker at /api/openapi.json)

Invariants

• Deterministic: same input → same output
• Transient: scanned content is never persisted
• No prompt-tracking or LLM calls in aeogeo runtime