getAdvantage MCP

API- & MCP-Dokumentation

Führen Sie die drei Advantage-Scans aus Ihrem eigenen Code, Ihrer CI oder direkt in Ihrem KI-Editor aus. Get Found misst, wie KI eine Live-URL liest. Convert misst, ob ein Erstbesucher sich anmelden würde. Ship Verified prüft, was die Seite ausgeliefert hat, was sie nicht hätte ausliefern sollen. Jedes Ergebnis ist eine beobachtete Messung zum Scan-Zeitpunkt – niemals ein Urteil, eine Zertifizierung oder eine Garantie.

Die API kann ohne Schlüssel kostenlos mit einem Pro-IP-Limit getestet werden. Ein API-Schlüssel erhöht das Limit auf die Stufe Ihres Tarifs und liefert bei einem kostenpflichtigen Plan Live-Modellausgaben. Die maschinenlesbare Spezifikation finden Sie unter /api/openapi.json.

**Warum einmal integrieren?**Damit Sie AEO nicht manuell pflegen müssen. Fügen Sie das Embed oder einen API-Aufruf in Ihre CI ein, und die DOM-sicheren Korrekturen (JSON-LD, Meta, FAQ) werden automatisch angewendet. Wir prüfen erneut, wenn ChatGPT, Perplexity, Gemini & Claude ändern, wie sie Websites lesen, damit Ihre Scores aktuell bleiben, ohne dass Sie dem Ziel hinterherjagen. Ein neutrales Tool überwacht kontinuierlich KI-Sichtbarkeit und ausgelieferte Sicherheit – unabhängige Aufsicht, kein einmaliges Audit. (Ihre llms.txt- und robots.txt-Dateien bleiben Dateien, die Sie einmal platzieren.)

Authentifizierung

Erstellen Sie einen Schlüssel unter /app/api-keys (wird nur einmal angezeigt – speichern Sie ihn als Umgebungsgeheimnis, committen Sie ihn niemals). Senden Sie ihn als Bearer-Token mit jeder Anfrage:

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

Ohne den Header erhalten Sie das schlüssellose kostenlose Limit (Pro-IP-Limit, Stichprobenausgabe). Mit einem Schlüssel folgt das Limit Ihrem Tarif, und ein kostenpflichtiger Plan liefert Live-Modellausgaben. Bei Überschreitung des Limits wird HTTP 429 mit einem retry-after-Header zurückgegeben; ein ungültiger Schlüssel gibt 401 zurück.

Rate-Limits

Limits werden pro Schlüssel (oder pro IP, schlüssellos) zum Zeitpunkt der Anfrage beobachtet:

• Schlüssellos: 5/min · 30/Tag, Stichprobenausgabe
• Starter: 60/min · 1.000/Tag, Live-Ausgabe
• Pro: 120/min · 5.000/Tag, Live-Ausgabe
• Agentur: 240/min · 20.000/Tag (faire Nutzung), Live-Ausgabe

Der kombinierte Endpunkt zählt als ein Tick zum gleichen Pro-Engine-Limit (er berechnet nie dreimal für einen Aufruf).

Endpunkte

GET /api/analyze?url=

Get Found – KI-Lesbarkeits-Scan (9 Signale)

Bewertet, wie gut lesbar die Seite für KI-Engines über neun Signale ist (Titel, Meta-Beschreibung, strukturierte Daten, Überschriften, llms.txt, Inhalts-zu-Markup-Verhältnis, Open Graph, Canonical, Robots). Gibt eine Aufschlüsselung pro Signal, einfügefertige Korrekturen und eine generierte Starter-llms.txt zurück.

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

GET /api/verify-convert?url=

Convert – Conversion-Bereitschaft + 5-Sekunden-Kaltlesung

Bewertet die Signale, die entscheiden, ob ein Erstbesucher die App versteht und sich anmeldet. Mit einem kostenpflichtigen Schlüssel wird zusätzlich ein agentischer 5-Sekunden-Ersteindruck-Test ausgeführt. Gibt Prüfungen, Korrekturen, einen Benchmark-Perzentilwert und einen teilbaren /v-Bericht zurück.

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

GET /api/verify-safety?url=

Ship Verified – Sicherheitsprüfungen für Ausgeliefertes + Abzeichen

Führt deterministische Prüfungen auf häufige Vibe-Coding-Expositionen durch (Geheimnisse im Client-Bundle, Backend-Konfiguration, exponierte Dateien, Sicherheits-Header, CORS, Transport, Source Maps). Eine bestandene Prüfung bedeutet, dass wir dieses spezifische Problem nicht gefunden haben – niemals, dass die App sicher oder zertifiziert ist. Gibt Prüfungen, Korrekturen, einen Benchmark-Perzentilwert, einen /v-Bericht und ein „Checked by Advantage“-Abzeichen zurück.

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

POST /api/v1/scan/combined

Kombiniert – alle drei Engines, ein Aufruf

Führt alle drei Engines über eine URL aus und gibt ein Payload zurück: drei unabhängige Score-Blöcke (niemals gemittelt), eine Schnittmengen-Zusammenfassung, die die schwächste Dimension und den größten nächsten Schritt benennt, sowie einen Permalink. Der schnellste Weg, das Gesamtbild in einer einzigen Anfrage zu erhalten.

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-Server – Scan direkt aus Ihrem Editor

Advantage ist auch ein Model Context Protocol-Server, sodass Sie ihn einmal zu Claude Code, Cursor, Claude Desktop oder Windsurf hinzufügen und einfach „scan my app with getadvantage“ tippen können. Er spricht Remote-Streamable-HTTP (den aktuellen offiziellen Remote-Transport) – keine Installation, die Scans laufen auf unseren Servern. Er stellt vier Tools bereit: get_found, convert_check, ship_verified und combined_scan. Jedes beginnt mit dem Score und der größten einfügefertigen Korrektur und enthält den Berichtslink.

Hinzufügen (Cursor / Claude Desktop / Claude Code)

Fügen Sie dies in Ihre MCP-Client-Konfiguration ein:

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

Mit einem API-Schlüssel (höheres Limit, Live-Ausgabe) fügen Sie den Header hinzu:

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

Oder in Claude Code eine Zeile:

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

Der MCP-Server ist ohne Schlüssel kostenlos zum Testen mit dem schlüssellosen Limit; ein Schlüssel erhöht das Limit und liefert Live-Ausgaben, genau wie bei der HTTP-API.

Möchten Sie Websites verfolgen, Verlauf sehen und Korrekturen automatisch über das Embed anwenden? Konto erstellen – oder zuerst eine App kostenlos scannen.