Skip to content
AEOrank

Quick Start

Get your AEO score and generated files in four steps.

Prerequisites

Section titled “Prerequisites”
  • Node.js 20 or later
  • A website URL to scan

Step 1: Run your first scan

Section titled “Step 1: Run your first scan”

No installation needed. Run this command in your terminal:

Terminal window
npx aeorank-cli scan https://your-site.com

AEOrank will crawl up to 50 pages, analyze your site’s structure, and generate your score.

Step 2: Review your score

Section titled “Step 2: Review your score”

You’ll see output like this:

Scanning https://your-site.com...
✓ Fetched 12 pages in 3.2s
✓ Analyzed structure and schema
  AI Crawler Access
    GPTBot             unknown
    ClaudeBot          unknown
    PerplexityBot      unknown
    Google-Extended    unknown


  AEO Score: 42/100 (D)
  36 dimensions · 8 generated files


  Dimensions by Pillar
    ...


→ 8 files written to ./aeorank-output/

Each criterion is scored 0-10 and weighted by percentage importance. See 36 Criteria for details on what each one measures.

Step 3: Check your generated files

Section titled “Step 3: Check your generated files”

AEOrank writes 8 files to ./aeorank-output/ by default (the same list generateFiles() and npx aeorank-cli@latest return):

FileWhat it does
llms.txtSite summary for LLM crawlers — agent-docs hygiene, not a citation guarantee
llms-full.txtFull-text version with Q&A pairs
CLAUDE.mdRepository context for AI coding assistants
schema.jsonOrganization + WebSite + FAQ structured data
robots-patch.txtDirectives for GPTBot, ClaudeBot, PerplexityBot, Google-Extended
faq-blocks.htmlSpeakable FAQ schema markup
citation-anchors.htmlHeading anchors for deep links
sitemap-ai.xmlAI-oriented sitemap

See Generated Files for detailed documentation on each file.

Step 4: Deploy the files

Section titled “Step 4: Deploy the files”

Copy the generated files to your website:

  1. llms.txt and llms-full.txt → root of your site (next to robots.txt)
  2. schema.json → embed as a <script type="application/ld+json"> tag in your HTML head
  3. robots-patch.txt → append the directives to your existing robots.txt
  4. faq-blocks.html and citation-anchors.html → add to relevant pages
  5. sitemap-ai.xml → root of your site, reference in robots.txt

Run the scan again after deploying to see your score improve.

Next steps

Section titled “Next steps”