list_geo_audits

list_geo_audits retourne les GEO Audits (audits one-shot white-label) du workspace, du plus récent au plus ancien. Chaque ligne porte le status, l'URL prospect auditée, le nom de marque, le pays et la langue ciblés, les LLMs sélectionnés et un compteur de progression. Contrairement aux Page Audits, les GEO Audits sont liés au workspace, pas à un projet précis, donc ce tool ne prend pas de projectId.

Quand l'utiliser

• Pour les agences qui produisent beaucoup d'audits via le MCP : lister tout le workspace et lire l'état de chaque audit sans ouvrir l'UI.
• Pour repérer les audits bloqués à la sélection des concurrents (filtre status=REVIEWING) avant qu'ils ne puissent passer à la génération des insights.
• Pour suivre lesquels sont passés à COMPLETED et sont prêts à lire avec get_geo_audit.

Ce tool ne liste que les GEO Audits one-shot. Il ne retourne pas les Page Audits (OptimizationReport) ; utilisez list_page_audits pour ceux-là.

Input

Champ	Type	Défaut	Description
cursor	string	—	Cursor renvoyé dans pageInfo.nextCursor.
limit	int	20	Items max, 1–100.
status	enum	—	PENDING, SCANNING, REVIEWING, GENERATING, COMPLETED. Omettre pour tout retourner.

Response

{
  "data": [
    {
      "id": "clx_audit_42",
      "prospectUrl": "https://prospect.com",
      "brandName": "Prospect",
      "status": "REVIEWING",
      "country": "US",
      "language": "en",
      "llms": ["CHATGPT", "PERPLEXITY"],
      "creditsCost": 24,
      "shareSlug": "prospect-9f3a",
      "progress": { "received": 6, "expected": 24 },
      "createdAt": "2026-06-20T09:00:00.000Z",
      "completedAt": null
    }
  ],
  "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": 1 }
}

Notes :

• status suit le cycle de vie du GEO Audit : PENDING (créé, scan pas démarré), SCANNING (scans LLM en cours), REVIEWING (scans finis, en pause sur la sélection des concurrents), GENERATING (concurrents choisis, insights en cours d'écriture), COMPLETED (figé, rapport prêt).
• progress.received / progress.expected comptent les résultats de scan. Ils permettent d'estimer à quel point un audit SCANNING est proche de REVIEWING.
• completedAt est null tant que l'audit n'a pas atteint COMPLETED.

Tips et patterns

• Pagination : le cursor est l'id de l'audit. Stable entre pages.
• À combiner avec get_geo_audit : ce tool renvoie de la metadata uniquement. Pour lire les recommandations, les idées de contenu et les concurrents sélectionnés, appelez get_geo_audit avec l'id.
• Surveiller REVIEWING : un audit en REVIEWING attend qu'un humain (ou un agent) confirme les concurrents. Remontez-les pour qu'ils ne stagnent pas en silence.

Tools liés

• get_geo_audit — récupérer un GEO Audit (contenu complet quand COMPLETED).
• list_page_audits — lister les Page Audits (optimisations de page), un objet différent.