@rankcli/mcp-server 0.0.1 → 0.0.2

package/README.md

@@ -1,24 +1,12 @@
 # @rankcli/mcp-server
 
-**MCP Server for AI Assistants to perform SEO analysis.**
-
-The industry's first SEO tool accessible via Model Context Protocol. Let Claude, GPT, and other AI assistants run comprehensive SEO audits directly.
-
-## What is MCP?
-
-[Model Context Protocol](https://modelcontextprotocol.io) (MCP) is Anthropic's standard for connecting AI assistants to external tools. This server exposes RankCLI's full SEO analysis capabilities to AI.
-
-## Installation
+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.
 
 ```bash
-npm install -g @rankcli/mcp-server
+npx @rankcli/mcp-server
 ```
 
-## Configuration
-
-### Claude Desktop
-
-Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+**Claude Desktop config** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
 
 ```json
 {
@@ -31,90 +19,53 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
 }
 ```
 
-Restart Claude Desktop. You'll now have SEO tools available.
-
-### Other MCP Clients
-
-Run the server directly:
-
-```bash
-npx @rankcli/mcp-server
-```
-
-The server communicates via stdio using JSON-RPC.
-
 ## Available Tools
 
-### `seo_analyze`
-**Full comprehensive SEO audit.** Returns scores for GEO, Core Web Vitals, Security, Structured Data, Images, Links, and Mobile.
-
-### `seo_geo_check`
-**GEO (Generative Engine Optimization).** Check AI crawler access, JS rendering, LLM signals, citation readiness.
-
-### `seo_robots_ai`
-**Analyze robots.txt for AI crawlers.** Shows which AI crawlers (GPTBot, ClaudeBot, PerplexityBot) are allowed/blocked.
-
-### `seo_generate_robots`
-**Generate AI-friendly robots.txt.** Creates rules allowing all major AI crawlers.
-
-### `seo_core_web_vitals`
-**Estimate Core Web Vitals.** LCP, CLS, INP, TTFB from HTML analysis.
-
-### `seo_structured_data`
-**Validate JSON-LD schemas.** Check Article, Product, FAQ, HowTo, LocalBusiness, BreadcrumbList.
+| Tool | Description |
+|------|-------------|
+| `seo_analyze` | Full SEO analysis: GEO, Core Web Vitals, structured data, security headers, mobile, images, internal linking |
+| `seo_geo_check` | AI search visibility (GEO) — crawler access, LLM content signals, citation readiness |
+| `seo_robots_ai` | Which AI crawlers (GPTBot, ClaudeBot, PerplexityBot, etc.) your robots.txt allows or blocks |
+| `seo_generate_robots` | Generate an AI-crawler-friendly robots.txt |
+| `seo_core_web_vitals` | Estimate LCP, CLS, INP, TTFB from HTML |
+| `seo_structured_data` | Validate JSON-LD / Schema.org markup |
+| `seo_generate_schema` | Generate a JSON-LD template for a page type |
+| `seo_security_headers` | Grade HTTPS, HSTS, CSP, and related headers |
+| `seo_generate_security_headers` | Generate recommended security header config |
+| `seo_images` | Alt text, dimensions, formats, lazy loading |
+| `seo_internal_links` | Anchor text quality, orphan-page risk |
+| `seo_mobile` | Viewport, touch targets, PWA readiness |
+| `seo_ai_crawlers` | Reference list of known AI crawler user agents |
 
-### `seo_generate_schema`
-**Generate schema templates.** For article, product, faq, local-business, website.
+## Example
 
-### `seo_security_headers`
-**Analyze security headers.** HTTPS, HSTS, CSP with A+ to F grading.
+Just ask Claude:
 
-### `seo_generate_security_headers`
-**Generate recommended security headers.**
+> "Run an SEO audit on https://example.com"
 
-### `seo_images`
-**Image optimization analysis.** Alt text, dimensions, formats, lazy loading.
+Your MCP host fetches the page and Claude calls these tools directly — nothing round-trips through RankCLI.
 
-### `seo_internal_links`
-**Internal linking analysis.** Anchor text quality, orphan detection.
+## Want more?
 
-### `seo_mobile`
-**Mobile SEO analysis.** Viewport, touch targets, PWA readiness.
+This local server works from HTML/robots.txt you or your MCP host supply. 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:
 
-### `seo_ai_crawlers`
-**AI crawler reference.** Information about all known AI crawlers.
-
-## Example Usage
-
-Once configured, ask Claude:
-
-> "Run a comprehensive SEO audit on https://example.com"
-
-> "Check if my site is visible to ChatGPT and other AI search engines"
-
-> "Generate an AI-friendly robots.txt for my domain"
-
-> "What structured data should I add to my blog posts?"
-
-Claude will use the appropriate tools to analyze and respond.
-
-## Why This Matters
-
-1. **AI doing SEO**: Your AI assistant can now audit sites, generate fixes, and monitor SEO.
-2. **Meta-optimization**: Make sure YOUR site is visible to AI crawlers—checked by AI.
-3. **Developer workflow**: Ask Claude to audit during code review or deployment.
-
-## Requirements
-
-- Node.js 18+
-- An MCP-compatible AI assistant (Claude Desktop, etc.)
-
-## Related
+```json
+{
+  "mcpServers": {
+    "rankcli-hosted": {
+      "url": "https://rankcli-audit-worker.fly.dev/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
 
-- [RankCLI CLI](https://www.npmjs.com/package/@rankcli/cli) - Command-line SEO tool
-- [RankCLI Website](https://rankcli.dev) - Full documentation
-- [MCP Protocol](https://modelcontextprotocol.io) - Model Context Protocol
+Get a free API key at [rankcli.dev/dashboard](https://rankcli.dev/dashboard).
 
-## License
+## Links
 
-MIT
+- **Main package**: [@rankcli/cli](https://www.npmjs.com/package/@rankcli/cli)
+- **Docs**: [rankcli.dev/docs](https://rankcli.dev/docs)
+- **Dashboard**: [rankcli.dev/dashboard](https://rankcli.dev/dashboard)

package/dist/index.js

@@ -460,6 +460,9 @@ ${Object.entries(headers).map(([k, v]) => `**${k}:**
     };
   }
 });
+var BRIDGE_FOOTER = `
+---
+*This ran locally with no signup. For GitHub auto-fix PRs, scheduled monitoring, and a dashboard with history across audits, create a free account at [rankcli.dev](https://rankcli.dev).*`;
 function formatComprehensiveResult(result) {
   const criticalIssues = result.allIssues.filter((i) => i.severity === "critical");
   const warnings = result.allIssues.filter((i) => i.severity === "warning");
@@ -495,6 +498,7 @@ ${warnings.slice(0, 5).map((i) => `- **${i.title}:** ${i.description}`).join("\n
 ## Priority Recommendations
 
 ${result.prioritizedRecommendations.map((r, i) => `${i + 1}. ${r}`).join("\n")}
+${BRIDGE_FOOTER}
 `;
 }
 function formatGEOResult(result) {
@@ -535,6 +539,7 @@ Trust Signals: ${result.citationReadiness.trustSignals.join(", ") || "None detec
 ## Recommendations
 
 ${result.recommendations.map((r) => `- ${r}`).join("\n")}
+${BRIDGE_FOOTER}
 `;
 }
 function formatCWVResult(result) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rankcli/mcp-server",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "MCP (Model Context Protocol) server for RankCLI SEO analysis",
   "type": "module",
   "main": "dist/index.js",
@@ -27,7 +27,7 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "@rankcli/agent-runtime": "^0.0.11"
+    "@rankcli/agent-runtime": "^0.0.17"
   },
   "devDependencies": {
     "tsup": "^8.0.0",