@consilioweb/payload-seo-analyzer 1.7.1 → 1.8.0

package/README.md

@@ -208,6 +208,34 @@ All dashboard views automatically switch to the user's Payload admin locale (Fre
 
 <img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" alt="line">
 
+## ⚠️ Migration from `@consilioweb/seo-analyzer`
+
+This package has been renamed from `@consilioweb/seo-analyzer` to `@consilioweb/payload-seo-analyzer`.
+
+**Automatic migration (recommended):**
+
+```bash
+npx @consilioweb/migrate
+```
+
+This will update your `package.json` and all imports automatically.
+
+**Manual migration:**
+
+```bash
+npm uninstall @consilioweb/seo-analyzer
+npm install @consilioweb/payload-seo-analyzer
+```
+
+Then update your imports:
+
+```diff
+- import { seoAnalyzerPlugin } from '@consilioweb/seo-analyzer'
++ import { seoAnalyzerPlugin } from '@consilioweb/payload-seo-analyzer'
+```
+
+---
+
 ## Installation
 
 ```bash
@@ -458,6 +486,9 @@ type RuleGroup =
   | 'technical'
   | 'accessibility'
   | 'ecommerce'
+  | 'eeat'        // SEO 2026 — E-E-A-T transparency signals (non-scoring, feeds AI-readiness)
+  | 'geo'         // SEO 2026 — generative-engine extractability (non-scoring, feeds AI-readiness)
+  | 'hreflang'    // reserved for multi-locale hreflang audit (roadmap)
 ```
 
 ### Advanced Configuration Example
@@ -597,6 +628,9 @@ All endpoints are prefixed with the configured `endpointBasePath` (default: `/se
 | `GET` `POST` | `/validate` | Run SEO analysis on a document |
 | `GET` | `/check-keyword` | Check for keyword duplication across collections |
 | `GET` | `/audit` | Full site-wide SEO audit |
+| `GET` | `/indexation-audit` | Cross-page indexation hygiene — surfaces every `noindex` / canonical problem in one place |
+| `GET` | `/core-web-vitals` | Real LCP/INP/CLS via PageSpeed Insights — informational, on-demand, SSRF-safe (own origin only) |
+| `GET` `POST` | `/gsc/*` | Google Search Console OAuth (opt-in `features.gscApi`): `status`, `auth`, `callback`, `data`, `disconnect` |
 | `GET` | `/history` | Score history data for trend charts |
 | `GET` | `/sitemap-audit` | Sitemap structure audit |
 | `GET` `PATCH` | `/settings` | Read or update SEO settings |
@@ -634,6 +668,8 @@ Each check has a **weight** (1-5) and produces a **status** (`pass`, `warning`,
 | OK | >= 41 |
 | Poor | < 41 |
 
+> **AI-readiness sub-score (SEO 2026).** `analyzeSeo()` also returns an optional `aiReadiness` ({ score, level }) — a **separate** indicator of how well the page is structured to be *cited* by generative engines (AI Overviews, ChatGPT, Perplexity). It aggregates the `geo` + `eeat` groups and the `schema-coverage` check. It is intentionally **decoupled from the SEO `score`** (those groups are weight 0 in the SEO score) because ranking and AI-citation are governed by different signals.
+
 ### Complete Check List
 
 <details>
@@ -642,7 +678,7 @@ Each check has a **weight** (1-5) and produces a **status** (`pass`, `warning`,
 | Check ID | Weight | Category | Description |
 |----------|--------|----------|-------------|
 | `title-missing` | 3 | Critical | Meta title is present |
-| `title-length` | 3 | Critical | Title between 30-60 characters |
+| `title-length` | 1 | Bonus | Title 30-60 chars — SERP display hint, not a ranking factor (depondéré in the 2026 desintox pass) |
 | `title-keyword` | 3 | Critical | Focus keyword in title |
 | `title-keyword-position` | 2 | Important | Keyword in first half of title |
 | `title-duplicate-brand` | 2 | Important | No duplicate brand name |
@@ -699,10 +735,10 @@ Each check has a **weight** (1-5) and produces a **status** (`pass`, `warning`,
 |----------|--------|----------|-------------|
 | `content-wordcount` | 2 | Important | Meets minimum word count by page type |
 | `content-keyword-intro` | 2 | Important | Keyword in first paragraph |
-| `content-keyword-density` | 2-3 | Important/Critical | Density between 0.5%-2.5% |
+| `content-keyword-density` | 0-3 | Bonus/Critical | Over-stuffing guard ONLY (warning >2.5%, fail >3%); low density is informational (weight 0), no minimum floor |
 | `content-no-placeholder` | 3 | Critical | No lorem ipsum, TODO, or placeholders |
 | `content-thin` | 2 | Important | Not thin content (>100 words) |
-| `content-keyword-distribution` | 2 | Important | Keyword in 2+ of 3 content tiers |
+| `content-keyword-distribution` | 0 | Bonus | Informational only — disguised density metric, not a ranking factor |
 | `content-has-lists` | 1 | Bonus | Contains ordered/unordered lists |
 
 </details>
@@ -743,11 +779,14 @@ Each check has a **weight** (1-5) and produces a **status** (`pass`, `warning`,
 </details>
 
 <details>
-<summary><strong>Schema (1 check)</strong></summary>
+<summary><strong>Schema (page-type aware — SEO 2026)</strong></summary>
 
 | Check ID | Weight | Category | Description |
 |----------|--------|----------|-------------|
-| `schema-readiness` | 1 | Bonus | Page has enough metadata for JSON-LD generation |
+| `schema-coverage` | 0-1 | Bonus | Determines the schema.org type expected for the page type, validates the required fields derivable from the CMS, and reminds about required fields it cannot verify (author, offers, address). A page with no usable structured-data signals no longer passes green. |
+| `schema-faq-no-rich-result` | 0 | Bonus | FAQPage markup stays valid but no longer yields a SERP rich result (FAQ removed 2026) — informational, never recommends removing the markup. |
+
+> Replaces the former single `schema-readiness` check (which passed green without ever reading any JSON-LD).
 
 </details>
 
@@ -759,8 +798,8 @@ Each check has a **weight** (1-5) and produces a **status** (`pass`, `warning`,
 | `readability-flesch` | 2 | Important | Flesch reading ease (FR: >= 40, EN: >= 60) |
 | `readability-long-sentences` | 2 | Important | Long sentence ratio < 30% (FR: >25 words, EN: >20 words) |
 | `readability-long-paragraphs` | 2 | Important | No paragraphs over 150 words |
-| `readability-passive` | 2 | Important | Passive voice ratio (FR: < 15%, EN: < 10%) |
-| `readability-transitions` | 1 | Bonus | Transition words (FR: 15%+, EN: 20%+) |
+| `readability-passive` | 0 | Bonus | Passive voice ratio — informational only (Yoast heuristic, never a ranking factor) |
+| `readability-transitions` | 0 | Bonus | Transition words — informational only (Yoast heuristic, never a ranking factor) |
 | `readability-consecutive-starts` | 1 | Bonus | No 3+ consecutive sentences with same first word |
 | `readability-long-sections` | 2 | Important | No sections >400 words without subheadings |
 
@@ -793,7 +832,7 @@ Each check has a **weight** (1-5) and produces a **status** (`pass`, `warning`,
 
 | Check ID | Weight | Category | Description |
 |----------|--------|----------|-------------|
-| `cornerstone-wordcount` | 4 | Important | 1500+ words for pillar content |
+| `cornerstone-wordcount` | 4 | Important | Thin-content floor for pillar pages (no longer rewards an arbitrary 1500-word target) |
 | `cornerstone-internal-links` | 4 | Important | 5+ internal links |
 | `cornerstone-focus-keyword` | 5 | Critical | Focus keyword is defined |
 | `cornerstone-meta-description` | 5 | Critical | Meta description is present and optimized |