getAdvantage MCP

Dokumentasi API & MCP

Jalankan tiga pemindaian Advantage dari kode Anda sendiri, CI Anda, atau dari dalam editor AI Anda. Get Found mengukur bagaimana AI membaca URL langsung. Convert mengukur apakah pengunjung pertama kali akan mendaftar. Ship Verified memeriksa apa yang dikirim halaman yang seharusnya tidak dikirim. Setiap hasil adalah pengukuran yang diamati pada saat pemindaian — bukan vonis, sertifikasi, atau jaminan.

API gratis untuk dicoba tanpa kunci pada tarif per-IP. Kunci API menaikkan tarif ke tingkat paket Anda dan mengembalikan output model langsung pada paket berbayar. Spesifikasi yang dapat dibaca mesin ada di /api/openapi.json.

Mengapa menghubungkannya sekali? Agar Anda tidak memelihara AEO secara manual. Letakkan embed atau satu panggilan API ke dalam CI Anda dan perbaikan yang aman untuk DOM (JSON-LD, meta, FAQ) akan terus diterapkan sendiri; kami memeriksa ulang saat ChatGPT, Perplexity, Gemini & Claude mengubah cara mereka membaca situs, sehingga skor Anda tetap terkini tanpa Anda harus mengejar target. Alat netral mengawasi terus-menerus visibilitas AI dan keamanan pengiriman — pengawasan independen, bukan audit satu kali. (File llms.txt dan robots.txt Anda tetap menjadi file yang Anda tempatkan sekali.)

Autentikasi

Buat kunci di /app/api-keys (ditampilkan sekali — simpan sebagai rahasia lingkungan, jangan pernah commit). Kirim sebagai token Bearer pada permintaan apa pun:

curl "https://getadvantage.app/api/analyze?url=https://yourapp.com" \
  -H "Authorization: Bearer adv_live_…"

Tanpa header, Anda mendapatkan tingkat gratis tanpa kunci (tarif per-IP, output sampel). Dengan kunci, tarif mengikuti paket Anda dan paket berbayar mengembalikan output model langsung. Melebihi batas mengembalikan HTTP 429 dengan header retry-after; kunci tidak valid mengembalikan 401.

Batas tarif

Batas diamati per kunci (atau per IP, tanpa kunci) pada saat permintaan:

• Tanpa kunci: 5/menit · 30/hari, output sampel
• Starter: 60/menit · 1.000/hari, output langsung
• Pro: 120/menit · 5.000/hari, output langsung
• Agency: 240/menit · 20.000/hari (penggunaan wajar), output langsung

Endpoint gabungan dihitung sebagai satu tick pada tarif per-engine yang sama (tidak pernah membebani tiga kali untuk satu panggilan).

Endpoint

GET /api/analyze?url=

Get Found — pemindaian keterbacaan AI (9 sinyal)

Menilai seberapa mudah halaman dibaca oleh mesin AI di sembilan sinyal (judul, deskripsi meta, data terstruktur, heading, llms.txt, rasio konten-ke-markup, Open Graph, kanonikal, robots). Mengembalikan rincian per sinyal, perbaikan siap-tempel, dan llms.txt starter yang dihasilkan.

curl "https://getadvantage.app/api/analyze?url=https://yourapp.com"

GET /api/verify-convert?url=

Convert — kesiapan konversi + pembacaan dingin 5 detik

Menilai sinyal yang menentukan apakah pengunjung pertama kali memahami aplikasi dan mendaftar. Pada kunci berbayar, juga menjalankan tes kesan pertama agen 5 detik. Mengembalikan pemeriksaan, perbaikan, persentil benchmark, dan laporan /v yang dapat dibagikan.

curl "https://getadvantage.app/api/verify-convert?url=https://yourapp.com"

GET /api/verify-safety?url=

Ship Verified — pemeriksaan keamanan pengiriman + lencana

Menjalankan pemeriksaan deterministik untuk eksposur umum vibe-coded (rahasia di bundel klien, konfigurasi backend, file yang terekspos, header keamanan, CORS, transport, source maps). Pemeriksaan yang lulus berarti kami tidak menemukan masalah spesifik itu — tidak pernah berarti aplikasi aman atau tersertifikasi. Mengembalikan pemeriksaan, perbaikan, persentil benchmark, laporan /v, dan lencana "Checked by Advantage".

curl "https://getadvantage.app/api/verify-safety?url=https://yourapp.com"

POST /api/v1/scan/combined

Combined — ketiga engine, satu panggilan

Menjalankan ketiga engine pada satu URL dan mengembalikan satu payload: tiga blok skor independen (tidak pernah dirata-rata), ringkasan irisan yang menyebutkan dimensi terlemah dan langkah besar berikutnya, dan satu permalink. Cara tercepat untuk mendapatkan gambaran lengkap dalam satu permintaan.

curl -X POST "https://getadvantage.app/api/v1/scan/combined" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer adv_live_…" \
  -d '{"url":"https://yourapp.com"}'

Server MCP — pindai dari dalam editor Anda

Advantage juga merupakan server Model Context Protocol, sehingga Anda dapat menambahkannya sekali ke Claude Code, Cursor, Claude Desktop, atau Windsurf dan cukup ketik "scan my app with getadvantage". Ia berbicara Streamable HTTP jarak jauh (transport jarak jauh resmi saat ini) — tanpa instalasi, pemindaian berjalan di server kami. Ia mengekspos empat alat: get_found, convert_check, ship_verified, dan combined_scan. Masing-masing diawali dengan skor dan perbaikan siap-tempel terbesar, serta menyertakan tautan laporan.

Tambahkan (Cursor / Claude Desktop / Claude Code)

Letakkan ini ke konfigurasi klien MCP Anda:

{
  "mcpServers": {
    "getadvantage": {
      "url": "https://getadvantage.app/api/mcp"
    }
  }
}

Dengan kunci API (tarif lebih tinggi, output langsung), tambahkan header:

{
  "mcpServers": {
    "getadvantage": {
      "url": "https://getadvantage.app/api/mcp",
      "headers": { "Authorization": "Bearer adv_live_…" }
    }
  }
}

Atau, di Claude Code, satu baris:

claude mcp add --transport http getadvantage https://getadvantage.app/api/mcp

Server MCP gratis untuk dicoba tanpa kunci pada tarif tanpa kunci; kunci menaikkan tarif dan mengembalikan output langsung, persis seperti API HTTP.

Ingin melacak situs, melihat riwayat, dan menerapkan perbaikan otomatis melalui embed? Buat akun — atau pindai satu aplikasi gratis terlebih dahulu.