select_bulk_audit_competitors

select_bulk_audit_competitors fige la sélection des concurrents d'une campagne d'audit GEO en masse et la fait passer de CURATING à GENERATING, ce qui déclenche la génération des insights de segment pour toutes les cibles d'un coup. C'est la moitié écriture de la paire complétée par list_bulk_audit_competitors.

Quand l'utiliser

Après avoir lu les candidats avec list_bulk_audit_competitors (quand curatable vaut true), appelez ce tool avec les noms à garder. Un seul appel débloque tout le lot : N rapports sont générés à partir de la même liste curée. Exige une clé API non read-only.

Input

Response

Succès

{
  "success": true,
  "bulkAuditId": "clx_bulk_42",
  "status": "GENERATING",
  "selectedCompetitors": ["Acme", "Globex"],
  "message": "Selection frozen for every target. The campaign is now generating segment insights; poll get_bulk_audit until status is COMPLETED."
}

Pas en curation

{ "success": false, "error": "not_in_curation", "currentStatus": "SCANNING", "message": "Competitor curation is only possible while the campaign is CURATING. This campaign is in SCANNING." }

Introuvable

{ "success": false, "error": "bulk_audit_not_found", "message": "No bulk campaign with this id exists in your workspace. Verify the bulkAuditId returned by list_bulk_audits." }

Tips et patterns

• Vérifiez curatable d'abord via list_bulk_audit_competitors pour éviter un aller-retour not_in_curation.
• La transition est atomique. Si la campagne a déjà dépassé CURATING (soumission depuis l'app, ou appel concurrent gagnant), ce tool retourne not_in_curation au lieu de relancer la génération une deuxième fois.
• Puis pollez get_bulk_audit jusqu'à COMPLETED, et lisez le rapport de chaque cible via list_geo_audits({ filters: { bulkAuditId } }).

Tools liés

• list_bulk_audit_competitors : lire les candidats à choisir.
• get_bulk_audit : poller la campagne jusqu'à COMPLETED.
• select_geo_audit_competitors : l'équivalent pour un audit simple.