@meta
version: 1
route: /
generated_at: 2026-06-19T12:27:29.608Z
ttl: 3600

@intent
purpose: Free website audit for AI/Answer Engine Optimization (AEO/GEO)
audience: site owners, SEO professionals, marketing teams, AI agents
capabilities:
  - score a site across 5 weighted pillars (0-100, grade A-F)
  - detect llms.txt, AVL (Agent View Layer), robots.txt, schema.org markup
  - probe access for 20+ AI crawlers (GPTBot, ClaudeBot, PerplexityBot, etc.)
  - measure Core Web Vitals via Lighthouse
  - generate prioritized recommendations and code-fix suggestions

@state
service: AEOCheck.ai
status: operational
pricing: free
pillars:
  - id: ai_discovery
    weight: 0.25
    measures: robots.txt, sitemap, 20+ AI bot access
  - id: content_structure
    weight: 0.25
    measures: title tag, H1, meta description, semantic HTML, answer capsules
  - id: structured_data
    weight: 0.20
    measures: Schema.org JSON-LD, Microdata, RDFa, NAP consistency
  - id: user_experience
    weight: 0.15
    measures: forms, contact info, Core Web Vitals
  - id: ai_communication
    weight: 0.15
    measures: llms.txt, AVL, citation likelihood, content freshness
grade_boundaries:
  A: 90-100 (AI-Ready)
  B: 80-89  (Well Optimized)
  C: 70-79  (Needs Improvement)
  D: 60-69  (AI-Challenged)
  F: 0-59   (Critical Issues)

@actions
  - method: POST
    path: /api/leads
    purpose: Start a free audit (URL + email + consent)
    accepts: { email, url, consent, name?, company? }
    returns: { leadId, analysisId, isNew }
    rate_limit: 5/hour/IP
  - method: GET
    path: /api/analyze/{id}/status
    purpose: Poll the status of a running audit
    returns: { status, progress, partial_scores }
  - method: GET
    path: /api/analyze/{id}
    purpose: Fetch the complete audit result once status=completed
  - method: GET
    path: /api/analyze/{id}/citation-score
    purpose: Get the citation-likelihood breakdown for a completed audit
  - method: GET
    path: /api/analyze/{id}/llms-txt
    purpose: Get a generated llms.txt suggestion for the audited site
  - method: GET
    path: /api/analyze/{id}/code-suggestions
    purpose: Get prioritized code-fix snippets for the audited site
  - method: POST
    path: /api/consultations
    purpose: Request a paid expert consultation
    accepts: { email, name, message, analysisId? }

@context
AEOCheck.ai audits how well a website is positioned for discovery and citation
by AI assistants — ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews.
The five-pillar methodology blends technical signals (robots.txt, schema,
performance), content signals (answer capsules, statistics, authority quotes),
and machine-readable companion documents (llms.txt, AVL). A passing score
(B or higher) indicates a site that AI agents can find, parse, and cite
reliably.

The audit is asynchronous: submitting a URL kicks off a background job that
crawls the site, runs Lighthouse, parses structured data, probes 20+ AI bot
user-agents against the site's robots.txt, and computes weighted scores. The
report is delivered to the submitted email and is also viewable at
/results/{shareId} (with /results/{shareId}.agent as the AVL companion).

@nav
self: /.agent
manifest: /agent.txt
homepage: /
peers:
  - /results/{shareId}.agent
drilldown:
  audit_result: /api/analyze/{analysisId}
  audit_status: /api/analyze/{analysisId}/status