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 (creditsPerBulkTarget dans get_audit_options), débité au lancement.
  • Suivre : get_bulk_audit pour l'état, list_geo_audits avec filters.bulkAuditId pour les rapports.
  • Choisir les concurrents : avec reviewCompetitors: true, la campagne s'arrête à CURATING jusqu'à l'appel de select_bulk_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.