Ranki.io SEO/AEO consultant

Prefer the manual JSON snippet? Examples for each editor are in theInstallsection below.

You: audit my site speed and fix the slow images Claude: → Calling ranki.audit_speed(url="https://myapp.dev") ← Lighthouse: 42 perf · LCP 4.8s · 3 images blocking the paint. → Calling ranki.optimize_images([hero.png, banner.jpg, card.png])… ← 3 files, recipes returned. → Running sharp-cli to convert hero.png → hero.avif + hero.webp + hero@2x.avif… → Editing app/page.tsx — rewriting  as <picture srcset>, adding alt text… → Calling ranki.audit_speed again to verify… ← Lighthouse: 96 perf · LCP 1.4s. You: now find pages that shouldn't be in Google Claude: → Calling ranki.audit_hidden_pages(domain="https://myapp.dev") ← 8 robots-disallow, 12 noindex, 118 keep, 4 unsure. → Editing public/robots.txt to disallow /admin /dashboard /checkout /account… → Adding <meta name="robots" content="noindex"> to app/search/page.tsx… Done. Submit URL-removal requests in Search Console for the 8 admin pages.

The Skill file (inranki-seo-skills) tells your agent when to call which tool, in what order, and where in your repo to apply each fix.

{ "mcpServers": { "ranki": { "command": "npx", "args": ["-y", "@ranki.io/mcp"], "env": { "RANKI_API_KEY": "rk_live_..." } } } }

Restart Claude Desktop. The MCP indicator should showrankiwith 22 tools.

{ "mcpServers": { "ranki": { "url": "https://mcp.ranki.io", "headers": { "X-API-Key": "rk_live_..." } } } }

ChatGPT Desktop, Continue.dev, Zed, anything MCP-capable

If the client supports stdio MCP, use the Claude Desktop snippet. If it supports HTTP MCP, use the Cursor snippet.

You: I just shipped my Next.js app at https://myapp.com. What SEO do I need? Claude (via Ranki MCP): → Calling seo_starter_kit(domain="myapp.com") ← [Returns robots.txt + sitemap.xml + llms.txt + JSON-LD templates] → Writing public/robots.txt → Writing public/sitemap.xml (enumerating pages from app/ directory…) → Writing public/llms.txt → Adding JSON-LD <script> to app/layout.tsx → Calling audit_seo to verify… ← Score: 92/100. 🎉

Scenario 2: "Why isn't ChatGPT citing my docs?"

You: Why doesn't ChatGPT cite my docs site? Claude (via Ranki MCP): → Calling audit_aeo(url="https://docs.myproduct.com") ← Score 38/100. Failing: no FAQPage schema, no llms.txt, robots.txt blocks ClaudeBot. → Fixing each failure in your repo… ← Score 88/100. Re-deploy and ChatGPT should pick it up within 7-14 days.

Scenario 3: "I don't know what blog posts to write"

You: I have a Stripe alternative landing page but the blog is empty. Help. Claude (via Ranki MCP): → Calling find_topic_ideas(url="https://mystripe-alt.com") ← [Returns brief with topic generation methodology + 15-topic structure] → [Generates 15 topics organized by intent, picks top 3] ← Recommended first 3 articles: 1. "How to switch payment processors without losing customers" (transactional) 2. "Stripe vs us: side-by-side fee comparison for $10K/mo MRR" (commercial) 3. "What is interchange-plus pricing and why most SaaSes overpay" (informational)

Scenario 4: "What gap keywords am I missing?"

You: My competitors are stripe.com and lemonsqueezy.com. What am I missing? Claude (via Ranki MCP): → Calling find_keyword_gap(url="https://mystripe-alt.com", competitors=["stripe.com","lemonsqueezy.com"]) ← [Returns methodology + per-competitor analysis steps] → Crawling /blog on both competitors… → Cross-referencing against your sitemap… ← 5 high-value gaps found: - "PCI compliance for small SaaS" (covered by Stripe, not you) - "How to handle subscription dunning" (covered by both, not you) - … 3 more

┌────────────────────────┐ ┌──────────────────────────┐ │ Claude / Cursor / etc │ │ mcp.ranki.io (PHP) │ │ │ │ │ │ 1. Sees 22 tools │ JSON-RPC│ - 22 tool definitions │ │ 2. Decides to use one ├────────►│ - HTTP + stdio (npx) │ │ 3. Receives advice │ │ - 5/IP or 500/key per │ │ 4. Acts on the repo │ │ UTC day rate limit │ │ │ │ - REST API bridge │ └────────────────────────┘ └────────────┬─────────────┘ │ (only for keyed tools) ▼ ┌──────────────────────────┐ │ app.ranki.io REST API │ │ /api/v1/projects │ │ /api/v1/articles/... │ └──────────────────────────┘

# Acme Corp > Acme makes the SDK for shipping React Native apps faster. ## Key pages - Homepage - Documentation - Pricing - Blog ## About - Founded 2024, based in Berlin. - Used by 12,000+ teams including Linear and Notion. - Open source SDK on github.com/acme/sdk.

server { server_name mcp.yourdomain.com; root /var/www/ranki-mcp/server/public; index index.php; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { include fastcgi_params; fastcgi_pass unix:/run/php/php8.4-fpm.sock; fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; } }

Tool philosophy:return data + instructions for the calling AI, never call an LLM yourself.