@houseofmvps/claude-rank 1.0.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,16 @@
+{
+  "name": "claude-rank",
+  "description": "The most comprehensive SEO/GEO/AEO plugin for Claude Code. Audit, fix, and dominate search.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Houseofmvps",
+    "email": "houseofmvps2024@gmail.com"
+  },
+  "homepage": "https://github.com/Houseofmvps/claude-rank",
+  "repository": "https://github.com/Houseofmvps/claude-rank",
+  "license": "MIT",
+  "keywords": [
+    "seo", "geo", "aeo", "ai-search", "marketing", "agency",
+    "structured-data", "schema", "search-optimization"
+  ]
+}

package/CLAUDE.md

@@ -0,0 +1,65 @@
+# claude-rank
+
+## Project Overview
+- **Name**: claude-rank
+- **npm**: `claude-rank` (published under Houseofmvps)
+- **GitHub**: https://github.com/Houseofmvps/claude-rank
+- **Description**: The most comprehensive SEO/GEO/AEO plugin for Claude Code. Audit, fix, and dominate search — traditional and AI.
+- **License**: MIT
+
+## Architecture
+
+```
+claude-rank/
+├── bin/              # CLI entry point (claude-rank.mjs)
+├── tools/            # Core scanning tools (seo-scanner, geo-scanner, aeo-scanner)
+│   └── lib/          # Shared utilities (security.mjs, file-utils.mjs, etc.)
+├── skills/           # Claude Code skill definitions (.md files, max 500 lines each)
+├── agents/           # Autonomous agent definitions
+├── commands/         # Slash command implementations
+├── hooks/            # Claude Code lifecycle hooks
+├── research/         # Research prompts and templates
+├── tests/            # Node --test based tests
+│   └── fixtures/     # Test HTML/JSON fixtures
+└── .claude-plugin/   # Plugin manifest (plugin.json)
+```
+
+## Tech Stack
+- **Runtime**: Node.js >= 18, ESM only (`"type": "module"`)
+- **Dependencies**: `htmlparser2` for HTML parsing (no build step required)
+- **No TypeScript**: Plain ESM `.mjs` files throughout
+- **No bundler**: Direct node execution
+
+## Conventions
+
+### Code
+- All files use `.mjs` extension (ESM modules)
+- File naming: kebab-case always (e.g., `seo-scanner.mjs`, `geo-checker.mjs`)
+- Tools output JSON to stdout, exit code 0 on success
+- Use `execFileSync` only (never `execSync` with shell strings) to prevent injection
+- SSRF protection: always validate URLs via `tools/lib/security.mjs` before fetching
+- Always call `checkFileSize(path)` from `tools/lib/file-utils.mjs` before `readFileSync`
+- Skill files: max 500 lines per SKILL.md
+
+### Scoring System
+- All scores: 0-100 (higher is better)
+- Deductions:
+  - `critical`: -20 points
+  - `high`: -10 points
+  - `medium`: -5 points
+  - `low`: -2 points
+- Separate scores for SEO, GEO, and AEO — plus an overall composite
+
+### Terminology (CRITICAL — do not mix up)
+- **GEO** = Generative Engine Optimization (optimization for AI search engines like Perplexity, ChatGPT, Gemini) — NOT geographic
+- **AEO** = Answer Engine Optimization (optimization for featured snippets, People Also Ask, voice search)
+- **SEO** = Traditional Search Engine Optimization (Google, Bing crawlability, indexability, on-page)
+
+## Git
+- Commits: `user.email = houseofmvps2024@gmail.com`, `user.name = Houseofmvps`
+- Commit style: conventional commits (`feat:`, `fix:`, `docs:`, `chore:`)
+
+## Publishing
+- npm publish with granular token via `.npmrc`
+- `houseofmvps` account has 2FA enabled — use granular access token, not legacy token
+- Do not `npm publish` without setting token in `.npmrc` first

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Houseofmvps
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,151 @@
+# claude-rank
+
+**The most comprehensive SEO/GEO/AEO plugin for Claude Code.**
+
+Audit, fix, and dominate search — traditional and AI.
+
+[![npm version](https://img.shields.io/npm/v/claude-rank.svg)](https://www.npmjs.com/package/claude-rank)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js >= 18](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
+
+---
+
+## What it does
+
+- **74+ audit rules** across SEO (37), GEO (25), and AEO (12) — the widest coverage of any Claude Code SEO plugin
+- **Auto-fix generators** for robots.txt, sitemap.xml, llms.txt, and JSON-LD structured data — findings become fixes in one command
+- **Score tracking with trend history** — see whether your site is improving or declining over time
+
+## Why it exists
+
+Most SEO tools stop at traditional search. claude-rank covers the full picture:
+
+- **GEO (Generative Engine Optimization)** — 25 rules targeting AI search engines: Perplexity, ChatGPT, Gemini. As AI-powered search displaces ten blue links, your content needs to be citable, structured, and authoritative for language models — not just crawlers.
+- **AEO (Answer Engine Optimization)** — 12 rules for featured snippets, People Also Ask boxes, and voice search. Zero of these are in claude-seo.
+- **Auto-fix** — claude-seo tells you what's wrong. claude-rank fixes it.
+
+---
+
+## Quick start
+
+No install required:
+
+```bash
+npx claude-rank scan ./my-project
+```
+
+Or install globally:
+
+```bash
+npm install -g claude-rank
+```
+
+As a Claude Code plugin, add it to your project:
+
+```bash
+npx claude-rank install
+```
+
+Then use slash commands directly inside Claude Code:
+
+```
+/rank audit
+```
+
+---
+
+## CLI commands
+
+| Command | Description |
+|---------|-------------|
+| `npx claude-rank scan ./project` | Full SEO scan |
+| `npx claude-rank geo ./project` | GEO (AI search) scan |
+| `npx claude-rank aeo ./project` | AEO (answer engine) scan |
+| `npx claude-rank schema ./project` | Structured data detection |
+
+---
+
+## Slash commands (Claude Code)
+
+| Command | Description |
+|---------|-------------|
+| `/rank` | Main orchestrator — routes to the right audit based on context |
+| `/rank audit` | Full 8-phase SEO/GEO/AEO audit with auto-fix suggestions |
+| `/rank geo` | Deep GEO audit targeting AI search engine visibility |
+| `/rank aeo` | Answer engine optimization audit |
+| `/rank fix` | Auto-fix all findings in one command |
+| `/rank schema` | Detect, validate, generate, and inject JSON-LD structured data |
+
+---
+
+## Scoring system
+
+All scores run from 0 to 100. Higher is better.
+
+Findings are weighted by severity:
+
+| Severity | Score deduction |
+|----------|----------------|
+| Critical | -20 points |
+| High | -10 points |
+| Medium | -5 points |
+| Low | -2 points |
+
+Each audit produces separate SEO, GEO, and AEO scores, plus a composite score. Score history is tracked per project so you can see trends over time.
+
+---
+
+## Comparison: claude-rank vs claude-seo
+
+| Feature | claude-rank | claude-seo |
+|---------|:-----------:|:----------:|
+| SEO rules | 37 | ~20 |
+| GEO — AI search (Perplexity, ChatGPT, Gemini) | 25 rules | Basic |
+| AEO — featured snippets, voice search | 12 rules | None |
+| Auto-fix generators | Yes | No |
+| Schema management (detect / validate / generate / inject) | Full | Detect only |
+| Score tracking with history and trends | Yes | None |
+| Cross-page analysis | Yes | No |
+| AI bot detection | 9 bots | Basic |
+| llms.txt generation | Yes | No |
+
+---
+
+## Terminology
+
+Two terms that matter and are often confused:
+
+- **GEO (Generative Engine Optimization)** — optimization for AI-powered search engines that generate answers (Perplexity, ChatGPT Search, Gemini). This is NOT geographic targeting.
+- **AEO (Answer Engine Optimization)** — optimization for direct answer features: featured snippets, People Also Ask, voice assistants.
+
+---
+
+## Requirements
+
+- Node.js >= 18
+- ESM environment (no CommonJS)
+- No build step required
+
+Single runtime dependency: `htmlparser2`
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+## Security
+
+See [SECURITY.md](./SECURITY.md) for our vulnerability disclosure policy.
+
+## Support
+
+See [SUPPORT.md](./SUPPORT.md) for how to get help.
+
+## License
+
+MIT — see [LICENSE](./LICENSE).
+
+---
+
+Built by [Houseofmvps](https://houseofmvps.com).

package/agents/aeo-auditor.md

@@ -0,0 +1,26 @@
+---
+name: aeo-auditor
+description: Runs AEO audit using aeo-scanner tool. Dispatched by /rank audit.
+model: inherit
+---
+
+You are the AEO Auditor agent for claude-rank. Run an answer engine optimization audit.
+
+## Steps
+
+1. Run the AEO scanner: `node ${CLAUDE_PLUGIN_ROOT}/tools/aeo-scanner.mjs <project-directory>`
+2. Parse the JSON output for findings and scores
+3. Check for FAQ patterns and structured data
+
+## Output Format
+
+Return results as a JSON code block:
+
+```json
+{
+  "category": "aeo",
+  "scores": { "aeo": 60 },
+  "findings": [...],
+  "fixes_available": 2
+}
+```

package/agents/geo-auditor.md

@@ -0,0 +1,27 @@
+---
+name: geo-auditor
+description: Runs GEO audit using geo-scanner tool. Dispatched by /rank audit.
+model: inherit
+---
+
+You are the GEO Auditor agent for claude-rank. Run an AI search optimization audit.
+
+## Steps
+
+1. Run the GEO scanner: `node ${CLAUDE_PLUGIN_ROOT}/tools/geo-scanner.mjs <project-directory>`
+2. Parse the JSON output for findings and scores
+3. Check robots.txt for AI bot access
+4. Check for llms.txt existence
+
+## Output Format
+
+Return results as a JSON code block:
+
+```json
+{
+  "category": "geo",
+  "scores": { "geo": 85 },
+  "findings": [...],
+  "fixes_available": 3
+}
+```

package/agents/schema-auditor.md

@@ -0,0 +1,17 @@
+---
+name: schema-auditor
+description: Detects, validates, and reports on structured data. Dispatched by /rank audit.
+model: inherit
+---
+
+Run: `node ${CLAUDE_PLUGIN_ROOT}/tools/schema-engine.mjs detect <project-directory>`
+
+Return JSON:
+```json
+{
+  "category": "schema",
+  "schemas_found": ["Organization", "FAQPage"],
+  "validation_issues": [],
+  "missing_recommended": ["BreadcrumbList"]
+}
+```

package/agents/seo-auditor.md

@@ -0,0 +1,28 @@
+---
+name: seo-auditor
+description: Runs core SEO audit using seo-scanner tool. Dispatched by /rank audit.
+model: inherit
+---
+
+You are the SEO Auditor agent for claude-rank. Run a comprehensive SEO audit.
+
+## Steps
+
+1. Run the SEO scanner: `node ${CLAUDE_PLUGIN_ROOT}/tools/seo-scanner.mjs <project-directory>`
+2. Parse the JSON output for findings and scores
+3. Check for sitemap.xml, robots.txt, favicon.ico
+
+## Output Format
+
+Return results as a JSON code block:
+
+```json
+{
+  "category": "seo",
+  "scores": { "seo": 72 },
+  "findings": [
+    { "severity": "high", "category": "seo", "rule": "missing-meta-description", "file": "index.html", "message": "No meta description found" }
+  ],
+  "fixes_available": 5
+}
+```

package/bin/claude-rank.mjs

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+// Standalone CLI: npx claude-rank <command> <directory>
+// Commands: scan, geo, aeo, schema, fix
+
+const [,, command = 'scan', dir = '.'] = process.argv;
+
+const commands = {
+  scan: '../tools/seo-scanner.mjs',
+  geo: '../tools/geo-scanner.mjs',
+  aeo: '../tools/aeo-scanner.mjs',
+  schema: '../tools/schema-engine.mjs',
+};
+
+if (command === 'help' || command === '--help') {
+  console.log(`claude-rank — SEO/GEO/AEO toolkit
+
+Usage: claude-rank <command> [directory]
+
+Commands:
+  scan     Run core SEO scanner (default)
+  geo      Run GEO (AI search) scanner
+  aeo      Run AEO (answer engine) scanner
+  schema   Detect and validate structured data
+  help     Show this help message
+
+Examples:
+  claude-rank scan ./my-project
+  npx claude-rank geo .
+`);
+  process.exit(0);
+}
+
+const toolPath = commands[command];
+if (!toolPath) {
+  console.error(`Unknown command: ${command}. Run "claude-rank help" for usage.`);
+  process.exit(1);
+}
+
+// Dynamic import and run the scanner on the target directory
+import { resolve } from 'path';
+
+// Clear argv before importing tool modules so their inline CLI guards don't fire.
+// The tool files check `process.argv.slice(2).length > 0` to auto-run on import.
+process.argv = process.argv.slice(0, 2);
+const mod = await import(new URL(toolPath, import.meta.url));
+const targetDir = resolve(dir);
+
+if (command === 'schema') {
+  // schema-engine exports detectSchema (per-file) and findHtmlFiles via html-parser.
+  // Build a directory-level result by importing the html-parser helper and scanning each file.
+  const { findHtmlFiles } = await import(new URL('../tools/lib/html-parser.mjs', import.meta.url));
+  const { readFileSync } = await import('node:fs');
+  const files = findHtmlFiles(targetDir);
+  const results = [];
+  for (const file of files) {
+    const html = readFileSync(file, 'utf-8');
+    const schemas = mod.detectSchema(html);
+    if (schemas.length > 0) {
+      results.push({ file, schemas });
+    }
+  }
+  console.log(JSON.stringify(results, null, 2));
+} else {
+  const result = mod.scanDirectory(targetDir);
+  console.log(JSON.stringify(result, null, 2));
+}

package/commands/rank-aeo.md

@@ -0,0 +1,3 @@
+---
+description: "Answer engine optimization. Featured snippets, voice search, People Also Ask."
+---

package/commands/rank-audit.md

@@ -0,0 +1,3 @@
+---
+description: "Full SEO/GEO/AEO audit with auto-fix. Scans, reports, fixes, and verifies."
+---

package/commands/rank-fix.md

@@ -0,0 +1,3 @@
+---
+description: "Auto-fix all SEO/GEO/AEO findings. One command to fix everything."
+---

package/commands/rank-geo.md

@@ -0,0 +1,3 @@
+---
+description: "AI search optimization audit. Optimize for ChatGPT, Perplexity, Google AI Overviews, Gemini."
+---

package/commands/rank-schema.md

@@ -0,0 +1,3 @@
+---
+description: "Structured data management. Detect, validate, generate, and inject JSON-LD schema."
+---

package/commands/rank.md

@@ -0,0 +1,5 @@
+---
+description: "SEO/GEO/AEO audit, analysis, and optimization. The most comprehensive search toolkit for Claude Code."
+---
+
+Routes to rank sub-commands. Run `/rank` alone for a quick health check showing all scores. Use `/rank audit` for full audit with auto-fix.

package/hooks/hooks.json

@@ -0,0 +1,10 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "command": "node ${CLAUDE_PLUGIN_ROOT}/tools/schema-engine.mjs validate-file \"$CLAUDE_FILE_PATH\""
+      }
+    ]
+  }
+}

package/llms.txt

@@ -0,0 +1,21 @@
+# claude-rank
+
+claude-rank is a free, open-source Claude Code plugin for comprehensive search optimization — covering traditional SEO, Generative Engine Optimization (GEO), and Answer Engine Optimization (AEO).
+
+## Capabilities
+
+- **SEO Audit**: Meta tags, title/description length, heading hierarchy, canonical URLs, robots.txt, sitemap.xml, structured data (JSON-LD), Open Graph, Twitter Cards, hreflang, page speed signals
+- **GEO Audit**: AI-crawler accessibility (GPTBot, ClaudeBot, PerplexityBot), llms.txt presence, structured content density, citation-friendly formatting, entity clarity, factual density scoring
+- **AEO Audit**: Featured snippet eligibility, FAQ schema, HowTo schema, speakable schema, People Also Ask optimization, concise answer blocks, question-keyword targeting
+- **Auto-fix**: Generates corrected HTML/JSON-LD patches for detected issues
+- **Scoring**: 0-100 scores for SEO, GEO, AEO, and composite — with severity-weighted deductions
+
+## Terminology
+- GEO = Generative Engine Optimization (NOT geographic) — optimizing for AI search engines like Perplexity, ChatGPT, Gemini
+- AEO = Answer Engine Optimization — optimizing for featured snippets, voice search, and direct answer surfaces
+- SEO = Traditional Search Engine Optimization — Google/Bing crawlability, indexability, on-page signals
+
+## Links
+- GitHub: https://github.com/Houseofmvps/claude-rank
+- npm: https://www.npmjs.com/package/claude-rank
+- Author: https://houseofmvps.com

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@houseofmvps/claude-rank",
+  "version": "1.0.0",
+  "description": "The most comprehensive SEO/GEO/AEO plugin for Claude Code. Audit, fix, and dominate search — traditional and AI.",
+  "type": "module",
+  "bin": {
+    "claude-rank": "./bin/claude-rank.mjs"
+  },
+  "files": [
+    "bin/",
+    "tools/",
+    "skills/",
+    "agents/",
+    "commands/",
+    "hooks/",
+    "research/",
+    ".claude-plugin/",
+    "CLAUDE.md",
+    "llms.txt"
+  ],
+  "scripts": {
+    "test": "node --test tests/*.test.mjs",
+    "scan": "node tools/seo-scanner.mjs",
+    "geo": "node tools/geo-scanner.mjs",
+    "aeo": "node tools/aeo-scanner.mjs"
+  },
+  "keywords": [
+    "seo",
+    "geo",
+    "aeo",
+    "ai-search",
+    "claude-code",
+    "marketing",
+    "agency",
+    "structured-data",
+    "schema",
+    "search-optimization",
+    "generative-engine-optimization",
+    "answer-engine-optimization"
+  ],
+  "author": {
+    "name": "Houseofmvps",
+    "email": "houseofmvps2024@gmail.com",
+    "url": "https://houseofmvps.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Houseofmvps/claude-rank"
+  },
+  "homepage": "https://github.com/Houseofmvps/claude-rank",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "htmlparser2": "^9.1.0"
+  }
+}

package/research/geo-research.md

@@ -0,0 +1,106 @@
+# GEO Research — Generative Engine Optimization (2026)
+
+*GEO = Optimization for AI search platforms (ChatGPT, Perplexity, Google AI Overviews, etc.)*
+
+## Citation & Visibility
+
+### Content Passage Optimization
+- **Citability sweet spot**: 134-167 words per passage (AI selection rate 68%)
+- **Direct answer placement**: First 40-60 words (3.2x higher selection)
+- **Passage structure**: Question → Answer → Context (preferred by LLMs)
+- **Citation frequency**: Avg 2-3 citations per 1000 words (visibility signal)
+
+### Multi-Modal Impact
+- **Multimedia increases selection**: +156% (images, video, tables, charts)
+- **Optimal image count**: 3-5 per 1000 words
+- **Alt text optimization**: Include target keyword + context
+- **Captions**: Significantly boost AI selection (tables, charts, diagrams)
+- **Video transcripts**: Near-equivalent to text for AI crawlers
+
+## Ranking Factors for AI Search
+
+### Brand Mentions vs Backlinks
+- **Brand mention correlation**: 3x stronger than backlink count for AI visibility
+- **Unlinked mentions**: Now tracked by AI engines (0.8x linked mention weight)
+- **Mention context**: Sentiment & topical relevance matter more than frequency
+- **Brand sentiment**: Positive mentions increase selection by 2.1x
+
+### Domain Authority & AI Selection
+- **Domain authority vs AI citations**: 0.54 correlation (stronger than Google search)
+- **EEAT signals**: Authoritativeness now ranked above domain authority
+- **Author expertise**: Individual author credentials boost citation weight
+- **Freshness signals**: Recent updates (7-30 days) preferred for breaking topics
+
+## Technical & Crawlability
+
+### JavaScript Execution
+- **Critical**: AI crawlers don't execute JavaScript for content extraction
+- **Server-render strategy**: All meaningful content must be in HTML (not client-rendered)
+- **API-driven content**: Requires JSON-LD structured data for AI discovery
+- **Lazy-loaded sections**: Move above-fold content to initial HTML
+- **Single-page apps**: Add static pre-rendering or SSR for AI visibility
+
+### Structured Data (Schema Markup)
+- **JSON-LD format**: Required for AI content extraction
+- **Schema coverage**: Sites with 5+ schema types cited 2.4x more often
+- **Critical schemas**: Article, Person, Organization, BreadcrumbList
+- **Validation**: Test via Google's Rich Results Test (AI crawlers follow similar rules)
+
+## Content Strategy for GEO
+
+### Question-Format Optimization
+- **H2s as questions**: Get 3x more AI citations than statement headers
+- **FAQ sections**: Cited in 68% of AI-generated answers
+- **Question intent**: Match common question formats (What, How, Why, When, Where)
+- **Long-form Q&A**: 8-12 questions per 2000-word article (optimal)
+
+### Answer Format Preferences
+- **Direct answer first**: 40-60 word summary before explanation
+- **Evidence-based content**: Citations to studies/data increase credibility 2.1x
+- **Nuanced answers**: Gray-area discussions preferred over one-sided takes
+- **Confidence levels**: Stating uncertainty actually increases trustworthiness
+
+## AI Platform Overlap & Visibility
+
+### Cross-Platform Citation Data
+- **ChatGPT & Google AI Overlap**: 11% domain overlap (different sources preferred)
+- **Perplexity vs ChatGPT**: 34% domain overlap (Perplexity favors long-form)
+- **Top citation sources**: News sites (28%), Wikipedia (15%), E-commerce (12%)
+- **Content type overlap**: How-to guides (89% overlap), News (42% overlap)
+
+### Platform-Specific Preferences
+- **ChatGPT**: Prefers high-authority, comprehensive sources
+- **Google AI Overviews**: Favors first-page Google ranking, schema markup
+- **Perplexity**: Rewards sourced content, citations explicit in UI
+- **Claude AI**: Values nuance, acknowledges limitations, multi-perspective analysis
+
+## Content Quality Signals
+
+### Expertise & Authority
+- **E-E-A-T strengthened**: Experience now weighted equally with credentials
+- **Demonstrated expertise**: Walk-through/tutorial format increases selection 1.9x
+- **Author bio optimization**: Include relevant credentials, past work, certifications
+- **Topical depth**: Comprehensive coverage beats multiple shallow articles
+
+### Trustworthiness Factors
+- **Transparency**: Disclosures, disclaimers, conflicts of interest boost trust
+- **Source attribution**: Every claim linked to credible source (2.1x more citable)
+- **Data freshness**: Outdated statistics reduce selection by 45%
+- **Correction history**: Visible errata/updates signal reliability to AI
+
+## Optimization Checklist
+
+- [ ] Server-render all critical content (no JavaScript-dependent text)
+- [ ] Add 3-5 relevant images/media per 1000 words with alt text
+- [ ] Include JSON-LD schema (Article, Person, Organization minimum)
+- [ ] Write 134-167 word passages with direct answer in first 60 words
+- [ ] Use question-format H2s (3+ per article)
+- [ ] Include FAQ section (8-12 questions)
+- [ ] Cite credible sources for all factual claims
+- [ ] Optimize author bio with relevant expertise signals
+- [ ] Update content monthly for trending topics
+- [ ] Monitor unlinked brand mentions + respond appropriately
+
+---
+
+*Data sources: Perplexity Labs, Semrush AI search study, Search Engine Journal 2026, OpenAI API research*