aeorank 1.6.0 → 2.0.0

package/README.md

@@ -1,6 +1,6 @@
 # AEORank
 
-Score any website for AI engine visibility across 26 criteria. Pure HTTP + regex - zero API keys required.
+Score any website for AI engine visibility across 28 criteria. Pure HTTP + regex - zero API keys required.
 
 [![npm version](https://img.shields.io/npm/v/aeorank.svg)](https://www.npmjs.com/package/aeorank)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -35,42 +35,44 @@ import { audit } from 'aeorank';
 
 const result = await audit('example.com');
 console.log(result.overallScore);  // 0-100
-console.log(result.scorecard);     // 26 criteria with scores
+console.log(result.scorecard);     // 28 criteria with scores
 console.log(result.opportunities); // Prioritized improvements
 ```
 
 ## What It Checks
 
-AEORank evaluates 26 criteria across 4 categories that determine how AI engines (ChatGPT, Claude, Perplexity, Google AI Overviews) discover, parse, and cite your content:
+AEORank evaluates 28 criteria across 4 categories that determine how AI engines (ChatGPT, Claude, Perplexity, Google AI Overviews) discover, parse, and cite your content:
 
 | # | Criterion | Weight | Category |
 |---|-----------|--------|----------|
-| 1 | llms.txt File | 10% | Discovery |
-| 2 | Schema.org Structured Data | 15% | Structure |
-| 3 | Q&A Content Format | 15% | Content |
-| 4 | Clean, Crawlable HTML | 10% | Structure |
-| 5 | Entity Authority & NAP Consistency | 10% | Authority |
-| 6 | robots.txt for AI Crawlers | 5% | Discovery |
-| 7 | Comprehensive FAQ Section | 10% | Content |
-| 8 | Original Data & Expert Analysis | 10% | Content |
-| 9 | Internal Linking Structure | 10% | Structure |
-| 10 | Semantic HTML5 & Accessibility | 5% | Structure |
-| 11 | Content Freshness Signals | 7% | Content |
-| 12 | Sitemap Completeness | 5% | Discovery |
-| 13 | RSS/Atom Feed | 3% | Discovery |
-| 14 | Table & List Extractability | 7% | Structure |
+| 1 | llms.txt File | 8% | Discovery |
+| 2 | Schema.org Structured Data | 8% | Structure |
+| 3 | Q&A Content Format | 12% | Content |
+| 4 | Clean, Crawlable HTML | 8% | Structure |
+| 5 | Entity Authority & NAP Consistency | 8% | Authority |
+| 6 | robots.txt for AI Crawlers | 3% | Discovery |
+| 7 | Comprehensive FAQ Section | 8% | Content |
+| 8 | Original Data & Expert Analysis | 12% | Content |
+| 9 | Internal Linking Structure | 8% | Structure |
+| 10 | Semantic HTML5 & Accessibility | 4% | Structure |
+| 11 | Content Freshness Signals | 6% | Content |
+| 12 | Sitemap Completeness | 3% | Discovery |
+| 13 | RSS/Atom Feed | 2% | Discovery |
+| 14 | Table & List Extractability | 5% | Structure |
 | 15 | Definition Patterns | 4% | Content |
 | 16 | Direct Answer Paragraphs | 7% | Content |
-| 17 | Content Licensing & AI Permissions | 4% | Discovery |
+| 17 | Content Licensing & AI Permissions | 3% | Discovery |
 | 18 | Author & Expert Schema | 4% | Authority |
-| 19 | Fact & Data Density | 5% | Content |
-| 20 | Canonical URL Strategy | 4% | Structure |
+| 19 | Fact & Data Density | 8% | Content |
+| 20 | Canonical URL Strategy | 2% | Structure |
 | 21 | Content Publishing Velocity | 3% | Content |
-| 22 | Schema Coverage & Depth | 3% | Structure |
-| 23 | Speakable Schema | 3% | Structure |
-| 24 | Query-Answer Alignment | 8% | Content |
+| 22 | Schema Coverage & Depth | 2% | Structure |
+| 23 | Speakable Schema | 2% | Structure |
+| 24 | Query-Answer Alignment | 6% | Content |
 | 25 | Content Cannibalization | 5% | Content |
 | 26 | Visible Date Signal | 4% | Content |
+| 27 | **Topic Coherence** | **14%** | **Content** |
+| 28 | **Content Depth** | **6%** | **Content** |
 
 ## CLI Options
 
@@ -99,7 +101,7 @@ Use the built-in action to gate deployments on AEO score:
 
 ```yaml
 - name: AEO Audit
-  uses: AEO-Content-Inc/aeorank@v1
+  uses: AEO-Content-Inc/aeorank@v2
   with:
     domain: example.com
     threshold: 70
@@ -119,7 +121,7 @@ Or use `npx` directly:
 Run a complete audit. Returns `AuditResult` with:
 
 - `overallScore` - 0-100 weighted score
-- `scorecard` - 26 `ScoreCardItem` entries (criterion, score 0-10, status, key findings)
+- `scorecard` - 28 `ScoreCardItem` entries (criterion, score 0-10, status, key findings)
 - `detailedFindings` - Per-criterion findings with severity
 - `opportunities` - Prioritized improvements with effort/impact
 - `pitchNumbers` - Key metrics (schema types, AI crawler access, etc.)
@@ -257,7 +259,7 @@ Use `--no-headless` to skip SPA rendering (faster but may produce lower scores f
 
 ## Full-Site Crawl
 
-By default, AEORank audits the homepage plus ~20 discovered pages. For deeper analysis, enable `--full-crawl` to BFS-crawl every discoverable page:
+By default, AEORank audits the homepage plus up to 50 blog pages from the sitemap. For deeper analysis, enable `--full-crawl` to BFS-crawl every discoverable page:
 
 ```bash
 npx aeorank example.com --full-crawl                    # Up to 200 pages
@@ -296,7 +298,7 @@ AEORank scores each individual page (0-100) against the 14 criteria that apply a
 
 The 14 per-page criteria: Schema.org Structured Data, Q&A Content Format, Clean Crawlable HTML, FAQ Section Content, Original Data & Expert Content, Query-Answer Alignment, Content Freshness Signals, Table & List Extractability, Direct Answer Paragraphs, Semantic HTML5 & Accessibility, Fact & Data Density, Definition Patterns, Canonical URL Strategy, Visible Date Signal.
 
-The remaining 12 criteria (llms.txt, robots.txt, sitemap, RSS, entity consistency, internal linking, content licensing, author schema, content velocity, schema coverage, speakable schema, content cannibalization) are site-level only.
+The remaining 14 criteria (llms.txt, robots.txt, sitemap, RSS, entity consistency, internal linking, content licensing, author schema, content velocity, schema coverage, speakable schema, content cannibalization, topic coherence, content depth) are site-level only.
 
 ### CLI Output
 
@@ -449,7 +451,7 @@ console.log(result.comparison.tied);              // Criteria with equal scores
 
 ## Benchmark Dataset
 
-The `data/` directory contains the largest open dataset of AI visibility scores - **13,619 domains** scored across 26 criteria, including **4,328 Y Combinator startups** across 48 batches (W06-W26):
+The `data/` directory contains the largest open dataset of AI visibility scores - **13,619 domains** scored across 28 criteria, including **4,328 Y Combinator startups** across 48 batches (W06-W26):
 
 | File | Contents |
 |------|----------|

package/dist/browser.d.ts

@@ -173,7 +173,7 @@ interface SiteData {
     redirectedTo: string | null;
     /** Set when homepage is a parked/for-sale/lost domain */
     parkedReason: string | null;
-    /** Sampled blog/content pages from sitemap (up to 5) */
+    /** Sampled blog/content pages from sitemap (up to 50) */
     blogSample?: FetchResult[];
     /** Full-crawl statistics (set when --full-crawl is used) */
     crawlStats?: {