# claude-rank v2.0.2

claude-rank is a free, open-source Claude Code plugin that tells you why your site won't get cited by AI — and fixes the discoverability files automatically. 170+ rules across 10 scanners for search optimization, AI citability, keyword analysis, content briefs, performance, mobile, and security auditing. All commands accept URLs or local directories.

## Scanners

- **SEO Scanner** (54 rules): Meta tags, title/description validation, heading hierarchy, canonical URLs, robots.txt, sitemap.xml, structured data (JSON-LD), Open Graph, Twitter Cards, hreflang, image alt text, internal linking, broken link detection, page speed signals
- **GEO Scanner** (45 rules): AI-crawler accessibility (GPTBot, ClaudeBot, PerplexityBot), llms.txt presence, structured content density, citation-friendly formatting, entity clarity, factual density scoring, knowledge graph readiness, E-E-A-T scoring (author bio, credentials, trust signals)
- **AEO Scanner** (12 rules): Featured snippet eligibility, FAQ schema, HowTo schema, speakable schema, People Also Ask optimization, concise answer blocks, question-keyword targeting
- **AI Citability Scorer** (7 dimensions): Measures how likely AI models are to cite your content across authority, uniqueness, structure, freshness, depth, attribution, and accessibility
- **Content Intelligence**: Readability analysis, duplicate detection, thin content, orphan pages, hub page detection, topic clustering, internal linking suggestions
- **Keyword Clustering**: TF-IDF keyword extraction, topic clusters, keyword cannibalization detection, content gaps, pillar page suggestions
- **Content Brief Generator**: Intent-aware writing briefs with search intent classification, smart title generation, H2 outline with auto-generated angles (definition, mistakes, FAQ), word count target, questions to answer, internal linking, related keywords, GEO tips
- **Performance + Mobile Scanner** (20 rules): Render-blocking resources, image optimization (srcset, WebP/AVIF), CLS risk, font loading, resource hints, lazy loading, mixed content, mobile viewport, responsive viewport, tap target sizes, font sizes, fixed-width elements
- **Vertical SEO Scanner** (20 rules): Industry-specific schema validation (e-commerce, local business) with auto-detection
- **Security Scanner** (15 rules): HTTPS enforcement, CSP, X-Frame-Options, referrer policy, permissions policy, mixed content, SRI, inline event handlers, iframe security

## Features

- **Competitive X-Ray**: 50+ tech stack detection patterns — identify frameworks, CDNs, analytics, CMS, and hosting used by any site
- **Auto-fix generators**: Generates corrected robots.txt, sitemap.xml, llms.txt, and JSON-LD patches for detected issues
- **Score tracking**: 0-100 scoring with severity-weighted deductions (critical -20, high -10, medium -5, low -2) and persistent audit history
- **HTML report export**: Visual audit reports for sharing with teams or clients
- **CI/CD threshold mode**: Set minimum score thresholds and fail builds that don't meet them
- **URL scanning for all commands**: Every scanner accepts URLs or local directories — scan competitors without downloading their site
- **GSC CSV integration**: Import Google Search Console exports for quick wins, low CTR alerts, and engagement insights
- **Intent-aware cannibalization**: Only flags keyword overlap when pages share the same search intent
- **Multi-page URL crawling**: Crawl and audit multiple pages from a single domain
- **16 CLI commands**: Full command-line interface for all scanners and utilities

## Scoring

- All scores: 0-100 (higher is better)
- Deductions are per unique rule (not per finding) — consistent across all scanners
- Separate scores for SEO, GEO, AEO, AI Citability, Performance, Vertical SEO, Security, and Content Intelligence
- Composite overall score combining all dimensions

## 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/@houseofmvps/claude-rank
- Author: https://houseofmvps.com