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:
npx aeorank-cli scan https://your-site.comAEOrank 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✓ Generated 8 files
AEO Score: 42/100 (D)
Dimension Score Status─────────────────────────────────────llms.txt Presence 0 ✗ failSchema.org Markup 65 ⚠ warnAI Crawler Access 30 ✗ failContent Structure 80 ✓ passAnswer-First Format 45 ⚠ warnFAQ & Speakable 20 ✗ failE-E-A-T Signals 60 ⚠ warnMeta Descriptions 70 ✓ passSitemap Presence 90 ✓ passHTTPS & Redirects 100 ✓ passPage Freshness 50 ⚠ warnCitation Anchors 10 ✗ fail
→ 8 files written to ./aeo-output/Each dimension is scored 0-10 and weighted by importance. See 12 Dimensions 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 ./aeo-output/ by default:
| File | What it does |
|---|---|
llms.txt | Tells AI models what your site is about |
llms-full.txt | Full-text version for comprehensive AI indexing |
CLAUDE.md | Repository context for AI coding assistants |
schema.json | Organization + WebSite + FAQ structured data |
robots-patch.txt | Directives for AI crawlers (GPTBot, ClaudeBot, etc.) |
faq-blocks.html | Speakable FAQ schema markup |
citation-anchors.html | Heading anchors for AI citations |
sitemap-ai.xml | AI-optimized 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:
- llms.txt and llms-full.txt → root of your site (next to robots.txt)
- schema.json → embed as a
<script type="application/ld+json">tag in your HTML head - robots-patch.txt → append the directives to your existing robots.txt
- faq-blocks.html and citation-anchors.html → add to relevant pages
- 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”- Configure AEOrank for your specific needs
- Understand your score across all 12 dimensions
- Learn about each generated file in detail