RankCLI
RankCLI is a local, free, no-API-key MCP server that audits SEO, GEO (AI-search visibility), performance, structured data, security and mobile-readiness from HTML/robots.txt/headers you supply — and generates fixes.
Full SEO audit (
seo_analyze) — one call covering GEO, Core Web Vitals, structured data, security headers, mobile, images and internal linking, with scores and issues.AI-search (GEO) visibility (
seo_geo_check) — whether GPTBot, ClaudeBot, PerplexityBot etc. can crawl the page, JS-rendering barriers, LLM-friendly content structure and citation/trust signals.AI crawler control — see which AI bots a robots.txt allows or blocks (
seo_robots_ai), and generate an AI-friendly robots.txt (seo_generate_robots); look up user agents and purposes (seo_ai_crawlers).Performance estimates (
seo_core_web_vitals) — approximate LCP, CLS, INP, TTFB and flag render-blocking assets, missing image dimensions, big bundles, missing preloads.Structured data — validate JSON-LD/Schema.org and rich-result eligibility (
seo_structured_data), or generate templates for article, product, FAQ, local-business and website pages (seo_generate_schema).Security headers — grade HTTPS/HSTS/CSP/X-Frame-Options A+ to F (
seo_security_headers) and generate a recommended header config (seo_generate_security_headers).On-page checks — image alt text/formats/lazy-loading (
seo_images), internal linking and anchor quality (seo_internal_links), mobile viewport/touch targets/PWA readiness (seo_mobile).Everything runs locally — your MCP host fetches the page; nothing round-trips to RankCLI servers (URL-fetching/crawling tools live on the separate hosted endpoint).
Performs Cloudflare AI-crawler-gating compliance checks to verify that Cloudflare-managed sites have the recommended AI crawler access rules.
Analyzes robots.txt settings for PerplexityBot to help control AI crawler access and optimize visibility in Perplexity AI search results.
@rankcli/mcp-server
Free, local SEO + GEO (AI-search-citation) analysis as an MCP tool. No signup, no API key, nothing sent to RankCLI's servers — it runs entirely inside your MCP host (Claude Code, Claude Desktop, Cursor, etc.) against HTML you already have or that your host fetches for you.
Install
Claude Desktop — download the latest .mcpb from
Releases and double-click it.
No config file, no terminal.
Claude Code — one line, no config file:
claude mcp add rankcli -- npx -y @rankcli/mcp-serverAnything else (Claude Desktop, Codex, Windsurf) — the standard config block:
{
"mcpServers": {
"rankcli": {
"command": "npx",
"args": ["-y", "@rankcli/mcp-server"]
}
}
}Claude Desktop config path (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"rankcli": {
"command": "npx",
"args": ["@rankcli/mcp-server"]
}
}
}Related MCP server: seo-audit-mcp
Agent skills and Claude Code plugin
The same checks as skills your coding agent loads on demand, named for the job you type:
Skill | For |
| the audit as a deploy gate: build directory or preview URL, a committed baseline, GitHub Actions or any CI |
| what changed, against a baseline or a previous report, fixed in the codebase by code |
| whether ChatGPT, Claude, Perplexity and Google can read the site, by bot class, and the fix in robots.txt, at the CDN or in the framework |
| the full audit, read and triaged |
| the short form of the deploy gate |
Any agent (Claude Code, Cursor, Codex, Copilot, Windsurf and others), via the skills CLI:
npx skills add integrallis/rankcli-mcp-serverClaude Code plugin (the two skills plus the MCP server, one install):
/plugin install rankcli --marketplace integrallis/rankcli-mcp-serveror from a shell: claude plugin marketplace add integrallis/rankcli-mcp-server then
claude plugin install rankcli@rankcli. The skills are then /rankcli:check-site-before-deploy,
/rankcli:fix-seo-regressions, /rankcli:is-my-site-blocked-from-ai-search, /rankcli:seo-audit
and /rankcli:seo-ci-gate.
The server's source is packages/mcp-server in integrallis/rankcli
(FSL-1.1-MIT); this repository is the install page, the skills and the plugin.
Available Tools
Tool | Description |
| Full SEO analysis: GEO, Core Web Vitals, structured data, security headers, mobile, images, internal linking |
| AI search visibility (GEO) — crawler access, LLM content signals, citation readiness |
| Which AI crawlers (GPTBot, ClaudeBot, PerplexityBot, etc.) your robots.txt allows or blocks |
| Generate an AI-crawler-friendly robots.txt |
| Estimate LCP, CLS, INP, TTFB from HTML |
| Validate JSON-LD / Schema.org markup |
| Generate a JSON-LD template for a page type |
| Grade HTTPS, HSTS, CSP, and related headers |
| Generate recommended security header config |
| Alt text, dimensions, formats, lazy loading |
| Anchor text quality, orphan-page risk |
| Viewport, touch targets, PWA readiness |
| Reference list of known AI crawler user agents |
Example
Just ask Claude:
"Run an SEO audit on https://example.com"
Your MCP host fetches the page and Claude calls these tools directly — nothing round-trips through RankCLI.
Want more?
This local server works from HTML/robots.txt you or your MCP host supply. The free hosted
endpoint https://mcp.rankcli.dev/mcp/free serves the same thirteen analysis tools with no
key, for hosts that cannot run npx. For URL-only tools that fetch and crawl for you (seo_audit, seo_geo_check, seo_robots_check, seo_compare), plus the newer Cloudflare AI-crawler-gating compliance check, CI/CD scheduling, and auto-fix PRs, see the hosted endpoint and paid tiers:
{
"mcpServers": {
"rankcli-hosted": {
"url": "https://rankcli-audit-worker.fly.dev/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Get a free API key at rankcli.dev/dashboard.
Links
Main package: @rankcli/cli
Docs: rankcli.dev/docs
Dashboard: rankcli.dev/dashboard
Available Tools
13 toolsseo_ai_crawlersA
Get information about all known AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, etc.) including their user agents and purposes.
Inputs: no named parameters.
seo_analyzeA
Run comprehensive SEO analysis on a webpage. Returns scores and issues for:
GEO (AI Search Optimization) - Is the site visible to ChatGPT, Perplexity, Claude?
Core Web Vitals (LCP, CLS, INP) - Performance estimates
Structured Data - Schema.org validation
Security Headers - HTTPS, HSTS, CSP
Mobile SEO - Responsive design, touch targets
Images - Alt text, formats, dimensions
Internal Linking - Anchor text, orphan detection
Use this for a complete SEO audit.
Inputs: url (required), html, robotsTxt.
seo_core_web_vitalsA
Estimate Core Web Vitals (LCP, CLS, INP, TTFB) from HTML analysis. Identifies issues like:
Render-blocking resources
Images without dimensions
Large JavaScript bundles
Missing preload hints
Inputs: url (required), html (required).
seo_generate_robotsB
Generate an AI-friendly robots.txt that allows all major AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, etc.)
Inputs: siteUrl (required).
seo_generate_schemaB
Generate JSON-LD structured data template for a page type (article, product, faq, local-business, website).
Inputs: siteUrl (required), pageType (required), siteName (required), authorName, +1 more.
seo_generate_security_headersB
Generate recommended security headers configuration for a site.
Inputs: siteUrl (required).
seo_geo_checkA
Check if a website is optimized for AI search engines (GEO - Generative Engine Optimization).
Analyzes:
AI crawler access (GPTBot, ClaudeBot, PerplexityBot, etc.)
robots.txt rules for AI crawlers
JS rendering requirements (can AI crawlers see content?)
Content structure for LLM consumption
Citation readiness (trust signals)
FAQ/entity extraction capability
Critical for visibility in ChatGPT, Perplexity, Claude, and Gemini responses.
Inputs: url (required), html, robotsTxt.
seo_imagesA
Analyze images for SEO and performance. Checks alt text, dimensions, formats (WebP/AVIF), lazy loading, and responsive images.
Inputs: url (required), html (required).
seo_internal_linksA
Analyze internal linking structure. Checks anchor text quality, orphan page risk, link distribution, and suggests linking opportunities.
Inputs: url (required), html (required).
seo_mobileB
Analyze mobile SEO. Checks viewport, touch targets, font sizes, content width, PWA readiness.
Inputs: url (required), html (required).
seo_robots_aiA
Analyze robots.txt for AI crawler permissions. Shows which AI crawlers (GPTBot, ClaudeBot, PerplexityBot, etc.) are allowed or blocked.
Inputs: robotsTxt (required).
seo_security_headersA
Analyze security headers (HTTPS, HSTS, CSP, X-Frame-Options, etc.). Returns a security grade A+ through F.
Inputs: url (required), headers (required).
seo_structured_dataA
Validate JSON-LD structured data (Schema.org). Checks for:
Required properties per schema type
Article, Product, FAQ, HowTo, LocalBusiness schemas
Rich result eligibility
Common mistakes
Inputs: url (required), html (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Tools are mostly distinct: seo_analyze is a comprehensive audit, while individual tools provide focused deep dives. Some overlap exists between seo_geo_check and seo_robots_ai (both touch AI crawler access), but descriptions clarify the broader scope of geo check.
All tools share the seo_ prefix and use snake_case, with generation tools following a clear seo_generate_* pattern. However, analysis tools mix verbs (analyze, check) with bare noun phrases (seo_images, seo_internal_links), which is a minor inconsistency.
13 tools is well-scoped for a technical SEO toolkit, covering analysis, generation, and informational tools without bloat. Each tool addresses a distinct SEO concern, and the count feels appropriate for the domain.
The toolset covers major technical SEO areas: AI search, Core Web Vitals, structured data, security headers, images, internal links, and mobile. Missing sitemap analysis and content/keyword features, but these are minor gaps for a focused technical audit tool.
Maintenance
Related MCP Connectors
Free SEO/GEO audits of public websites and AI answer-engine citation checks. No login or API key.
Run SEO + AI-visibility (GEO) audits from Claude, Cursor & other AI clients.
Free SEO, GEO, and AEO audits: analyze any page or domain, AI-crawler access, agent readiness.
Free SEO, AI visibility (AI crawlers, llms.txt, JSON-LD) and security-header checks for any URL.
Related MCP Servers
AlicenseAqualityCmaintenanceLets any AI agent audit any website for SEO, GEO/AEO, and speed problems, reporting issues and recommendations without modifying the site.4MIT- AlicenseNot gradedqualityDmaintenanceEnables AI agents to perform instant SEO audits, check robots.txt, sitemaps, and AI crawler access for any URL without API keys.MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to run evidence-first technical SEO and GEO audits, inspect HTML, structured data, robots policies and sitemaps, and compare before/after reports to verify fixes.51MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants such as Claude, ChatGPT, Cursor, and Claude Code to run 25+ specialized SEO checks on any URL, generate XML sitemaps and robots.txt files, extract brand design elements, and audit technical SEO, content quality, mobile responsiveness, and security.MIT