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: falsepose les questions telles quelles. Voirget_audit_options. - Réessais sans risque : renvoyez le même
refaprès un délai dépassé. Un auditFAILEDrepart de zéro avec le mêmeref. - Choisir les concurrents : avec
reviewCompetitors: true, l'audit s'arrête àREVIEWINGjusqu'à l'appel deselect_geo_audit_competitors.
Tools liés
- get_audit_options : moteurs, coût et crédits avant un lancement.
- get_geo_audit : suivre l'audit, puis lire le rapport.
- run_bulk_audit : plusieurs sites, un scan partagé.
- create_audit_cta : le CTA du rapport partagé.