Your site ranks #1 on Google — but is invisible to ChatGPT.

AEOrank scores your AI visibility 0–100 across 36 criteria, then generates the 9 files that get you cited by ChatGPT, Perplexity, Claude, and Google AI Overviews.

Website  ·  Docs  ·  Dashboard  ·  GitHub Action  ·  GitHub App

---

One command. Zero config. Instant score.

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

30-second scan · 36 criteria · actionable fixes ranked by score impact

Why does this matter?

AI search engines now drive 40% of web discovery. ChatGPT converts visitors at 15.9% — higher than Google organic. But traditional SEO tools don't check what AI engines actually look for.

AEOrank does.

AEOrank vs the competition

Every other AEO tool is paid SaaS targeting marketers. AEOrank is the only open-source, developer-native AEO tool.

	AEOrank	Scrunch	Adobe LLM Optimizer	Semrush AI
Price	Free / MIT	$499+/mo	Enterprise	$129+/mo
Open source	✅	❌	❌	❌
CLI	✅	❌	❌	❌
GitHub integration	✅ Action + App	❌	❌	❌
Framework plugins	13	0	0	0
Generates AI files	✅ 9 files	❌	❌	❌
Scoring criteria	36	Varies	Varies	Varies
Self-hostable	✅	❌	❌	❌

Three ways to use it

1. CLI — scan any URL

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

2. GitHub App — zero-config PR checks

Install the AEOrank GitHub App on your repo. Every PR automatically gets an AEO score as a Check Run — no YAML, no config.

3. GitHub Action — CI pipeline control

name: AEO Score
on: [push, pull_request]

permissions:
  checks: write
  pull-requests: write
  contents: read

jobs:
  aeo:
    runs-on: ubuntu-latest
    steps:
      - uses: vinpatel/aeorank-action@v1
        with:
          url: https://your-site.com
          fail-below: 50

36 criteria across 5 pillars

Pillar	Weight	What it checks
🎯 Answer Readiness	30%	Topical authority, fact density, citation-ready writing, duplicate content, evidence packaging
📐 Content Structure	21%	Q&A format, direct answers, heading hierarchy, tables/lists, definition patterns
🏛️ Trust & Authority	16%	E-E-A-T signals, internal linking, author schema, meta descriptions
⚙️ Technical Foundation	14%	Schema.org coverage, semantic HTML, image context, extraction friction, speakable markup
🔍 AI Discovery	19%	llms.txt, AI crawler access, content licensing, canonical URLs, RSS feed, sitemap freshness

9 generated files

AEOrank generates all the files AI engines look for:

File	Purpose
llms.txt	Site summary for LLM crawlers (llmstxt.org spec)
llms-full.txt	Full-context version with Q&A pairs and entity disambiguation
ai.txt	AI usage permissions and licensing
CLAUDE.md	Markdown context file for Claude
schema.json	JSON-LD structured data
robots-patch.txt	AI-specific robots.txt rules
faq-blocks.html	FAQ with schema.org + speakable markup
citation-anchors.html	Deep-linkable citation anchors
sitemap-ai.xml	AI-optimized sitemap

Framework plugins

Drop-in AEO file generation. One config, 9 files, zero maintenance.

npm install @aeorank/next    # or @aeorank/astro, @aeorank/nuxt, etc.

// next.config.ts
import { withAeorank } from "@aeorank/next";

export default withAeorank({
  siteName: "My Site",
  siteUrl: "https://example.com",
  description: "What my site does.",
});
// → All 9 AEO files now served at your site root

SaaS Dashboard

Track your AEO score over time at app.aeorank.dev:

• Scan any URL → full 36-criteria breakdown
• 30-day score history with sparkline charts
• Download all 9 generated files as a ZIP
• Free tier: 1 site, 3 scans/month

Packages

Package	Description
aeorank-cli	CLI — npx aeorank-cli scan <url>
@aeorank/core	Core scanning + scoring engine
@aeorank/next	Next.js plugin
@aeorank/astro	Astro integration
@aeorank/nuxt	Nuxt module
@aeorank/remix	Remix plugin
@aeorank/sveltekit	SvelteKit plugin
@aeorank/gatsby	Gatsby plugin
@aeorank/shopify	Shopify Hydrogen plugin
@aeorank/11ty	Eleventy plugin
@aeorank/vitepress	VitePress plugin
@aeorank/docusaurus	Docusaurus plugin

Live Demo

See DEMO.md for today's auto-generated scan.

Last updated: April 22, 2026

Star History

Contributing

We ship fast and merge fast. New framework plugins, new scoring criteria, and real-world bug reports are especially welcome.

• 👀 Browse good first issues — concrete, small, well-scoped.
• 📖 Read CONTRIBUTING.md — repo layout, PR expectations, local setup.
• 💬 Ask in Discussions — ideas, questions, show-and-tell.
• 🔒 Report vulnerabilities privately via Security Advisories.

git clone https://github.com/vinpatel/aeorank.git
cd aeorank
pnpm install
pnpm test    # 675 tests across 13 packages

Share

If AEOrank saved you a $299/mo subscription, the best thank-you is sending it to one person who also needs it.

License

MIT — built by Vin Patel, sponsored by Linx Agency & Mindtrades.