# RankCLI [Health: Active]

**Category:** 🎯 Marketing  
**Repository:** https://github.com/integrallis/rankcli-mcp-server  
**GitHub Stars:** 1  
**npm Downloads (last month):** 2290  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/rankcli-2

## Description
Free, local SEO + GEO audits for AI assistants - no signup, nothing leaves your machine.

## Tools
Capabilities this server exposes over MCP:

- **seo_analyze** — 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.
- **seo_geo_check** — 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.
- **seo_robots_ai** — Analyze robots.txt for AI crawler permissions. Shows which AI crawlers (GPTBot, ClaudeBot, PerplexityBot, etc.) are allowed or blocked.
- **seo_generate_robots** — Generate an AI-friendly robots.txt that allows all major AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, etc.)
- **seo_core_web_vitals** — 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
- **seo_structured_data** — 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
- **seo_generate_schema** — Generate JSON-LD structured data template for a page type (article, product, faq, local-business, website).
- **seo_security_headers** — Analyze security headers (HTTPS, HSTS, CSP, X-Frame-Options, etc.). Returns a security grade A+ through F.
- **seo_generate_security_headers** — Generate recommended security headers configuration for a site.
- **seo_images** — Analyze images for SEO and performance. Checks alt text, dimensions, formats (WebP/AVIF), lazy loading, and responsive images.
- **seo_internal_links** — Analyze internal linking structure. Checks anchor text quality, orphan page risk, link distribution, and suggests linking opportunities.
- **seo_mobile** — Analyze mobile SEO. Checks viewport, touch targets, font sizes, content width, PWA readiness.
- **seo_ai_crawlers** — Get information about all known AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, etc.) including their user agents and purposes.
- **rankcli_connect** — Link this AI assistant to a RankCLI account (rankcli.dev). This is the only tool in this server that contacts rankcli.dev, and only when you call it - every other tool runs fully locally. Connecting unlocks GitHub auto-fix PRs, scheduled monitoring, and a dashboard with history across audits; it does not change how the other tools work. Opens a browser tab for the user to approve (or reuses an existing session if already logged in). Safe to call anytime - if already connected, it just reports who's connected.
- **rankcli_disconnect** — Unlink this AI assistant from its RankCLI account. Only affects this local connection - does not delete the RankCLI account or revoke other API keys.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "rankcli": {
    "command": "npx",
    "args": ["-y","@rankcli/mcp-server"]
  }
}
```

## Documentation

## What RankCLI MCP server does

RankCLI exposes a collection of SEO and GEO checks to MCP-compatible AI assistants. Its primary input is webpage HTML that the assistant or host already has, along with robots.txt content where relevant. The local tools do not require a signup or API key, and their analysis runs inside the MCP host rather than sending audit data to RankCLI servers.

The central `seo_analyze` tool combines checks for AI-search optimization, estimated Core Web Vitals, Schema.org structured data, security headers, mobile readiness, image handling, and internal linking. Individual tools are available when a narrower diagnostic or generated configuration is more useful than a complete audit.

## How it works

An MCP host starts the package as a local process and makes its tools available to an AI assistant. The host can fetch a page and pass its HTML to the tools, or an agent can work with HTML already present in a project or build output. The server analyzes that material locally.

GEO checks examine whether AI crawlers can access a site, how robots.txt rules affect bots such as GPTBot, ClaudeBot, and PerplexityBot, whether JavaScript is needed to reveal content, and whether the page contains signals useful for extraction and citation. Other checks estimate performance from HTML, inspect JSON-LD, review security-related headers, and assess images, links, and mobile layout signals.

`rankcli_connect` is the exception to the local-only workflow. It opens a browser approval flow for a RankCLI account at rankcli.dev, or reuses an existing session. `rankcli_disconnect` removes this local connection without deleting the account or revoking other API keys.

## Setup and configuration

Install the server with `npx`:

```json
{
  "mcpServers": {
    "rankcli": {
      "command": "npx",
      "args": ["-y", "@rankcli/mcp-server"]
    }
  }
}
```

Claude Code can add the same server with `claude mcp add rankcli -- npx -y @rankcli/mcp-server`. Claude Desktop also supports installing the latest `.mcpb` release, while Cursor and VS Code provide install links. The package can be used from Claude Desktop, Claude Code, Cursor, VS Code, Codex, and Windsurf.

The local server does not need an environment variable, API key, or RankCLI account for its analysis tools. Account linking is optional and is used for dashboard history, scheduled monitoring, and GitHub auto-fix pull requests.

## Tools and capabilities

- `seo_analyze` runs the combined audit.
- `seo_geo_check` reviews AI-search visibility, crawler access, content structure, and citation readiness.
- `seo_robots_ai` reports which known AI crawlers are allowed or blocked.
- `seo_generate_robots` creates a robots.txt intended to permit major AI crawlers.
- `seo_core_web_vitals` estimates LCP, CLS, INP, and TTFB and flags common HTML-related performance issues.
- `seo_structured_data` validates JSON-LD and common Schema.org types; `seo_generate_schema` creates templates for article, product, FAQ, local-business, and website pages.
- `seo_security_headers` grades HTTPS, HSTS, CSP, X-Frame-Options, and related protections; `seo_generate_security_headers` produces recommended configuration.
- `seo_images`, `seo_internal_links`, and `seo_mobile` inspect image metadata and loading, link structure, viewport and touch-target signals, font sizing, content width, and PWA readiness.
- `seo_ai_crawlers` provides user-agent and purpose information for known AI crawlers.
- `rankcli_connect` and `rankcli_disconnect` manage the optional local account connection.

## Limitations and notes

The local tools work from HTML and robots.txt supplied by the user or MCP host. They do not provide a remote crawl of a URL by themselves. Core Web Vitals are estimates based on HTML analysis rather than field measurements. Account-linked features require the separate connection flow, while the audit tools remain usable without it.

_Full upstream README: https://allmcps.com/mcp/rankcli-2/readme_