run_geo_audit

run_geo_audit, tool MCP : lancer un audit GEO en marque blanche sur un site, rejouable par ref. Paramètres, coût, réponse, exemple JSON.

Mis à jour le 2026-11-06

run_geo_audit lance un audit GEO sur un site et renvoie son id et son URL de partage. Il suit le même chemin que le wizard d'audit : il lit le site, génère personas et questions si vous n'en donnez pas, puis lance les scans.

Quand l'utiliser

Pour auditer un prospect depuis un agent ou un workflow de CRM. L'appel peut durer jusqu'à une minute, le temps de lire le site. Les scans tournent ensuite en arrière-plan : interrogez get_geo_audit jusqu'à isComplete: true.

Paramètres

Champ Type Défaut Description
ref string requis Votre identifiant pour cette demande, unique dans votre compte. Le même ref renvoie le même audit sans nouveau débit
url string requis Site à auditer, http ou https
brandName string lu sur le site Nom de la marque
brandDescription string lue sur le site Ce que fait la marque, 2 000 caractères au plus. Remplace la lecture du site pour les personas, les questions, le tri des concurrents et les recommandations
aliases string[] aucun Autres noms de la marque, 10 au plus. Une réponse qui en cite un compte comme une mention
config.llms string[] requis Identifiants des moteurs, depuis get_audit_options
config.country string FR Pays des réponses (ISO 3166-1 alpha-2)
config.language string fr Langue du rapport
config.occurrences number 1 Passages de chaque question par moteur, 1 à 5
config.prompts string[] générées Questions à poser, 50 au plus. Absentes : générées d'après le site
config.promptCount number 20 Questions à générer quand prompts manque, 1 à 20
config.personas boolean ou object[] true true : pose chaque question à 3 à 5 personas générées d'après le site. Une liste de { name, description } (10 au plus) : ces personas-là, sans génération. Multiplie les scans
config.competitors object[] aucun Concurrents du rapport, { name, domain? }, 20 au plus. Retenus tels quels, sans tri automatique ni revue. domain relie le nom à la façon dont les moteurs l'écrivent
config.ctaId string aucun CTA du rapport partagé, depuis list_audit_ctas
config.teaserSections string[] [] Sections du rapport floutées derrière le CTA. ctaId requis
config.reviewCompetitors boolean false true : vous choisissez les concurrents. Sinon, les concurrents directs les plus cités sont retenus. Sans effet avec competitors
config.hideUnreliableLlms boolean false Retire les moteurs instables au lancement, écarte du rapport ceux sous 70 % des réponses attendues

Réponse

{
  "success": true,
  "created": true,
  "audit": {
    "id": "clx_audit_1",
    "ref": "crm-4821",
    "url": "https://www.example.com",
    "status": "PENDING",
    "creditsCost": 240,
    "shareUrl": "https://mentionable.ai/share/audit/3f9a1c7e2b6d4a10",
    "bulkAuditId": null,
    "skippedLlms": [],
    "failureReason": null
  }
}

created vaut false quand ce ref a déjà été lancé. skippedLlms liste les moteurs retirés par hideUnreliableLlms.

Erreurs : audits_unavailable (plan Agency actif, audits activés et clé d'un admin requis), credits_exhausted, invalid_llms, invalid_cta, site_unreadable, engines_unavailable, no_prompts. Chacune porte un message lisible.

Conseils

  • Coût : questions × personas × occurrences × crédits de chaque moteur. Les personas sont actives par défaut et multiplient les scans par 3 à 5. personas: false pose les questions telles quelles. Voir get_audit_options.
  • Réessais sans risque : renvoyez le même ref après un délai dépassé. Un audit FAILED repart de zéro avec le même ref.
  • Choisir les concurrents : avec reviewCompetitors: true, l'audit s'arrête à REVIEWING jusqu'à l'appel de select_geo_audit_competitors.

Tools liés

Vous pouvez voir où vous en êtes dès aujourd'hui.

Essai gratuit. Lancez le suivi de votre visibilité IA, sans carte.