list_geo_audit_competitors

list_geo_audit_competitors retourne les concurrents candidats d'un GEO Audit, extraits de ses résultats de scan et classés par nombre de mentions, plus les noms déjà figés dans la sélection. C'est la liste que l'agence cure pendant que l'audit est en REVIEWING (l'étape de sélection des concurrents). C'est la moitié lecture de la paire complétée par select_geo_audit_competitors.

Quand l'utiliser

Quand un GEO Audit atteint REVIEWING, appelez ce tool pour voir quels concurrents les LLMs ont fait remonter pour le prospect. Sélectionnez les pertinents, puis passez leurs noms à select_geo_audit_competitors pour débloquer la génération des insights. Utile pour les agences qui automatisent les audits en volume, pour que l'étape de review ne devienne pas un goulot manuel.

Input

Champ	Type	Défaut	Description
auditId	string (CUID)	—	L'id du GEO Audit renvoyé par list_geo_audits. Retourne audit_not_found s'il n'appartient pas à votre workspace.
limit	integer (1-200)	50	Nombre max de candidats par page. Les candidats sont triés par mentions décroissantes : la première page contient déjà les plus forts.
cursor	string	—	Curseur opaque issu du pageInfo.nextCursor d'une page précédente, pour récupérer la suivante.

Les GEO Audits sont liés au workspace, donc ce tool ne prend pas de projectId. Un seul audit peut faire remonter des centaines de candidats bruts (surtout une longue traîne à une mention), donc la liste est paginée.

Response

{
  "success": true,
  "auditId": "clx_audit_42",
  "status": "REVIEWING",
  "reviewable": true,
  "selectedCompetitors": [],
  "suggestedCompetitors": [
    { "name": "Acme", "count": 7, "context": "Acme is a popular option for...", "url": "https://acme.com" },
    { "name": "Globex", "count": 4, "context": null, "url": null }
  ],
  "pageInfo": { "hasMore": true, "nextCursor": "50", "totalCount": 1413 }
}

Notes :

• suggestedCompetitors est agrégé depuis tous les résultats de scan de l'audit. count = le nombre de réponses LLM qui ont mentionné le concurrent ; context = la première phrase de mention vue (pour désambiguïser) ; url = la première URL citée, le cas échéant.
• pageInfo pagine la liste des candidats : totalCount = nombre total de candidats distincts, hasMore / nextCursor permettent de parcourir la suite. Repassez nextCursor comme cursor pour la page suivante.
• reviewable est true uniquement quand status vaut REVIEWING, le seul statut où une sélection peut être soumise.
• selectedCompetitors reflète ce qui est déjà figé (vide tant que la sélection n'est pas soumise).

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

• Branchez sur reviewable. S'il est false, n'appelez pas select_geo_audit_competitors : l'audit n'attend pas de sélection.
• Classez, puis choisissez. suggestedCompetitors est pré-trié par count ; les premières entrées sont les candidats les plus forts. La première page (50 par défaut) suffit presque toujours à curer ; les pages suivantes sont la longue traîne à une mention.
• À combiner avec get_geo_audit pour lire le cycle de vie du statut et, une fois COMPLETED, ses recommandations.

Tools liés

• select_geo_audit_competitors — figer la sélection et faire passer l'audit en GENERATING.
• get_geo_audit — récupérer le statut de l'audit et, une fois complet, son contenu.
• list_geo_audits — trouver les audits en REVIEWING.