select_geo_audit_competitors fige la sélection des concurrents d'un GEO Audit et le fait passer de REVIEWING à GENERATING, ce qui déclenche la génération des insights et recommandations. C'est la moitié écriture de la paire complétée par list_geo_audit_competitors, et ça supprime le goulot de review manuelle pour les agences qui produisent des audits en volume.

Quand l'utiliser

Après avoir lu les candidats avec list_geo_audit_competitors (quand reviewable vaut true), appelez ce tool avec les noms à garder. L'audit génère ensuite son rapport en asynchrone ; pollez get_geo_audit jusqu'à ce que status soit COMPLETED. Le tool ne marche que pendant REVIEWING et exige une clé API non read-only.

Input

Champ	Type	Description
`auditId`	string (CUID)	L'id du GEO Audit. Retourne `audit_not_found` s'il n'appartient pas à votre workspace.
`selectedCompetitors`	string[]	1 à 50 noms de concurrents à figer. Choisissez parmi les `suggestedCompetitors` renvoyés par `list_geo_audit_competitors`.

Les GEO Audits sont liés au workspace, donc ce tool ne prend pas de projectId.

Response

Succès

{
  "success": true,
  "auditId": "clx_audit_42",
  "status": "GENERATING",
  "selectedCompetitors": ["Acme", "Globex"],
  "message": "Selection frozen. The audit is now generating insights and recommendations; poll get_geo_audit until status is COMPLETED."
}

Pas en review

{ "success": false, "error": "not_in_review", "currentStatus": "SCANNING", "message": "Competitor selection is only possible while the audit is REVIEWING. This audit is in SCANNING." }

Introuvable

{ "success": false, "error": "audit_not_found", "message": "No GEO audit with this id exists in your workspace. Verify the auditId returned by list_geo_audits." }

Tips et patterns

Vérifiez reviewable d'abord via list_geo_audit_competitors pour éviter un aller-retour not_in_review.
La transition est atomique et idempotente à la frontière. Si l'audit a déjà dépassé REVIEWING (par ex. quelqu'un a soumis via l'UI), ce tool retourne not_in_review au lieu de re-déclencher la génération.
Puis pollez get_geo_audit jusqu'à COMPLETED pour lire recommendations et contentIdeas.

Tools liés

list_geo_audit_competitors — lire les candidats à choisir.
get_geo_audit — poller l'audit jusqu'à COMPLETED après la sélection.
list_geo_audits — trouver les audits en REVIEWING.