getAdvantage MCP Server

Autentikasi

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

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

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

Batas rate

Batas diterapkan 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 rate per-engine yang sama (tidak pernah mengenakan biaya 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, canonical, 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 + cold-read 5 detik

Menilai sinyal yang menentukan apakah pengunjung pertama kali memahami aplikasi dan mendaftar. Pada kunci berbayar, juga menjalankan tes kesan pertama agentik 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 paparan umum vibe-coded (secret di bundle klien, konfigurasi backend, file yang terpapar, header keamanan, CORS, transport, source maps). Pemeriksaan yang lulus berarti kami tidak menemukan masalah spesifik tersebut — bukan 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 terbesar berikutnya, serta 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”. Ini menggunakan remote Streamable HTTP (transport remote resmi saat ini) — tanpa instalasi, pemindaian berjalan di server kami. Ini menyediakan empat alat: get_found, convert_check, ship_verified, dan combined_scan. Masing-masing menampilkan skor dan perbaikan siap tempel terbesar, serta menyertakan tautan laporan.

Menambahkannya (Cursor / Claude Desktop / Claude Code)

Masukkan ini ke dalam konfigurasi klien MCP Anda:

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

Dengan kunci API (rate 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 rate tanpa kunci; kunci meningkatkan rate dan mengembalikan output langsung, persis seperti HTTP API.

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

Tanya Ray