claude-rank

AI Readiness and Search Visibility scanner for Claude Code. Find out if AI engines can discover, crawl, and cite your site — then fix what's blocking them.

10 scanners. 170+ checks. Auto-fix for robots.txt, sitemap.xml, llms.txt, and JSON-LD. Works on local projects and live URLs.

---

Built by Kailesk Khumar, solo founder of houseofmvps.com

One indie hacker. One plugin. Every search engine covered.

Quick Start

Use as a Claude Code Plugin (recommended)

claude-rank works as a full Claude Code plugin with skills, agents, and slash commands.

Option A — Install from GitHub (recommended):

/plugin marketplace add Houseofmvps/claude-rank
/plugin install claude-rank@Houseofmvps-claude-rank

Option B — Install from a local clone:

git clone https://github.com/Houseofmvps/claude-rank.git

Then in Claude Code:

/plugin marketplace add ./claude-rank
/plugin install claude-rank@claude-rank

After installing, run /reload-plugins to activate in your current session.

Once installed, use slash commands:

/claude-rank:rank              # Smart routing — detects what your project needs
/claude-rank:rank-audit        # Full 10-scanner audit with auto-fix + GSC action plan
/claude-rank:rank-geo          # Deep AI search optimization audit
/claude-rank:rank-aeo          # Answer engine optimization audit
/claude-rank:rank-fix          # Auto-fix all findings in one command
/claude-rank:rank-schema       # Detect, validate, generate, inject JSON-LD
/claude-rank:rank-compete      # Competitive X-Ray — compare vs any competitor URL
/claude-rank:rank-citability   # AI Citability Score — 7-dimension analysis
/claude-rank:rank-content      # Content intelligence analysis
/claude-rank:rank-perf         # Performance risk assessment
/claude-rank:rank-vertical     # E-Commerce / Local Business SEO
/claude-rank:rank-security     # Security headers audit

Zero configuration. claude-rank reads your project structure and self-configures.

Use standalone — no install needed

npx @houseofmvps/claude-rank scan ./my-project          # Local directory
npx @houseofmvps/claude-rank scan https://example.com    # Live URL (crawls up to 50 pages)
npx @houseofmvps/claude-rank geo https://example.com     # GEO audit on any URL
npx @houseofmvps/claude-rank aeo https://example.com     # AEO audit on any URL
npx @houseofmvps/claude-rank citability ./my-project     # AI citability score
npx @houseofmvps/claude-rank content ./my-project        # Content intelligence
npx @houseofmvps/claude-rank keyword ./my-project        # Keyword clustering
npx @houseofmvps/claude-rank brief ./my-project "seo"    # Content brief
npx @houseofmvps/claude-rank perf https://example.com    # Performance audit on any URL
npx @houseofmvps/claude-rank vertical ./my-project       # E-commerce / local SEO
npx @houseofmvps/claude-rank security https://example.com # Security audit on any URL
npx @houseofmvps/claude-rank compete https://comp.com .  # Competitive X-Ray
npx @houseofmvps/claude-rank gsc ./gsc-export.csv        # GSC data analysis
npx @houseofmvps/claude-rank schema ./my-project         # Structured data
npx @houseofmvps/claude-rank scan . --report html        # Agency-ready HTML report
npx @houseofmvps/claude-rank scan . --threshold 80       # CI/CD mode
npx @houseofmvps/claude-rank scan . --json               # Raw JSON output

Install globally

npm install -g @houseofmvps/claude-rank    # scoped (official)
npm install -g claude-rank-seo             # unscoped (shorter)
claude-rank scan ./my-project

Both packages are identical. claude-rank-seo is an unscoped alias for easier npx usage.

The Problem

You shipped your SaaS. You ask ChatGPT about your niche — your site isn't mentioned. Perplexity doesn't cite you. Google AI Overviews skips you entirely. Traditional search traffic is flat too.

Most developers don't realize:

• Your robots.txt is blocking GPTBot, PerplexityBot, and ClaudeBot — AI can't cite what it can't crawl
• You don't have an llms.txt — the file AI assistants look for to understand your project
• Your structured data is missing or broken — you're invisible to rich results and AI answers
• Your content isn't structured for AI extraction — no clear definitions, no citable passages, no data points
• Basic search hygiene is off — missing meta tags, broken links, no sitemap

That's not just a search ranking problem. It's an AI visibility problem. Your site exists, but AI doesn't know it.

The Solution

/claude-rank:rank-audit

One command. Ten scanners check your AI readiness and search visibility in parallel. 170+ checks across AI discoverability, search hygiene, content structure, performance, and security. Every finding gets an automated fix. Score tracked over time. Then it tells you what to submit to Google Search Console and Bing Webmaster Tools.

Search Hygiene:    87/100  ████████████░░  (54 checks)
AI Discoverability:92/100  █████████████░  (45 checks + E-E-A-T)
Answer Readiness:  78/100  ██████████░░░░  (12 checks)
AI Citability:     65/100  ████████░░░░░░  (7 dimensions)
Performance:       90/100  █████████████░  (20 checks)
Security:          80/100  ███████████░░░  (15 checks)
Overall:           86/100  AI-READY

Score below 80? Run /claude-rank:rank-fix to auto-generate what's missing (robots.txt, sitemap.xml, llms.txt, JSON-LD) then re-scan to see your improvement.

All 10 Scanners

1. Search Hygiene Scanner — 54 Checks

Practical on-page checks that developers miss. Not a replacement for a full SEO strategy — just the technical baseline your site needs.

2. AI Discoverability Scanner — 45 Checks + E-E-A-T

Checks whether AI search engines (ChatGPT, Perplexity, Gemini, Google AI Overviews) can find and cite your content.

3. Answer Readiness Scanner — 12 Checks

Checks if your content is structured to appear in featured snippets, People Also Ask, and voice search results.

4. AI Citability Score — 7 Dimensions

Estimates how likely AI engines are to cite each page based on content structure signals (0-100).

5. Content Intelligence

Deep content quality analysis across all pages.

6. Keyword Clustering (TF-IDF)

7. Content Brief Generator

Generate SEO-optimized writing briefs from your existing content.

8. Performance + Mobile Scanner — 20 Checks

Performance and mobile checks from static HTML analysis. Catches common issues without needing Chrome.

9. Vertical Scanner — 20 Checks

Auto-detects e-commerce and local business sites, then runs specialized structured data and content checks. SaaS sites with pricing pages are correctly excluded via strong/weak signal weighting.

10. Security & Headers — 15 Checks

Security headers that affect both trust signals and search visibility.

More Features

Competitive X-Ray

Point at any competitor URL. claude-rank fetches their page and compares everything side-by-side:

• Tech Stack — 50+ detection patterns (Wappalyzer-style): framework, CMS, CDN, analytics, payments, chat
• SEO Signals — title, meta, canonical, Open Graph, Twitter Card, structured data
• Content Depth — word count, heading structure, links
• Conversion Signals — CTAs, pricing, demo booking, social proof, waitlists (24 patterns)
• Quick Wins — gaps to close and strengths to keep

claude-rank compete https://competitor.com ./my-project

No API keys. No rate limits. No signup. Just point and compare.

Core Web Vitals (Lighthouse)

claude-rank cwv https://example.com

No separate install — uses npx -y lighthouse@12 automatically. Just needs Chrome.

Auto-Fix Generators

Every finding has a fix. Not "consider adding" — actual file generation:

Schema Engine — Full CRUD

Detect  → Find all JSON-LD in your HTML files
Validate → Check against Google's required fields (14 schema types)
Generate → Create missing schema from your project data
Inject   → Add generated schema into your HTML <head>

Post-Audit Action Plans

This is what separates claude-rank from every other SEO scanner. After fixing issues, it tells you exactly what to do next:

Google Search Console: Submit sitemap, request indexing for money pages, check coverage, validate rich results, monitor CWV.

Bing Webmaster Tools: Submit URLs (10,000/day), enable IndexNow for near-instant re-indexing, verify robots.txt (Bingbot powers Microsoft Copilot and ChatGPT Browse).

AI Search Verification: Test your brand in ChatGPT, Perplexity, Gemini. Verify llms.txt. Weekly monitoring checklist.

Multi-Page URL Crawling

claude-rank scan https://example.com              # Crawls up to 50 pages
claude-rank scan https://example.com --pages 10    # Limit to 10 pages
claude-rank scan https://example.com --single      # Just one page

BFS crawl, 3 concurrent fetches, cross-page duplicate/canonical analysis.

HTML Report Export

claude-rank scan ./my-project --report html

Self-contained claude-rank-report.html — dark theme, score rings, detailed findings. No external dependencies. Ready to send to clients.

CI/CD Mode

claude-rank scan ./my-project --threshold 80
# Exit code 1 if score < 80 — add to your CI pipeline

Score Tracking

Every audit saves scores. See trends over time:

2026-03-25  SEO: 62  GEO: 45  AEO: 38
2026-03-26  SEO: 78  GEO: 72  AEO: 65  (+16, +27, +27)
2026-03-28  SEO: 87  GEO: 92  AEO: 78  (+9, +20, +13)

Scoring System

All scores: 0-100. Higher is better.

Same rule on multiple pages = one deduction (not N). Consistent across all 10 scanners.

CLI Commands

Flags: --json (raw output) | --report html (visual report) | --threshold N (CI mode) | --pages N (crawl limit) | --single (one page only)

What claude-rank covers

claude-rank is a developer tool for AI readiness and search visibility. It's not a replacement for working with an SEO professional on strategy, link building, or content marketing.

Terminology

• GEO (Generative Engine Optimization) — optimization for AI-powered search engines that generate answers (Perplexity, ChatGPT Search, Gemini, Google AI Overviews). NOT geographic.
• AEO (Answer Engine Optimization) — optimization for direct answer features: featured snippets, People Also Ask, voice assistants.
• SEO (Search Engine Optimization) — traditional Google/Bing crawlability, indexability, on-page signals.

Security

See SECURITY.md for the full vulnerability disclosure policy.

What's Inside

Requirements

• Node.js >= 18 (tested on 18, 20, 22 via CI)
• ESM environment ("type": "module")
• No build step required
• Single dependency: htmlparser2 (30KB)
• Optional for Core Web Vitals: Chrome/Chromium

Sponsor This Project

I built claude-rank alone — nights and weekends, between building my own SaaS products. No VC funding. No team. Just one person who got tired of being invisible to AI search and decided to fix it for everyone.

This plugin is free forever. No pro tier. No paywalls. No "upgrade to unlock." Every feature — all 10 scanners, 12 slash commands, 9 agents — is yours, completely free.

If claude-rank helped your site get cited by AI, fixed a robots.txt that was blocking GPTBot, or generated the structured data you kept putting off, I'd be grateful if you considered sponsoring.

— Kailesk Khumar, solo founder of houseofmvps.com

Contributing

Found a bug? Want a new scanner rule? Open an issue or PR.

git clone https://github.com/Houseofmvps/claude-rank.git
cd claude-rank
npm install
npm test              # 372 tests, node:test
node tools/<tool>.mjs # No build step

See CONTRIBUTING.md for guidelines.

License

MIT — LICENSE. Free forever. No pro tier. No paywalls.