get_geo_audit récupère un GEO Audit (audit one-shot white-label) par id. Tant que l'audit tourne, la réponse porte le status, un compteur de progression et un indice sur ce que l'audit attend. Une fois COMPLETED, la réponse inclut le contenu figé complet : concurrents sélectionnés, personas, recommandations, idées de contenu et contexte de l'audit.

Quand l'utiliser

Après avoir trouvé un audit avec list_geo_audits, appelez ce tool pour lire son contenu ou vérifier ce qu'il attend. Le champ status indique où en est l'audit dans son cycle de vie, y compris s'il est en pause sur la sélection des concurrents (REVIEWING).

Input

Champ	Type	Description
`auditId`	string (CUID)	L'id d'audit renvoyé par `list_geo_audits`. Le tool retourne `audit_not_found` si aucun audit avec cet id n'existe dans le workspace.
`include.pageContent`	boolean	Inclure le markdown des pages scrapées dans `auditContext.pages`. Off par défaut (champ lourd, plusieurs Ko par page) ; les pages retirées portent un indice `markdownLength`.
`maxPageChars`	integer	Quand `include.pageContent` est true, tronque le markdown de chaque page à ce nombre de caractères (met `markdownTruncated: true`).

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

Response

En cours

{
  "success": true,
  "auditId": "clx_audit_42",
  "status": "REVIEWING",
  "prospectUrl": "https://prospect.com",
  "brandName": "Prospect",
  "createdAt": "2026-06-20T09:00:00.000Z",
  "isComplete": false,
  "progress": { "received": 24, "expected": 24 },
  "message": "Scans done. The audit is paused at competitor selection — confirm/reject competitors before insights can be generated."
}

Le message dépend du status. REVIEWING signifie que l'audit attend la sélection des concurrents avant de pouvoir passer à la génération des insights.

Terminé

{
  "success": true,
  "auditId": "clx_audit_42",
  "status": "COMPLETED",
  "prospectUrl": "https://prospect.com",
  "brandName": "Prospect",
  "createdAt": "2026-06-20T09:00:00.000Z",
  "isComplete": true,
  "brandAliases": ["Prospect Inc"],
  "country": "US",
  "language": "en",
  "llms": ["CHATGPT", "PERPLEXITY"],
  "creditsCost": 24,
  "shareSlug": "prospect-9f3a",
  "selectedCompetitors": ["Acme", "Globex"],
  "personas": [ /* [{ id, name, description }] */ ],
  "recommendations": [ /* [{ category, severity, title, description, action, metric? }] */ ],
  "contentIdeas": [ /* [{ title, angle }] */ ],
  "auditContext": { /* { pages: [{ url, markdownLength }], siteMeta, scannedAt } — le markdown des pages est opt-in via include.pageContent */ },
  "completedAt": "2026-06-20T09:12:00.000Z"
}

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 isComplete, pas sur status. Les champs de contenu figé (recommendations, contentIdeas, …) n'apparaissent que quand isComplete: true.
Lisez progress pendant SCANNING pour estimer à quel point l'audit est proche de REVIEWING.
REVIEWING attend une décision : confirmer ou rejeter les concurrents passe par un flow d'écriture dédié, pas par ce tool de lecture.

Tools liés

list_geo_audits — lister tous les GEO Audits du workspace (du plus récent) sans poll chaque id.
get_page_audit — récupérer un Page Audit, un objet différent.