@rankcli/cli 0.0.13 → 0.0.15

package/README.md

@@ -1,20 +1,28 @@
 # RankCLI
 
-**Ship code, get ranked. SEO meets CI/CD.**
+**The only SEO tool with GEO (AI Search Optimization) and MCP for AI assistants.**
 
-A developer-first SEO automation tool. CLI-based, AI-powered, event-driven.
+Developer-first SEO. CLI-native. Optimizes for Google *and* ChatGPT, Perplexity, Claude.
+
+## Why RankCLI?
+
+| Feature | RankCLI | Competitors |
+|---------|---------|-------------|
+| **GEO (AI Search)** | ✅ Check if GPTBot/ClaudeBot can crawl | ❌ |
+| **MCP Server** | ✅ AI assistants can run audits | ❌ |
+| **Framework Fixes** | ✅ 25+ frameworks | ❌ |
+| **CLI/CI Native** | ✅ Built for developers | ❌ |
+| **Price** | **$15/mo** | $99-500/mo |
 
 ## Installation
 
 ```bash
-npm install -g rankcli
-# or
-yarn global add rankcli
+npm install -g @rankcli/cli
 # or
-pnpm add -g rankcli
+pnpm add -g @rankcli/cli
 ```
 
-Verify installation:
+Verify:
 
 ```bash
 rankcli --version
@@ -29,227 +37,130 @@ rankcli audit --url https://yoursite.com
 # Login to unlock all features
 rankcli login
 
-# Run a full 280+ check audit
+# Full 280+ check audit
 rankcli audit --url https://yoursite.com --max-pages 5
 ```
 
-## Authentication
+## Core Features
 
-### Interactive Login
+### 🤖 GEO (Generative Engine Optimization)
 
-```bash
-# Email/password login
-rankcli login
+Check if AI crawlers can access your site:
 
-# Browser-based OAuth
-rankcli login --browser
-
-# Provide email directly
-rankcli login --email you@example.com
+```bash
+rankcli audit --url https://yoursite.com --geo
 ```
 
-### API Key (CI/CD)
+Analyzes:
+- **AI crawler access**: GPTBot, ClaudeBot, PerplexityBot, Google-Extended
+- **JS rendering**: Can AI crawlers see your content?
+- **LLM signals**: Content structure, citations, FAQ extraction
+- **robots.txt**: Are you blocking AI search?
+
+### 🔌 MCP Server (For AI Assistants)
 
-For non-interactive environments like CI/CD pipelines:
+Let Claude run SEO audits for you:
 
 ```bash
-# Login with API key
-rankcli login --token rankcli_your_api_key_here
+# Install the MCP server
+npm install -g @rankcli/mcp-server
+```
 
-# Or set environment variable (recommended for CI)
-export RANKCLI_API_KEY=rankcli_your_api_key_here
+Configure in Claude Desktop:
+```json
+{
+  "mcpServers": {
+    "rankcli": {
+      "command": "npx",
+      "args": ["@rankcli/mcp-server"]
+    }
+  }
+}
 ```
 
-Generate API keys from [Account Settings](https://rankcli.dev/account) → API Keys.
+Now Claude has 12 SEO tools: `seo_analyze`, `seo_geo_check`, `seo_structured_data`, and more.
+
+### 🔧 Framework-Specific Fixes
 
-### Check Status
+Auto-generate fixes for 25+ frameworks:
 
 ```bash
-rankcli whoami
+rankcli apply --url https://mysite.com
 ```
 
-### Logout
+**Supported frameworks:**
+- **JS/TS**: React, Next.js (App/Pages), Vue, Nuxt, Angular, Svelte, SvelteKit, Astro, Remix, Gatsby, Solid.js, Qwik
+- **Backend**: Rails, Django, Laravel, Spring Boot, ASP.NET Core, Phoenix, Go (Gin/Echo/Fiber)
+- **SSG**: Hugo, Jekyll, Eleventy, Pelican
+- **Hypermedia**: HTMX, Hotwire/Turbo
 
-```bash
-rankcli logout
-```
+### 📊 7 Deep Analyzers
+
+| Analyzer | What It Does |
+|----------|--------------|
+| **GEO** | AI crawler access, LLM signals, citation readiness |
+| **Core Web Vitals** | LCP, CLS, INP, TTFB estimation |
+| **Security Headers** | HTTPS, HSTS, CSP (A+ to F grading) |
+| **Structured Data** | JSON-LD validation, rich results |
+| **Images** | Alt text, dimensions, modern formats |
+| **Internal Links** | Anchor text, orphan detection |
+| **Mobile SEO** | Viewport, touch targets, PWA |
 
 ## Commands
 
 ### `rankcli audit`
 
-Run a comprehensive SEO audit (280+ checks).
+Run comprehensive SEO audit (280+ checks).
 
 ```bash
 rankcli audit [options]
 
 Options:
   -u, --url <url>           URL to audit
-  -o, --output <format>     Output format: json, console (default: console)
+  -o, --output <format>     Output: json, console (default: console)
   --max-pages <n>           Max pages to crawl (default: 5)
-  --check-links             Check for broken internal/external links
-  --ai                      Enable AI-powered analysis
-  --ai-provider <provider>  AI provider: openai or anthropic
-  --ai-key <key>            API key (or set OPENAI_API_KEY/ANTHROPIC_API_KEY)
-```
-
-**Examples:**
-
-```bash
-# Basic audit
-rankcli audit --url https://example.com
-
-# Multi-page audit with JSON output
-rankcli audit --url https://example.com --max-pages 10 -o json > report.json
-
-# AI-enhanced audit
-rankcli audit --url https://example.com --ai
+  --geo                     Include GEO analysis
+  --check-links             Check broken links
+  --ai                      AI-powered analysis
 ```
 
 ### `rankcli apply`
 
-Generate and apply SEO fixes to your local codebase.
+Generate and apply framework-specific fixes.
 
 ```bash
-rankcli apply [options]
-
-Options:
-  -u, --url <url>   URL to analyze for fixes
-  --dry-run         Preview changes without applying
-  --auto            Apply all fixes without confirmation
-```
-
-**Examples:**
-
-```bash
-# Preview fixes
-rankcli apply --url https://mysite.com --dry-run
-
-# Apply fixes with confirmation
-rankcli apply --url https://mysite.com
-
-# Auto-apply all fixes (CI mode)
-rankcli apply --url https://mysite.com --auto
+rankcli apply --url https://mysite.com --dry-run   # Preview
+rankcli apply --url https://mysite.com --auto      # Auto-apply
 ```
 
 ### `rankcli keywords`
 
-AI-powered keyword research and analysis.
-
-```bash
-rankcli keywords [options]
-
-Options:
-  -u, --url <url>              Your website URL
-  -s, --seed <keywords>        Seed keywords (comma-separated)
-  --auto                       Auto-extract seed keywords from your page
-  --quick                      Quick mode - skip questions, use defaults
-  --ai                         Use GPT-4 for enhanced analysis
-  --local                      Force local processing (skip cloud worker)
-  --competitor                 Competitor gap analysis mode
-  -c, --competitors <domains>  Competitor domains (comma-separated)
-```
-
-**Examples:**
+AI-powered keyword research.
 
 ```bash
-# AI-powered keyword research
 rankcli keywords --url https://mysite.com --ai
-
-# Quick analysis with seed keywords
-rankcli keywords --url https://mysite.com --quick -s 'seo tools,seo audit'
-
-# Competitor gap analysis
-rankcli keywords --url https://mysite.com --competitor -c 'competitor1.com,competitor2.com' -s 'target keyword'
+rankcli keywords --competitor -c 'competitor.com' -s 'target keyword'
 ```
 
 ### `rankcli content`
 
-Analyze content for readability, keyword density, and featured snippets.
-
-```bash
-rankcli content [options]
-
-Options:
-  -u, --url <url>          URL to analyze
-  -k, --keyword <keyword>  Target keyword for analysis
-  --headline <headline>    Analyze a headline
-  --mode <mode>            Analysis mode (full, readability, headline, snippet, density)
-```
-
-**Examples:**
+Content analysis for readability and snippets.
 
 ```bash
-# Full content analysis
-rankcli content --url https://mysite.com/blog-post --keyword 'seo tips'
-
-# Analyze headline
-rankcli content --headline 'The Ultimate Guide to SEO'
+rankcli content --url https://mysite.com/blog --keyword 'seo tips'
 ```
 
-### `rankcli intent`
-
-Classify search intent for a keyword.
-
-```bash
-rankcli intent <keyword>
-```
-
-**Examples:**
-
-```bash
-rankcli intent 'buy running shoes'
-rankcli intent 'how to optimize images for seo'
-```
-
-### `rankcli setup`
-
-Configure tracking and CI/CD integrations.
-
-```bash
-rankcli setup [options]
-
-Options:
-  --ga4 <id>        Google Analytics 4 Measurement ID (G-XXXXXXXXXX)
-  --gsc <code>      Google Search Console verification code
-  --github-action   Set up automated GitHub Action
-  --schedule <freq> GitHub Action schedule (daily, weekly, monthly)
-  --all             Interactive setup wizard
-```
-
-**Examples:**
-
-```bash
-# Add GA4 tracking
-rankcli setup --ga4 G-XXXXXXXXXX
-
-# Create GitHub Actions workflow
-rankcli setup --github-action
-
-# Interactive setup wizard
-rankcli setup --all
-```
-
-### `rankcli init`
-
-Initialize RankCLI in your project.
+## Authentication
 
 ```bash
-rankcli init [options]
-
-Options:
-  -y, --yes   Skip prompts and use defaults
-```
-
-### `rankcli analyze`
+# Interactive login
+rankcli login
 
-AI-powered codebase analysis for SEO opportunities.
+# API key (for CI/CD)
+rankcli login --token rankcli_your_api_key
 
-```bash
-rankcli analyze [options]
-
-Options:
-  -v, --verbose   Show detailed output
+# Or environment variable
+export RANKCLI_API_KEY=rankcli_your_api_key
 ```
 
 ## CI/CD Integration
@@ -258,61 +169,46 @@ Options:
 
 ```yaml
 name: SEO Audit
-on:
-  push:
-    branches: [main]
-  pull_request:
+on: [push, pull_request]
 
 jobs:
   audit:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-
-      - name: Install RankCLI
-        run: npm install -g rankcli
-
-      - name: Run SEO Audit
-        run: rankcli audit --url ${{ secrets.SITE_URL }} -o json > audit.json
+      - run: npm install -g @rankcli/cli
+      - run: rankcli audit --url ${{ secrets.SITE_URL }} -o json > audit.json
         env:
           RANKCLI_API_KEY: ${{ secrets.RANKCLI_API_KEY }}
-
-      - name: Check for critical issues
+      - name: Fail on critical issues
         run: |
           errors=$(jq '.issues | map(select(.severity == "error")) | length' audit.json)
-          if [ "$errors" -gt 0 ]; then
-            echo "::error::Found $errors critical SEO issues"
-            exit 1
-          fi
+          [ "$errors" -eq 0 ] || exit 1
 ```
 
-### Environment Variables
+## Environment Variables
 
 | Variable | Description |
 |----------|-------------|
-| `RANKCLI_API_KEY` | API key for authentication (recommended for CI/CD) |
-| `OPENAI_API_KEY` | OpenAI API key for AI-powered features |
-| `ANTHROPIC_API_KEY` | Anthropic API key (alternative AI provider) |
-
-## Pricing Tiers
-
-| Feature | Anonymous | Free | Solo ($9/mo) | Pro ($29/mo) |
-|---------|-----------|------|--------------|--------------|
-| SEO Checks | 50 | 100 | 280+ | 280+ |
-| Cloud Sync | - | ✓ | ✓ | ✓ |
-| GitHub Connect | - | - | ✓ | ✓ |
-| Auto-Fix PRs | - | - | - | ✓ |
-| Sites | 0 | 1 | 3 | 10 |
+| `RANKCLI_API_KEY` | API key for authentication |
+| `OPENAI_API_KEY` | OpenAI API key for AI features |
+| `ANTHROPIC_API_KEY` | Anthropic API key (alternative) |
 
-## Documentation
+## Pricing
 
-Full documentation available at [rankcli.dev/docs](https://rankcli.dev/docs)
+| Feature | Free | Pro ($15/mo) |
+|---------|------|--------------|
+| SEO Checks | 100 | 280+ |
+| GEO Analysis | Basic | Full |
+| Framework Fixes | - | ✅ 25+ |
+| Auto-Fix PRs | - | ✅ |
+| Sites | 1 | 10 |
 
-## Support
+## Links
 
-- Documentation: [rankcli.dev/docs](https://rankcli.dev/docs)
-- GitHub Issues: [github.com/rankcli/rankcli/issues](https://github.com/rankcli/rankcli/issues)
-- Email: support@rankcli.dev
+- **Docs**: [rankcli.dev/docs](https://rankcli.dev/docs)
+- **GitHub**: [github.com/rankcli/rankcli](https://github.com/rankcli/rankcli)
+- **Support**: support@rankcli.dev
 
 ## License