getAdvantage MCP

Documentation API & MCP

Exécutez les trois analyses Advantage depuis votre propre code, votre CI, ou depuis l'intérieur de votre éditeur IA. Get Found mesure comment l'IA lit une URL en direct. Convert mesure si un visiteur pour la première fois s'inscrirait. Ship Verified vérifie ce que la page a mis en ligne qu'elle n'aurait pas dû. Chaque résultat est une mesure observée au moment de l'analyse — jamais un verdict, une certification ou une garantie.

L'API est gratuite à essayer sans clé à un débit par IP. Une clé API augmente le débit au niveau de votre forfait et renvoie la sortie du modèle en direct sur un forfait payant. La spécification lisible par machine se trouve à /api/openapi.json.

Pourquoi l'intégrer une seule fois ? Pour ne pas maintenir manuellement l'AEO. Intégrez l'embed ou un appel API dans votre CI et les correctifs sûrs pour le DOM (JSON-LD, meta, FAQ) continuent de s'appliquer tout seuls ; nous revérifions à mesure que ChatGPT, Perplexity, Gemini & Claude changent leur façon de lire les sites, afin que vos scores restent à jour sans que vous ayez à courir après la cible. Un outil neutre surveille en continu la visibilité IA et la sécurité du contenu livré — une supervision indépendante, pas un audit ponctuel. (Vos fichiers llms.txt et robots.txt restent des fichiers que vous placez une seule fois.)

Authentification

Créez une clé à /app/api-keys (affichée une seule fois — stockez-la comme secret d'environnement, ne la committez jamais). Envoyez-la comme jeton Bearer sur toute requête :

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

Sans l'en-tête, vous obtenez le niveau gratuit sans clé (débit par IP, sortie échantillonnée). Avec une clé, le débit suit votre forfait et un forfait payant renvoie la sortie du modèle en direct. Au-delà de la limite, vous obtenez HTTP 429 avec un en-tête retry-after ; une clé invalide renvoie 401.

Limites de débit

Les limites sont observées par clé (ou par IP, sans clé) au moment de la requête :

• Sans clé : 5/min · 30/jour, sortie échantillonnée
• Starter : 60/min · 1 000/jour, sortie en direct
• Pro : 120/min · 5 000/jour, sortie en direct
• Agence : 240/min · 20 000/jour (usage raisonnable), sortie en direct

Le point de terminaison combiné compte comme un seul tick au même débit par moteur (il ne facture jamais trois fois pour un seul appel).

Points de terminaison

GET /api/analyze?url=

Get Found — analyse de lisibilité IA (9 signaux)

Évalue la lisibilité de la page pour les moteurs IA sur neuf signaux (titre, méta-description, données structurées, titres, llms.txt, ratio contenu/markup, Open Graph, canonical, robots). Renvoie une ventilation par signal, des correctifs prêts à coller, et un llms.txt de démarrage généré.

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

GET /api/verify-convert?url=

Convert — préparation à la conversion + lecture à froid de 5 secondes

Évalue les signaux qui déterminent si un visiteur pour la première fois comprend l'application et s'inscrit. Avec une clé payante, il exécute également un test agentique de première impression en 5 secondes. Renvoie des vérifications, des correctifs, un percentile de référence, et un rapport /v partageable.

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

GET /api/verify-safety?url=

Ship Verified — vérifications de sécurité du contenu livré + badge

Exécute des vérifications déterministes pour les expositions courantes liées au « vibe-coding » (secrets dans le bundle client, configuration backend, fichiers exposés, en-têtes de sécurité, CORS, transport, source maps). Une vérification réussie signifie que nous n'avons pas trouvé ce problème spécifique — jamais que l'application est sécurisée ou certifiée. Renvoie des vérifications, des correctifs, un percentile de référence, un rapport /v, et un badge « Checked by Advantage ».

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

POST /api/v1/scan/combined

Combiné — les trois moteurs, un seul appel

Exécute les trois moteurs sur une seule URL et renvoie une seule charge utile : trois blocs de score indépendants (jamais moyennés), un résumé d'intersection nommant la dimension la plus faible et la prochaine action la plus importante, et un permalien. Le moyen le plus rapide d'obtenir une vue d'ensemble en une seule requête.

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

Serveur MCP — analyse depuis votre éditeur

Advantage est également un serveur Model Context Protocol, vous pouvez donc l'ajouter une fois à Claude Code, Cursor, Claude Desktop, ou Windsurf et simplement taper « scan my app with getadvantage ». Il parle en Streamable HTTP distant (le transport distant officiel actuel) — zéro installation, les analyses s'exécutent sur nos serveurs. Il expose quatre outils : get_found, convert_check, ship_verified, et combined_scan. Chacun commence par le score et le correctif prêt à coller le plus important, et inclut le lien du rapport.

L'ajouter (Cursor / Claude Desktop / Claude Code)

Ajoutez ceci à votre configuration client MCP :

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

Avec une clé API (débit plus élevé, sortie en direct), ajoutez l'en-tête :

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

Ou, dans Claude Code, une seule ligne :

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

Le serveur MCP est gratuit à essayer sans clé au débit sans clé ; une clé augmente le débit et renvoie la sortie en direct, exactement comme l'API HTTP.

Vous voulez suivre des sites, voir l'historique, et appliquer automatiquement les correctifs via l'embed ? Créez un compte — ou analysez une application gratuitement d'abord.