Ranki.io SEO/AEO consultant

Ranki MCP — Konsultan SEO, AEO, kecepatan, dan optimasi gambar gratis untuk Cursor, Claude Code, Windsurf, dan ChatGPT

MCP yang tidak hanya melaporkan — agen Anda yang memperbaiki. Audit URL apa pun untuk SEO dan Answer Engine Optimization, mengukur Core Web Vitals nyata melalui Google PageSpeed Insights, dan menginstruksikan agen Anda untuk mengonversi gambar ke AVIF dan WebP, menulis ulang tag <img> menjadi <picture> responsif dengan srcset dan alt, menyisipkan skema JSON-LD, menghasilkan sitemap.xml / llms.txt / robots.txt, mengklasifikasikan halaman tersembunyi — lalu menjalankan ulang audit untuk membuktikan skornya meningkat. Semua di dalam Claude Code, Claude Desktop, Cursor, Windsurf, dan ChatGPT Desktop.

Instal dalam satu baris

npx @ranki.io/cli install

CLI secara otomatis mendeteksi editor AI mana yang telah Anda instal (Claude Code, Claude Desktop, Cursor, Windsurf, ChatGPT Desktop), menulis konfigurasi MCP yang tepat di tempat yang tepat, dan mengunduh file Skill pendamping dari repositori ranki-seo-skills. Jalankan ulang npx @ranki.io/cli update nanti untuk menyegarkan Skill; npx @ranki.io/cli check memverifikasi pengaturan.

Lebih suka potongan JSON manual? Contoh untuk setiap editor ada di bagian Instal di bawah.

Dua implementasi, alat yang sama

Repositori ini mengirimkan MCP dalam dua implementasi paritas sehingga Anda dapat memilih yang sesuai dengan tumpukan Anda:

• server/ — referensi PHP 8.4, penerapan produksi yang mendukung mcp.ranki.io. Dihosting, diperkuat, tanpa dependensi, berjalan di belakang Cloudflare. Inilah yang mendasari mcp.ranki.io.
• ts-server/ — referensi Node / TypeScript, diterbitkan sebagai @ranki.io/seo-aeo-mcp di npm. Alternatif Node asli untuk pengembang yang lebih menyukai peralatan JavaScript, dapat diinstal melalui npx -y @ranki.io/seo-aeo-mcp (stdio) atau npx @ranki.io/seo-aeo-mcp --serve (HTTP).

Keduanya mengekspos 22 alat yang sama dengan output JSON, perlindungan SSRF, semantik batas laju, dan postur keamanan yang sama. Implementasi TS menjalankan 15 alat gratis secara native di Node, dan memproksikan 7 alat jembatan berbayar ke REST API yang sama di app.ranki.io yang digunakan server PHP. Tidak ada yang pernah membuka basis data — alat berbayar melewati middleware ApiKeyAuth Laravel dan dibatasi pada data pengguna yang memanggil.

Apa yang sebenarnya dilakukan — 22 alat

Server MCP mengekspos 22 alat. Agen Anda memanggilnya seperti alat MCP lainnya; mereka mengembalikan laporan Markdown yang dirender agen Anda secara inline dan kemudian ditindaklanjuti — mengonversi file, menulis ulang HTML, menghasilkan yang baru, mengkomit hasilnya.

Audit

• audit_seo(url) — Kartu skor SEO on-page 10 pemeriksaan: panjang judul, deskripsi meta, keunikan H1, kanonikal, viewport, HTTPS, kelengkapan OpenGraph, cakupan alt gambar, jumlah tautan internal, keberadaan JSON-LD. Mengembalikan skor 0–100 dengan resep perbaikan per kegagalan.
• audit_aeo(url) — Kartu skor Answer Engine Optimization 8 pemeriksaan: JSON-LD FAQPage / Article, intro definisional di bawah 80 kata, byline penulis, keberadaan llms.txt, robots.txt mengizinkan GPTBot / ClaudeBot / PerplexityBot, judul H2/H3 gaya jawaban, tabel perbandingan.
• audit_hidden_pages(urls, domain) — mengklasifikasikan setiap jalur sebagai robots-disallow, noindex, keep, atau unsure dengan alasan. Menangkap rute admin, endpoint API, draf, halaman login, dasbor akun, halaman terima kasih, artefak build, dan URL hasil pencarian. Mengembalikan blok robots.txt siap tempel.

Kecepatan dan gambar — ini adalah bagian yang tidak dilakukan oleh yang lain

• audit_speed(url, strategy) — skor Lighthouse nyata (Performa, Aksesibilitas, SEO, Praktik Terbaik) dan Core Web Vitals (LCP, CLS, INP, FCP, TTFB) melalui Google PageSpeed Insights. Mengembalikan peluang gambar dengan byte yang dihemat per file, JS / CSS pemblokir render, dan audit SEO on-page yang gagal. Strategi default adalah mobile (Google memberi peringkat mobile-first).
• audit_core_web_vitals(url) — satu paragraf per metrik dengan resep perbaikan literal. "Elemen LCP adalah hero.png pada 2,4 MB, konversi ke WebP menghemat 1,8 MB → -1,1 detik LCP." Mengambil URL elemen LCP dari Lighthouse sehingga agen tahu persis file mana yang harus dioptimalkan.
• optimize_images(images, max_width) — untuk setiap gambar: format target (AVIF + WebP), lebar responsif 1×/2×, saran teks alt, perintah literal sharp-cli / cwebp / avifenc, dan blok <picture> siap tempel dengan srcset. Agen Anda menjalankan konversi secara lokal di repositori dan menulis ulang tag <img>.

Hasilkan

• generate_sitemap_xml(urls) — membangun sitemap.xml siap deploy dari daftar URL dengan stempel waktu lastmod terkini.
• generate_llms_txt(site_name, summary, key_pages) — menghasilkan llms.txt, standar yang muncul untuk memberi tahu perayap AI tentang situs Anda dan halaman mana yang harus dikutip.
• generate_robots_txt(sitemap_url, allow_ai, disallow_paths) — membangun robots.txt yang secara eksplisit mengizinkan atau menolak GPTBot, ChatGPT-User, ClaudeBot, anthropic-ai, PerplexityBot, dan Google-Extended.

Konten dan strategi

• seo_starter_kit(domain) — mengembalikan empat file dasar yang hilang dari sebagian besar situs yang dibuat dengan vibe-coding (robots.txt, sitemap.xml, llms.txt, JSON-LD) siap ditempel ke repositori Anda.
• find_topic_ideas(url) — membaca beranda Anda, menyimpulkan niche Anda, dan mengembalikan brief terstruktur untuk menghasilkan 15 topik artikel di seluruh intent informasional, komersial, dan transaksional dengan kriteria prioritas.
• find_keyword_gap(url, competitors) — mengembalikan metodologi langkah demi langkah untuk menemukan kata kunci yang diperingkat oleh pesaing tetapi tidak oleh Anda. Jika tidak ada pesaing yang diberikan, instruksikan editor Anda untuk bertanya terlebih dahulu.
• propose_titles_metas(urls, focus_keyword) — mengekstrak judul, h1, dan paragraf pertama aktual dari setiap URL (atau menerima deskripsi teks bebas untuk halaman yang belum di-deploy), lalu mengembalikan tabel Markdown dengan 5 kandidat judul dan deskripsi meta per halaman di 5 sudut (deskriptif, berorientasi manfaat, format pertanyaan, angka spesifik, kata kunci pertama). Setiap kandidat ditandai untuk kepatuhan panjang.
• explain_seo_terms(category) — glosarium referensi 40+ istilah SEO dan AEO: SEO, AEO, GEO, JSON-LD, FAQPage, kanonikal, llms.txt, Core Web Vitals, E-E-A-T, pembaruan konten bermanfaat, halaman doorway, dan lainnya. Filter berdasarkan kategori: dasar, AEO, teknis, analitik, penalti.

Instal

• install_skill(agent) — mengembalikan perintah instal untuk Skill ranki-seo-skills di Claude Code, Claude Desktop, Cursor, Windsurf, Proyek web Claude.ai, dan agen AGENTS.md generik.

Akun Ranki.io Anda — data peringkat nyata di dalam IDE Anda (kunci API berbayar)

• get_account() — whoami untuk kunci API Anda: nama, email, paket, batas harian dan bulanan, penggunaan saat ini.
• list_projects() — mencantumkan proyek di akun Ranki.io Anda.
• list_articles(project_id) — indeks artikel yang dipaginasi dalam sebuah proyek: nano_id, judul, status, bahasa, focus_keyword[], kerangka TOC, jumlah kata, skor SEO. Filter status opsional.
• get_article(article_id) — mengambil satu artikel berdasarkan nano_id-nya: judul, HTML, kata kunci fokus, daftar isi, URL gambar tersemat, skor SEO.
• list_rank_tracking(project_id) — ringkasan Google Search Console untuk sebuah proyek: total 28 hari, 20 kata kunci teratas berdasarkan klik, 20 kata kunci peluang teratas (posisi > 10 dengan impresi — kemenangan mudah).
• list_gsc_keywords(project_id) — daftar kata kunci GSC terpaginasi penuh, dapat diurutkan berdasarkan klik / impresi / posisi / CTR.
• ai_visibility(project_id) — cuplikan kutipan AI yang direkam: topik terlacak Anda yang mana yang muncul di SERP ChatGPT, Claude, Perplexity, dan Google AI Overview pada waktu pengambilan.

Seperti apa sesi tipikal

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 <img> 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.

File Skill (di ranki-seo-skills) memberi tahu agen Anda kapan harus memanggil alat yang mana, dalam urutan apa, dan di mana di repositori Anda untuk menerapkan setiap perbaikan.

Batas laju

Tingkat	Batas harian	Cakupan	Alat yang tersedia
Tanpa kunci	5 panggilan	per IP	15 alat gratis (audit, generator, kecepatan, optimasi gambar, strategi konten, instal)
Kunci API Ranki.io	500 panggilan	per kunci	Semua 22 alat, termasuk 7 alat jembatan yang membaca kata kunci GSC nyata Anda, pelacakan peringkat, kutipan AI, daftar proyek, dan pustaka artikel dari akun Ranki.io Anda

Dapatkan kunci di app.ranki.io/developer. X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset dikembalikan pada setiap respons. Pesan kesalahan dispatcher menyertakan hitung mundur reset dan jalur peningkatan.

---

Instal

Claude Desktop / Claude Code (direkomendasikan untuk sebagian besar vibe-coder)

Tambahkan ke ~/.claude/claude_desktop_config.json:

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

Mulai ulang Claude Desktop. Indikator MCP seharusnya menunjukkan ranki dengan 22 alat.

Cursor (transport HTTP, tidak perlu npx)

.cursor/mcp.json di proyek Anda:

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

ChatGPT Desktop, Continue.dev, Zed, apa pun yang mampu MCP

Jika klien mendukung MCP stdio, gunakan potongan Claude Desktop. Jika mendukung MCP HTTP, gunakan potongan Cursor.

Dapatkan kunci API gratis Anda

Kunjungi app.ranki.io/developer dan klik Reveal. Kunci Anda sudah ada — setiap akun Ranki.io mendapat satu yang dibuat otomatis. Alat penasihat gratis berfungsi tanpa kunci (5 panggilan/IP/hari); alat jembatan list_projects dan get_article memerlukannya.

---

Bagaimana vibe-coder menggunakannya

Skenario 1: "Saya baru saja mengirimkan situs, apa yang harus saya lakukan?"

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. 🎉

Skenario 2: "Mengapa ChatGPT tidak mengutip dokumen saya?"

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.

Skenario 3: "Saya tidak tahu posting blog apa yang harus ditulis"

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)

Skenario 4: "Kata kunci celah apa yang saya lewatkan?"

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

---

Arsitektur

┌────────────────────────┐         ┌──────────────────────────┐
│  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/...    │
                                   └──────────────────────────┘

Dua transport

• stdio (Claude Desktop, Claude Code, sebagian besar klien MCP) — instal paket npm @ranki.io/mcp, yang merupakan shim Node.js 50 baris yang memproksikan JSON-RPC stdio ke https://mcp.ranki.io.
• HTTP (Cursor, klien kustom) — arahkan langsung ke https://mcp.ranki.io. Tidak perlu instal Node.

Tata letak repositori

ranki-mcp/
├── server/                     # PHP MCP server (deployed to mcp.ranki.io)
│   ├── public/index.php        #   GET → marketing landing page (HTML)
│   ├── index.php               #   POST → JSON-RPC 2.0 dispatcher
│   ├── lib/
│   │   ├── jsonrpc.php         #   JSON-RPC reply helpers
│   │   ├── registry.php        #   Tool registry + REST API bridge
│   │   └── ratelimit.php       #   Per-IP rate limit (5/day for free tier)
│   └── tools/
│       ├── seo_starter_kit.php
│       ├── find_topic_ideas.php
│       ├── find_keyword_gap.php
│       ├── audit_aeo.php
│       ├── audit_seo.php
│       ├── generate_sitemap_xml.php
│       ├── generate_llms_txt.php
│       ├── generate_robots_txt.php
│       ├── list_projects.php
│       └── get_article.php
└── npx/                        # Node.js stdio shim (published as @ranki.io/mcp)
    ├── package.json
    ├── index.js                #   ~50 lines: stdin→POST→stdout
    └── README.md

---

SEO vs AEO — apa bedanya?

SEO (Search Engine Optimization) adalah membuat situs Anda mendapat peringkat di 10 tautan biru klasik di Google. Sinyalnya: tag judul, deskripsi meta, H1, kanonikal, peta situs, tautan internal, kecepatan halaman, ramah seluler, HTTPS. Alat seperti Ahrefs / SEMrush / SurferSEO menilai ini.

AEO (Answer Engine Optimization) adalah membuat situs Anda dikutip ketika ChatGPT, Claude, Perplexity, atau Google AI Overviews menjawab pertanyaan pengguna. Sinyalnya berbeda:

• JSON-LD FAQPage — sinyal kutipan terbesar tunggal.
• Intro definisional — paragraf pertama adalah jawaban ringkas "X adalah …".
• Byline penulis + E-E-A-T — LLM lebih suka sumber yang dikutip dengan penulis bernama.
• llms.txt — undangan eksplisit bagi LLM untuk menggunakan konten Anda.
• robots.txt mengizinkan bot AI — GPTBot / ClaudeBot / PerplexityBot TIDAK boleh diblokir.
• Judul gaya jawaban — H2/H3 difrasekan sebagai pertanyaan ("Apa itu X?", "Bagaimana cara kerja X?").
• Tabel perbandingan — elemen HTML dengan kutipan tertinggi di AI Overviews.

audit_aeo memeriksa semua 8 ini dan memberi tahu AI Anda persis apa yang harus diperbaiki. Pada tahun 2026, lalu lintas AEO adalah saluran SEO dengan pertumbuhan tercepat dan sebagian besar situs tidak memiliki cakupan sama sekali.

---

llms.txt — standar pencarian AI yang muncul

Terinspirasi oleh robots.txt tetapi untuk LLM. File Markdown di /llms.txt memberi tahu perayap AI:

• Tentang apa situs Anda (dalam bahasa Inggris sederhana, bukan metadata).
• Halaman mana yang paling penting.
• Cara mengutip Anda.

# Acme Corp

> Acme makes the SDK for shipping React Native apps faster.

## Key pages

- [Homepage](https://acme.dev/)
- [Documentation](https://acme.dev/docs)
- [Pricing](https://acme.dev/pricing)
- [Blog](https://acme.dev/blog)

## About

- Founded 2024, based in Berlin.
- Used by 12,000+ teams including Linear and Notion.
- Open source SDK on github.com/acme/sdk.

Gunakan generate_llms_txt untuk membuatnya dalam 5 detik.

---

Self-hosting

Server MCP adalah PHP 8.4 biasa — tanpa framework, tanpa basis data, tanpa dependensi Composer. Letakkan direktori server/ di belakang vhost Nginx yang melayani public/index.php dan selesai.

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;
  }
}

lib/ratelimit.php menggunakan file di /tmp/ untuk pembatasan laju berbasis IP — berfungsi langsung. Untuk pembatasan laju berbasis Redis dalam skala besar, tukar implementasinya.

---

Berkontribusi

PR dipersilakan untuk alat penasihat baru. Untuk menambahkan alat:

1. Buat server/tools/your_tool.php yang mengembalikan function (array $args, string $apiKey): array yang dapat dipanggil.
2. Kembalikan rk_mcp_text_content("...your structured advice...").
3. Daftarkan alat di server/lib/registry.php di bawah rk_mcp_tool_definitions().

Penamaan alat: <verb>_<noun> snake_case (mis. audit_aeo, find_topic_ideas).

Filosofi alat: kembalikan data + instruksi untuk AI pemanggil, jangan pernah memanggil LLM sendiri.

---

Tanya Jawab

Apakah ini berbayar?

Alat penasihat (semua kecuali list_projects / get_article) gratis — 5 panggilan per IP per hari UTC. Untuk menghapus batasan itu, dapatkan kunci API gratis di app.ranki.io/developer. Alat jembatan memerlukan kunci karena mengambil data pribadi Ranki.io Anda.

Apakah Ranki MCP menggunakan kredit Claude saya?

Ya — dan hanya milik Anda. Kami tidak pernah melakukan panggilan LLM. Server MCP mengembalikan saran terstruktur; Claude / Cursor Anda mengevaluasi dan bertindak berdasarkan itu menggunakan kredit Anda sendiri.

Ke mana data mengalir?

• Alat penasihat (audit_*, generate_*, seo_starter_kit, find_*) mengambil URL yang Anda berikan (tidak ada panggilan jaringan lain).
• Alat jembatan (list_projects, get_article) memanggil app.ranki.io/api/v1/... melalui HTTPS dengan X-API-Key Anda.
• Kami tidak mencatat isi permintaan. Kami mencatat IP + nama alat + status respons untuk pembatasan laju + debugging.

Apakah ini sumber terbuka?

Ya — lisensi MIT, sumber lengkap di repo ini.

Bisakah saya menjalankannya di dalam VPC perusahaan saya?

Ya — server/ adalah PHP biasa, tidak ada ketergantungan layanan eksternal kecuali app.ranki.io untuk alat jembatan (yang dapat Anda nonaktifkan dengan menghapus file alat tersebut).

Apa bedanya dengan kompetitor seperti Surfer / Frase / Outrank?

Itu adalah dasbor SaaS yang mengaudit satu URL pada satu waktu dan merekomendasikan perubahan. Ranki MCP adalah lapisan protokol yang memungkinkan AI Anda menggunakan audit tersebut secara inline saat menulis kode di IDE Anda. Bentuk berbeda, titik harga berbeda (gratis), audiens berbeda (vibe-coder, bukan profesional SEO).

Saya seorang vibe-coder dan tidak tahu apa arti AEO.

Itulah tepatnya untuk siapa ini dibuat. Mulailah dengan seo_starter_kit("yourdomain.com") — Claude Anda akan memandu Anda melalui semuanya.

Apakah Anda akan melatih AI dengan data saya?

Kami tidak melatih model. Kami tidak memiliki model. Kami adalah penasihat tipis di atas pemeriksaan deterministik.

---

Lisensi

MIT. Lihat LICENSE.

Dibangun dengan sepenuh hati oleh Ranki.io — otomatisasi AI SEO + AEO untuk pendiri, agensi, dan kreator.