run_bulk_audit
run_bulk_audit, tool MCP : lancer un audit GEO en masse, un scan partagé et un rapport par cible, rejouable par ref.
Mis à jour le 2026-11-06
run_bulk_audit lance un audit GEO en masse : les questions sont scannées une fois, puis chaque cible reçoit son rapport à partir de ce scan partagé. La marque de chaque cible est lue sur son site, sauf si vous la donnez.
Quand l'utiliser
Pour auditer une liste de prospects d'un même segment. Pour des segments différents, lancez une campagne par segment, ou run_geo_audit site par site.
Paramètres
| Champ | Type | Défaut | Description |
|---|---|---|---|
targets |
object[] | requis | Les sites. Les crédits sont la seule limite à leur nombre |
targets[].ref |
string | requis | Votre identifiant pour cette cible, unique dans votre compte |
targets[].url |
string | requis | Site, http ou https. Pas de doublon |
targets[].brandName |
string | lu sur le site | Nom de la marque |
targets[].brandDescription |
string | lue sur le site | Ce que fait la marque, 2 000 caractères au plus. Sert au tri des concurrents et aux recommandations |
targets[].aliases |
string[] | aucun | Autres noms de la marque, 10 au plus. Une réponse qui en cite un compte comme une mention |
segmentTopic |
string | aucun | Thème du segment, repris dans les recommandations |
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 |
Questions et personas sont préparées d'après la première cible qui a une brandDescription, sinon d'après le premier site lisible parmi les 5 premières cibles.
Réponse
{
"success": true,
"created": true,
"bulkAuditId": "clx_bulk_1",
"creditsCost": 2100,
"skippedLlms": [],
"audits": [
{ "id": "clx_audit_1", "ref": "crm-1", "url": "https://a.example", "status": "PENDING", "creditsCost": 0, "shareUrl": "https://mentionable.ai/share/audit/3f9a1c7e2b6d4a10", "bulkAuditId": "clx_bulk_1", "skippedLlms": [], "failureReason": null }
]
}
created vaut false quand ces ref ont déjà été lancés ensemble. Des ref déjà utilisés ailleurs renvoient ref_taken.
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 : le scan partagé (questions × personas × occurrences × crédits de chaque moteur), plus un forfait par cible (
creditsPerBulkTargetdansget_audit_options), débité au lancement. - Suivre :
get_bulk_auditpour l'état,list_geo_auditsavecfilters.bulkAuditIdpour les rapports. - Choisir les concurrents : avec
reviewCompetitors: true, la campagne s'arrête àCURATINGjusqu'à l'appel deselect_bulk_audit_competitors.
Tools liés
- get_audit_options : moteurs, coût et crédits avant un lancement.
- get_bulk_audit : suivre la campagne.
- list_geo_audits : les rapports de la campagne.
- run_geo_audit : un seul site.