getAdvantage MCP

API ve MCP dokümanları

Üç Advantage taramasını kendi kodunuzdan, CI sürecinizden veya AI editörünüzün içinden çalıştırın. Get Found, AI'ın canlı bir URL'yi nasıl okuduğunu ölçer. Convert, ilk kez gelen bir ziyaretçinin kaydolup kaydolmayacağını ölçer. Ship Verified, sayfanın göndermemesi gereken neyi gönderdiğini kontrol eder. Her sonuç, tarama anında gözlemlenen bir ölçümdür — asla bir karar, sertifika veya garanti değildir.

API, anahtar olmadan IP başına ücretsiz denenebilir. Bir API anahtarı, hızı planınızın katmanına yükseltir ve ücretli planda canlı model çıktısı döndürür. Makine tarafından okunabilir şartname /api/openapi.json adresindedir.

Neden bir kez bağlayasınız? AEO'yu elle bakım yapmamanız için. Embed'i veya tek bir API çağrısını CI sürecinize ekleyin; DOM-güvenli düzeltmeler (JSON-LD, meta, SSS) kendilerini uygulamaya devam eder; ChatGPT, Perplexity, Gemini ve Claude siteleri okuma şekillerini değiştirdikçe biz yeniden kontrol ederiz, böylece hedefi kovalamadan puanlarınız güncel kalır. Tarafsız bir araç, AI-görünürlüğü ve gönderim-güvenliği üzerinde sürekli gözetim sağlar — tek seferlik bir denetim değil, bağımsız denetim. (llms.txt ve robots.txt dosyalarınız bir kez yerleştirdiğiniz dosyalar olarak kalır.)

Kimlik doğrulama

/app/api-keys adresinde bir anahtar oluşturun (yalnızca bir kez gösterilir — ortam sırrı olarak saklayın, asla commit etmeyin). Herhangi bir istekte Bearer token olarak gönderin:

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

Başlık olmadan anahtarsız ücretsiz katmanı alırsınız (IP başına hız, örneklenmiş çıktı). Anahtarla, hız planınızı takip eder ve ücretli plan canlı model çıktısı döndürür. Limiti aşmak HTTP 429 ve bir retry-after başlığı döndürür; geçersiz bir anahtar 401 döndürür.

Hız limitleri

Limitler istek zamanında anahtar başına (veya anahtarsız IP başına) gözlemlenir:

• Anahtarsız: 5/dk · 30/gün, örneklenmiş çıktı
• Başlangıç: 60/dk · 1.000/gün, canlı çıktı
• Pro: 120/dk · 5.000/gün, canlı çıktı
• Acente: 240/dk · 20.000/gün (adil kullanım), canlı çıktı

Birleşik uç nokta, aynı motor başına hızda tek bir tik olarak sayılır (tek çağrı için asla üç kez ücretlendirmez).

Uç noktalar

GET /api/analyze?url=

Get Found — AI-okunabilirlik taraması (9 sinyal)

Sayfanın AI motorlarına dokuz sinyal üzerinden ne kadar okunaklı olduğunu puanlar (başlık, meta açıklama, yapılandırılmış veri, başlıklar, llms.txt, içerik-işaretleme oranı, Open Graph, canonical, robots). Sinyal başına döküm, yapıştırmaya hazır düzeltmeler ve oluşturulmuş bir başlangıç llms.txt döndürür.

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

GET /api/verify-convert?url=

Convert — dönüşüm hazırlığı + 5 saniyelik soğuk okuma

İlk kez gelen bir ziyaretçinin uygulamayı anlayıp kaydolup kaydolmayacağına karar veren sinyalleri puanlar. Ücretli anahtarda ayrıca aracı tabanlı 5 saniyelik ilk izlenim testi çalıştırır. Kontroller, düzeltmeler, bir kıyaslama yüzdelik dilimi ve paylaşılabilir bir /v raporu döndürür.

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

GET /api/verify-safety?url=

Ship Verified — gönderim-güvenliği kontrolleri + rozet

Yaygın vibe-kodlu maruziyetler için deterministik kontroller çalıştırır (istemci paketindeki sırlar, arka uç yapılandırması, açıkta kalan dosyalar, güvenlik başlıkları, CORS, taşıma, kaynak haritaları). Geçen bir kontrol, belirli sorunu bulmadığımız anlamına gelir — asla uygulamanın güvenli veya sertifikalı olduğu anlamına gelmez. Kontroller, düzeltmeler, bir kıyaslama yüzdelik dilimi, bir /v raporu ve bir "Advantage tarafından kontrol edildi" rozeti döndürür.

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

POST /api/v1/scan/combined

Birleşik — üç motor, tek çağrı

Üç motoru tek bir URL üzerinde çalıştırır ve tek bir yük döndürür: üç bağımsız puan bloğu (asla ortalaması alınmaz), en zayıf boyutu ve en büyük tek sonraki hamleyi adlandıran bir kesişim özeti ve tek bir kalıcı bağlantı. Tek istekte tüm resmi almanın en hızlı yolu.

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"}'

MCP sunucusu — editörünüzün içinden tarayın

Advantage ayrıca bir Model Context Protocol sunucusudur, bu yüzden Claude Code, Cursor, Claude Desktop veya Windsurf'a bir kez ekleyip sadece "uygulamamı getadvantage ile tara" yazabilirsiniz. Uzak Streamable HTTP (mevcut resmi uzak taşıma) konuşur — sıfır kurulum, taramalar bizim sunucularımızda çalışır. Dört araç sunar: get_found, convert_check, ship_verified ve combined_scan. Her biri puanla ve en büyük yapıştırmaya hazır düzeltmeyle başlar ve rapor bağlantısını içerir.

Ekleyin (Cursor / Claude Desktop / Claude Code)

Bunu MCP istemci yapılandırmanıza ekleyin:

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

API anahtarıyla (daha yüksek hız, canlı çıktı), başlığı ekleyin:

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

Veya Claude Code'da, tek satır:

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

MCP sunucusu, anahtarsız katmanda anahtar olmadan ücretsiz denenebilir; bir anahtar hızı yükseltir ve HTTP API ile tamamen aynı şekilde canlı çıktı döndürür.

Siteleri takip etmek, geçmişi görmek ve embed aracılığıyla düzeltmeleri otomatik uygulamak mı istiyorsunuz? Bir hesap oluşturun — veya önce bir uygulamayı ücretsiz tarayın.