Skip to content
Back to search

claude-rank

MarketplaceWorks with Claude CodeGitHub

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/houseofmvps-claude-rank/badge.svg)](/listings/houseofmvps-claude-rank)

HTML

<a href="/listings/houseofmvps-claude-rank"><img src="/api/listings/houseofmvps-claude-rank/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 41 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "claude-rank",
  3. "owner": {
  4. "name": "Houseofmvps",
  5. "email": "houseofmvps2024@gmail.com"
  6. },
  7. "metadata": {
  8. "description": "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."
  9. },
  10. "plugins": [
  11. {
  12. "name": "claude-rank",
  13. "description": "Find out why AI won't cite your site — then fix it. SEO/GEO/AEO audit, auto-fix, keyword clustering, content briefs, E-E-A-T, schema validation.",
  14. "version": "2.0.2",
  15. "source": "./",
  16. "author": {
  17. "name": "Houseofmvps",
  18. "email": "houseofmvps2024@gmail.com"
  19. },
  20. "homepage": "https://github.com/Houseofmvps/claude-rank",
  21. "repository": "https://github.com/Houseofmvps/claude-rank",
  22. "license": "MIT",
  23. "keywords": [
  24. "seo",
  25. "geo",
  26. "aeo",
  27. "ai-search",
  28. "claude-code",
  29. "marketing",
  30. "agency",
  31. "structured-data",
  32. "schema",
  33. "search-optimization",
  34. "generative-engine-optimization",
  35. "answer-engine-optimization",
  36. "lighthouse",
  37. "core-web-vitals"
  38. ]
  39. }
  40. ]
  41. }
README.md · README · 532 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="assets/hero-banner.png" alt="claude-rank — AI Readiness + Search Visibility for Claude Code" width="100%"/>
  3. ### 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.
  4. **10 scanners. 170+ checks. Auto-fix for robots.txt, sitemap.xml, llms.txt, and JSON-LD. Works on local projects and live URLs.**
  5. [![CI](https://img.shields.io/github/actions/workflow/status/Houseofmvps/claude-rank/ci.yml?style=for-the-badge&logo=github&label=CI)](https://github.com/Houseofmvps/claude-rank/actions/workflows/ci.yml)
  6. [![npm version](https://img.shields.io/npm/v/%40houseofmvps%2Fclaude-rank?style=for-the-badge&logo=npm&color=CB3837)](https://www.npmjs.com/package/@houseofmvps/claude-rank)
  7. [![npm downloads](https://img.shields.io/npm/dm/%40houseofmvps%2Fclaude-rank?style=for-the-badge&logo=npm&color=blue&label=Monthly%20Downloads)](https://www.npmjs.com/package/@houseofmvps/claude-rank)
  8. [![npm total](https://img.shields.io/npm/dt/%40houseofmvps%2Fclaude-rank?style=for-the-badge&logo=npm&color=cyan&label=Total%20Downloads)](https://www.npmjs.com/package/@houseofmvps/claude-rank)
  9. [![GitHub stars](https://img.shields.io/github/stars/Houseofmvps/claude-rank?style=for-the-badge&logo=github&color=gold)](https://github.com/Houseofmvps/claude-rank/stargazers)
  10. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge&logo=opensourceinitiative)](LICENSE)
  11. [![Sponsor](https://img.shields.io/badge/Sponsor-EA4AAA?style=for-the-badge&logo=githubsponsors&logoColor=white)](https://github.com/sponsors/Houseofmvps)
  12. ---
  13. [![Follow @kaileskkhumar](https://img.shields.io/badge/Follow%20%40kaileskkhumar-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/kaileskkhumar)
  14. [![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-0A66C2?style=for-the-badge&logo=linkedin)](https://www.linkedin.com/in/kailesk-khumar)
  15. [![houseofmvps.com](https://img.shields.io/badge/houseofmvps.com-Website-green?style=for-the-badge&logo=google-chrome&logoColor=white)](https://houseofmvps.com)
  16. [![kailxlabs.co](https://img.shields.io/badge/kailxlabs.co-Website-6366F1?style=for-the-badge&logo=google-chrome&logoColor=white)](https://www.kailxlabs.co)
  17. **Built by [Kailesk Khumar](https://www.linkedin.com/in/kailesk-khumar), founder of [HouseofMVPs](https://houseofmvps.com) and [Kailxlabs](https://www.kailxlabs.co)**
  18. *One indie hacker. One plugin. Every search engine covered.*
  19. </div>
  20. ---
  21. ## Quick Start
  22. ### Use as a Claude Code Plugin (recommended)
  23. claude-rank works as a full Claude Code plugin with skills, agents, and slash commands.
  24. **Option A — Install from GitHub (recommended):**
  25. ```
  26. /plugin marketplace add Houseofmvps/claude-rank
  27. /plugin install claude-rank@Houseofmvps-claude-rank
  28. ```
  29. **Option B — Install from a local clone:**
  30. ```bash
  31. git clone https://github.com/Houseofmvps/claude-rank.git
  32. ```
  33. Then in Claude Code:
  34. ```
  35. /plugin marketplace add ./claude-rank
  36. /plugin install claude-rank@claude-rank
  37. ```
  38. After installing, run `/reload-plugins` to activate in your current session.
  39. Once installed, use slash commands:
  40. ```
  41. /claude-rank:rank # Smart routing — detects what your project needs
  42. /claude-rank:rank-audit # Full 10-scanner audit with auto-fix + GSC action plan
  43. /claude-rank:rank-geo # Deep AI search optimization audit
  44. /claude-rank:rank-aeo # Answer engine optimization audit
  45. /claude-rank:rank-fix # Auto-fix all findings in one command
  46. /claude-rank:rank-schema # Detect, validate, generate, inject JSON-LD
  47. /claude-rank:rank-compete # Competitive X-Ray — compare vs any competitor URL
  48. /claude-rank:rank-citability # AI Citability Score — 7-dimension analysis
  49. /claude-rank:rank-content # Content intelligence analysis
  50. /claude-rank:rank-perf # Performance risk assessment
  51. /claude-rank:rank-vertical # E-Commerce / Local Business SEO
  52. /claude-rank:rank-security # Security headers audit
  53. ```
  54. **Zero configuration.** claude-rank reads your project structure and self-configures.
  55. ### Use standalone — no install needed
  56. ```bash
  57. npx @houseofmvps/claude-rank scan ./my-project # Local directory
  58. npx @houseofmvps/claude-rank scan https://example.com # Live URL (crawls up to 50 pages)
  59. npx @houseofmvps/claude-rank geo https://example.com # GEO audit on any URL
  60. npx @houseofmvps/claude-rank aeo https://example.com # AEO audit on any URL
  61. npx @houseofmvps/claude-rank citability ./my-project # AI citability score
  62. npx @houseofmvps/claude-rank content ./my-project # Content intelligence
  63. npx @houseofmvps/claude-rank keyword ./my-project # Keyword clustering
  64. npx @houseofmvps/claude-rank brief ./my-project "seo" # Content brief
  65. npx @houseofmvps/claude-rank perf https://example.com # Performance audit on any URL
  66. npx @houseofmvps/claude-rank vertical ./my-project # E-commerce / local SEO
  67. npx @houseofmvps/claude-rank security https://example.com # Security audit on any URL
  68. npx @houseofmvps/claude-rank compete https://comp.com . # Competitive X-Ray
  69. npx @houseofmvps/claude-rank gsc ./gsc-export.csv # GSC data analysis
  70. npx @houseofmvps/claude-rank schema ./my-project # Structured data
  71. npx @houseofmvps/claude-rank scan . --report html # Agency-ready HTML report
  72. npx @houseofmvps/claude-rank scan . --threshold 80 # CI/CD mode
  73. npx @houseofmvps/claude-rank scan . --json # Raw JSON output
  74. ```
  75. ### Install globally
  76. ```bash
  77. npm install -g @houseofmvps/claude-rank # scoped (official)
  78. npm install -g claude-rank-seo # unscoped (shorter)
  79. claude-rank scan ./my-project
  80. ```
  81. > Both packages are identical. `claude-rank-seo` is an unscoped alias for easier `npx` usage.
  82. ---
  83. ## The Problem
  84. 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.
  85. Most developers don't realize:
  86. - **Your robots.txt is blocking GPTBot, PerplexityBot, and ClaudeBot** — AI can't cite what it can't crawl
  87. - **You don't have an llms.txt** — the file AI assistants look for to understand your project
  88. - **Your structured data is missing or broken** — you're invisible to rich results and AI answers
  89. - **Your content isn't structured for AI extraction** — no clear definitions, no citable passages, no data points
  90. - **Basic search hygiene is off** — missing meta tags, broken links, no sitemap
  91. That's not just a search ranking problem. It's an AI visibility problem. Your site exists, but AI doesn't know it.
  92. ## The Solution
  93. ```
  94. /claude-rank:rank-audit
  95. ```
  96. 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.**
  97. ```
  98. Search Hygiene: 87/100 ████████████░░ (54 checks)
  99. AI Discoverability:92/100 █████████████░ (45 checks + E-E-A-T)
  100. Answer Readiness: 78/100 ██████████░░░░ (12 checks)
  101. AI Citability: 65/100 ████████░░░░░░ (7 dimensions)
  102. Performance: 90/100 █████████████░ (20 checks)
  103. Security: 80/100 ███████████░░░ (15 checks)
  104. Overall: 86/100 AI-READY
  105. ```
  106. **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.
  107. ---
  108. ## All 10 Scanners
  109. ### 1. Search Hygiene Scanner — 54 Checks
  110. Practical on-page checks that developers miss. Not a replacement for a full SEO strategy — just the technical baseline your site needs.
  111. | Category | What it checks |
  112. |---|---|
  113. | **Meta** | Title (length, uniqueness), meta description, viewport, charset, canonical URL, lang attribute |
  114. | **Content** | H1 presence, heading hierarchy, word count (`<main>` only), image alt text, thin content, readability (Flesch-Kincaid), passive voice |
  115. | **Technical** | robots.txt, sitemap.xml, HTTPS, mobile-friendly viewport, analytics (30+ providers), redirect chains, lazy loading, hreflang |
  116. | **Structured Data** | JSON-LD presence, validation against Google's required fields (14 schema types), dateModified freshness |
  117. | **Cross-Page** | Duplicate titles, duplicate descriptions, duplicate content (Jaccard >80%), canonical conflicts, orphan pages, broken internal links |
  118. ### 2. AI Discoverability Scanner — 45 Checks + E-E-A-T
  119. Checks whether AI search engines (ChatGPT, Perplexity, Gemini, Google AI Overviews) can find and cite your content.
  120. | Category | What it checks |
  121. |---|---|
  122. | **AI Crawlers** | robots.txt for 11 bots: GPTBot, PerplexityBot, ClaudeBot, Claude-Web, Google-Extended, CCBot, AppleBot, Bytespider, Meta-ExternalAgent, Amazonbot, anthropic-ai |
  123. | **AI Discoverability** | llms.txt, sitemap.xml, structured data quality |
  124. | **Content Structure** | Question-format H2s (filters marketing headers), definition patterns, statistics, data tables, lists |
  125. | **Citation Readiness** | 134-167 word passage sweet spot, direct answers in first 40-60 words, citations to .edu/.gov/.org |
  126. | **E-E-A-T** | Author bio, credentials/expertise, about/team page, reviews/testimonials, external authority links |
  127. ### 3. Answer Readiness Scanner — 12 Checks
  128. Checks if your content is structured to appear in featured snippets, People Also Ask, and voice search results.
  129. | Category | What it checks |
  130. |---|---|
  131. | **Schema** | FAQPage, HowTo, speakable, Article structured data |
  132. | **Snippet Fitness** | Answer paragraph length (40-60 words optimal), numbered steps, definition patterns |
  133. | **Voice Search** | Concise answers under 29 words, conversational phrasing |
  134. ### 4. AI Citability Score — 7 Dimensions
  135. Estimates how likely AI engines are to cite each page based on content structure signals (0-100).
  136. | Dimension | Weight | What it measures |
  137. |---|---|---|
  138. | **Statistic Density** | 0-15 | Data points per 200 words |
  139. | **Front-loading** | 0-15 | Key answer in first 30% of content |
  140. | **Source Citations** | 0-15 | Links to .edu/.gov/research domains |
  141. | **Expert Attribution** | 0-15 | Person schema, author bios, expert quotes |
  142. | **Definition Clarity** | 0-10 | "X is..." / "X refers to..." extraction patterns |
  143. | **Schema Completeness** | 0-15 | Organization + Author + Article + FAQ + Breadcrumb |
  144. | **Content Structure** | 0-15 | Heading hierarchy, lists, paragraph segmentation |
  145. ### 5. Content Intelligence
  146. Deep content quality analysis across all pages.
  147. | Category | What it analyzes |
  148. |---|---|
  149. | **Readability** | Flesch-Kincaid score, Gunning Fog index, per-page scoring |
  150. | **Duplicate Detection** | Jaccard similarity fingerprinting across all page pairs |
  151. | **Thin Content** | Pages under 300 words flagged |
  152. | **Internal Linking** | Suggests cross-links for pages sharing H2 topics |
  153. | **Orphan Pages** | Pages with zero incoming internal links |
  154. | **Hub Pages** | Identifies pillar pages with 5+ outgoing internal links |
  155. | **Topic Clusters** | Groups pages by shared keywords |
  156. ### 6. Keyword Clustering (TF-IDF)
  157. | Category | What it analyzes |
  158. |---|---|
  159. | **Primary Keyword** | Highest-weighted keyword per page (from H1/title) |
  160. | **TF-IDF Scoring** | Term frequency / inverse document frequency across your content |
  161. | **Topic Clusters** | Pages grouped by 3+ shared significant keywords |
  162. | **Keyword Cannibalization** | Multiple pages targeting the same primary keyword |
  163. | **Content Gaps** | Keywords only covered by 1 page — opportunity for more content |
  164. | **Pillar Suggestions** | When 3+ pages share a theme, suggests creating a pillar page |
  165. ### 7. Content Brief Generator
  166. Generate SEO-optimized writing briefs from your existing content.
  167. | Category | What it generates |
  168. |---|---|
  169. | **Suggested Title** | H1 based on target keyword and existing content patterns |
  170. | **Word Count Target** | Avg of related pages + 20% to outperform |
  171. | **H2 Outline** | From analyzing related content structure |
  172. | **Questions to Answer** | Extracted from FAQ patterns and question headings |
  173. | **Internal Links** | Pages to link to/from for topical authority |
  174. | **Related Keywords** | Extracted from related pages via TF-IDF |
  175. | **GEO Tips** | Statistics to include, expert quotes, citation opportunities |
  176. ### 8. Performance + Mobile Scanner — 20 Checks
  177. Performance and mobile checks from static HTML analysis. Catches common issues without needing Chrome.
  178. | Category | What it checks |
  179. |---|---|
  180. | **CLS Risk** | Images without width/height dimensions |
  181. | **Render Blocking** | Scripts without async/defer, excessive blocking scripts |
  182. | **Payload** | Large inline CSS/JS (>50KB), too many external domains |
  183. | **Loading** | Missing lazy loading, missing fetchpriority for LCP image |
  184. | **Fonts** | Web fonts without font-display: swap |
  185. | **Images** | Responsive images (srcset/sizes), modern formats (WebP/AVIF) |
  186. | **Mobile** | Missing viewport meta, non-responsive viewport, small tap targets (<44px), small font sizes (<12px), fixed-width elements (>500px) |
  187. ### 9. Vertical Scanner — 20 Checks
  188. 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.
  189. | Type | Rules | What it checks |
  190. |---|---|---|
  191. | **E-Commerce** | 10 | Product schema, Offer schema, AggregateRating, reviews, product images, descriptions, breadcrumbs, pricing, availability, duplicate descriptions |
  192. | **Local Business** | 10 | LocalBusiness schema, NAP data, geo coordinates, opening hours, Google Maps, clickable phone, local keywords, address element, service area pages |
  193. ### 10. Security & Headers — 15 Checks
  194. Security headers that affect both trust signals and search visibility.
  195. | Category | What it checks |
  196. |---|---|
  197. | **HTTPS** | Mixed content, upgrade-insecure-requests |
  198. | **Headers** | CSP, X-Content-Type-Options, X-Frame-Options, Referrer-Policy, Permissions-Policy |
  199. | **Integrity** | Subresource Integrity (SRI) on external scripts |
  200. | **Safety** | Inline event handlers, form actions over HTTP, target="_blank" noopener, iframe sandbox |
  201. ---
  202. ## More Features
  203. ### Competitive X-Ray
  204. Point at any competitor URL. claude-rank fetches their page and compares everything side-by-side:
  205. - **Tech Stack** — 50+ detection patterns (Wappalyzer-style): framework, CMS, CDN, analytics, payments, chat
  206. - **SEO Signals** — title, meta, canonical, Open Graph, Twitter Card, structured data
  207. - **Content Depth** — word count, heading structure, links
  208. - **Conversion Signals** — CTAs, pricing, demo booking, social proof, waitlists (24 patterns)
  209. - **Quick Wins** — gaps to close and strengths to keep
  210. ```bash
  211. claude-rank compete https://competitor.com ./my-project
  212. ```
  213. No API keys. No rate limits. No signup. Just point and compare.
  214. ### Core Web Vitals (Lighthouse)
  215. ```bash
  216. claude-rank cwv https://example.com
  217. ```
  218. | Metric | Good | Poor |
  219. |---|---|---|
  220. | **LCP** (Largest Contentful Paint) | < 2.5s | > 4.0s |
  221. | **CLS** (Cumulative Layout Shift) | < 0.1 | > 0.25 |
  222. | **FCP** (First Contentful Paint) | < 1.8s | > 3.0s |
  223. | **TBT** (Total Blocking Time) | < 200ms | > 600ms |
  224. No separate install — uses `npx -y lighthouse@12` automatically. Just needs Chrome.
  225. ### Auto-Fix Generators
  226. Every finding has a fix. Not "consider adding" — actual file generation:
  227. | Generator | What it creates |
  228. |---|---|
  229. | **robots.txt** | AI-friendly rules allowing all 11 AI crawlers + sitemap directive |
  230. | **sitemap.xml** | Auto-detected routes (Next.js App/Pages Router, static HTML) |
  231. | **llms.txt** | AI discoverability file from your package.json |
  232. | **JSON-LD** | 12 types: Organization, Article, Product, FAQPage, HowTo, LocalBusiness, Person, WebSite, BreadcrumbList, SoftwareApplication, VideoObject, ItemList |
  233. ### Schema Engine — Full CRUD
  234. ```
  235. Detect → Find all JSON-LD in your HTML files
  236. Validate → Check against Google's required fields (14 schema types)
  237. Generate → Create missing schema from your project data
  238. Inject → Add generated schema into your HTML <head>
  239. ```
  240. ### Post-Audit Action Plans
  241. **This is what separates claude-rank from every other SEO scanner.** After fixing issues, it tells you exactly what to do next:
  242. **Google Search Console:** Submit sitemap, request indexing for money pages, check coverage, validate rich results, monitor CWV.
  243. **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).
  244. **AI Search Verification:** Test your brand in ChatGPT, Perplexity, Gemini. Verify llms.txt. Weekly monitoring checklist.
  245. ### Multi-Page URL Crawling
  246. ```bash
  247. claude-rank scan https://example.com # Crawls up to 50 pages
  248. claude-rank scan https://example.com --pages 10 # Limit to 10 pages
  249. claude-rank scan https://example.com --single # Just one page
  250. ```
  251. BFS crawl, 3 concurrent fetches, cross-page duplicate/canonical analysis.
  252. ### HTML Report Export
  253. ```bash
  254. claude-rank scan ./my-project --report html
  255. ```
  256. Self-contained `claude-rank-report.html` — dark theme, score rings, detailed findings. No external dependencies. Ready to send to clients.
  257. ### CI/CD Mode
  258. ```bash
  259. claude-rank scan ./my-project --threshold 80
  260. # Exit code 1 if score < 80 — add to your CI pipeline
  261. ```
  262. ### Score Tracking
  263. Every audit saves scores. See trends over time:
  264. ```
  265. 2026-03-25 SEO: 62 GEO: 45 AEO: 38
  266. 2026-03-26 SEO: 78 GEO: 72 AEO: 65 (+16, +27, +27)
  267. 2026-03-28 SEO: 87 GEO: 92 AEO: 78 (+9, +20, +13)
  268. ```
  269. ---
  270. ## Scoring System
  271. All scores: 0-100. Higher is better.
  272. | Severity | Deduction | Example |
  273. |----------|-----------|---------|
  274. | Critical | -20 | No title tag, robots.txt blocking all crawlers |
  275. | High | -10 | Missing meta description, no JSON-LD, AI bots blocked |
  276. | Medium | -5 | Title too long, missing OG tags, no llms.txt |
  277. | Low | -2 | Missing lang attribute, no analytics detected |
  278. Same rule on multiple pages = one deduction (not N). Consistent across all 10 scanners.
  279. ---
  280. ## CLI Commands
  281. | Command | Description |
  282. |---------|-------------|
  283. | `scan ./project` | SEO scan — 54 rules |
  284. | `scan https://example.com` | Crawl + scan live site (up to 50 pages) |
  285. | `geo ./project` or `geo https://...` | GEO — AI search optimization (45 rules + E-E-A-T) |
  286. | `aeo ./project` or `aeo https://...` | AEO — answer engine optimization (12 rules) |
  287. | `citability ./project` or URL | AI Citability Score — 7 dimensions |
  288. | `content ./project` or URL | Content intelligence — readability, duplicates, linking |
  289. | `keyword ./project` or URL | Keyword clustering — TF-IDF, cannibalization, gaps |
  290. | `brief ./project "keyword"` | Content brief generator (with search intent) |
  291. | `perf ./project` or URL | Performance + mobile audit (20 rules) |
  292. | `vertical ./project` or URL | Vertical SEO — e-commerce + local (20 rules) |
  293. | `security ./project` or URL | Security headers audit (15 rules) |
  294. | `compete https://comp.com .` | Competitive X-Ray |
  295. | `gsc ./export.csv` | Google Search Console data analysis |
  296. | `cwv https://example.com` | Core Web Vitals via Lighthouse |
  297. | `schema ./project` or URL | Detect + validate structured data |
  298. | `help` | Show available commands |
  299. **Flags:** `--json` (raw output) | `--report html` (visual report) | `--threshold N` (CI mode) | `--pages N` (crawl limit) | `--single` (one page only)
  300. ---
  301. ## What claude-rank covers
  302. | Area | Checks | What you get |
  303. |------|:------:|-------------|
  304. | Search hygiene | 54 | Meta tags, headings, structured data, sitemaps, broken links |
  305. | AI discoverability | 45 + E-E-A-T | AI crawler access, llms.txt, citation-ready content, authority signals |
  306. | Answer readiness | 12 | Snippet fitness, voice search, FAQ/HowTo schema |
  307. | AI citability | 7 dimensions | Per-page citability score with actionable breakdown |
  308. | Content quality | Deep analysis | Readability, duplicates, thin content, internal linking, topic clusters |
  309. | Keywords | TF-IDF | Cannibalization, content gaps, pillar suggestions |
  310. | Content briefs | Generator | Outlines, word count targets, keyword suggestions |
  311. | Performance + mobile | 20 | CLS risk, render blocking, image optimization, tap targets |
  312. | Vertical (e-commerce/local) | 20 | Product schema, LocalBusiness, NAP, reviews |
  313. | Security headers | 15 | CSP, HTTPS, SRI, mixed content |
  314. | Competitive X-Ray | 50+ patterns | Side-by-side tech stack + content + conversion comparison |
  315. | Auto-fix | 4 generators | robots.txt, sitemap.xml, llms.txt, JSON-LD |
  316. | Schema engine | Full CRUD | Detect, validate, generate, inject structured data |
  317. | Reporting | HTML + JSON + CI | Agency-ready reports, CI/CD threshold, score tracking |
  318. **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.**
  319. ---
  320. ## Terminology
  321. - **GEO (Generative Engine Optimization)** — optimization for AI-powered search engines that generate answers (Perplexity, ChatGPT Search, Gemini, Google AI Overviews). NOT geographic.
  322. - **AEO (Answer Engine Optimization)** — optimization for direct answer features: featured snippets, People Also Ask, voice assistants.
  323. - **SEO (Search Engine Optimization)** — traditional Google/Bing crawlability, indexability, on-page signals.
  324. ---
  325. ## Security
  326. | Protection | How |
  327. |---|---|
  328. | **No shell injection** | `execFileSync` with array args — zero shell interpolation |
  329. | **SSRF protection** | All HTTP tools block private IPs, cloud metadata, non-HTTP schemes |
  330. | **No telemetry** | Zero data collection. No phone home. Ever. |
  331. | **1 dependency** | `htmlparser2` only (30KB). No native bindings. No `node-gyp`. |
  332. | **372 tests** | All scanners, CLI, integration, and security tests |
  333. | **File safety** | 10MB read cap. 5MB response cap. Restrictive write permissions. |
  334. See [SECURITY.md](SECURITY.md) for the full vulnerability disclosure policy.
  335. ---
  336. ## What's Inside
  337. | Category | Count |
  338. |---|---|
  339. | **Scanners** | 10 (Search Hygiene, AI Discoverability, Answer Readiness, Citability, Content, Keywords, Briefs, Perf+Mobile, Vertical, Security) |
  340. | **Checks** | 170+ across all scanners |
  341. | **Tools** | 18 (scanners + GSC analyzer + schema engine + robots/sitemap/llms.txt + competitive X-ray + formatter) |
  342. | **CLI Commands** | 16 (all accept URLs) |
  343. | **Agents** | 9 autonomous auditors |
  344. | **Skills** | 7 plugin skills |
  345. | **Tests** | 372 |
  346. ---
  347. ## Requirements
  348. - **Node.js >= 18** (tested on 18, 20, 22 via CI)
  349. - ESM environment (`"type": "module"`)
  350. - No build step required
  351. - Single dependency: `htmlparser2` (30KB)
  352. - Optional for Core Web Vitals: Chrome/Chromium
  353. ---
  354. ## The methodology behind the rules
  355. claude-rank's 170+ rules encode the same answer engineering playbook KailxLabs uses on client builds. The open version lives here: [Answer Engine Optimization Playbook](https://github.com/Houseofmvps/answer-engine-optimization). The version we build for you, with a 45 day citation guarantee across ChatGPT, Perplexity, Gemini, Claude, and Google AI, lives at [kailxlabs.co](https://www.kailxlabs.co).
  356. ---
  357. ## Sponsor This Project
  358. 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.
  359. 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.
  360. 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.
  361. [![Sponsor on GitHub](https://img.shields.io/badge/Sponsor_on_GitHub-EA4AAA?style=for-the-badge&logo=githubsponsors&logoColor=white)](https://github.com/sponsors/Houseofmvps)
  362. *— [Kailesk Khumar](https://www.linkedin.com/in/kailesk-khumar), founder of [HouseofMVPs](https://houseofmvps.com) and [Kailxlabs](https://www.kailxlabs.co)*
  363. ---
  364. ## Contributing
  365. Found a bug? Want a new scanner rule? [Open an issue](https://github.com/Houseofmvps/claude-rank/issues) or PR.
  366. ```bash
  367. git clone https://github.com/Houseofmvps/claude-rank.git
  368. cd claude-rank
  369. npm install
  370. npm test # 372 tests, node:test
  371. node tools/<tool>.mjs # No build step
  372. ```
  373. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
  374. ---
  375. ## License
  376. MIT — [LICENSE](LICENSE). **Free forever.** No pro tier. No paywalls.
  377. ---
  378. <div align="center">
  379. ### If claude-rank made your site visible to AI, star the repo so others can find it too.
  380. [![Star on GitHub](https://img.shields.io/github/stars/Houseofmvps/claude-rank?style=for-the-badge&logo=github&color=gold&label=Star%20on%20GitHub)](https://github.com/Houseofmvps/claude-rank)
  381. **Every star makes this project more visible to developers who need it.**
  382. [Star it now](https://github.com/Houseofmvps/claude-rank) | [Follow @kaileskkhumar](https://x.com/kaileskkhumar) | [Sponsor](https://github.com/sponsors/Houseofmvps) | [Book a call](https://cal.com/houseofmvps/30-min-strategy-call-with-our-founder)
  383. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.