get_geo_audit

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 les metrics de visibilité structurées, les prompts réellement joués, les domaines les plus cités, et 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).

Lisez tous les chiffres dans metrics. Les mêmes valeurs apparaissent en prose dans les recommandations générées (« 0 mention sur 148 réponses »), mais cette formulation change à chaque régénération : ce n'est pas un contrat.

Input

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",
  "domain": "prospect.com",
  "brandName": "Prospect",
  "bulkAuditId": null,
  "bulkLabel": null,
  "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",
  "domain": "prospect.com",
  "brandName": "Prospect",
  "bulkAuditId": null,
  "bulkLabel": null,
  "createdAt": "2026-06-20T09:00:00.000Z",
  "isComplete": true,
  "metrics": {
    "totalResponses": 148,
    "brandMentions": 0,
    "visibilityScore": 0,
    "rank": 7,
    "competitorCount": 6,
    "promptsWithoutBrand": 20,
    "competitors": [
      { "name": "Acme", "mentions": 16, "share": 10.8 },
      { "name": "Globex", "mentions": 15, "share": 10.1 }
    ],
    "byLlm": [{ "llm": "CHATGPT", "responses": 50, "brandMentions": 0 }],
    "byPersona": [{ "personaId": "730b39cd", "responses": 30, "brandMentions": 0 }]
  },
  "prompts": [
    { "id": "clx_prompt_1", "text": "J'ai la peau qui tiraille, je prends quoi ?", "personaId": "730b39cd", "responses": 6, "brandMentions": 0 }
  ],
  "topSources": [{ "domain": "doctissimo.fr", "citations": 23 }],
  "brandAliases": ["Prospect Inc"],
  "country": "US",
  "language": "en",
  "llms": ["CHATGPT", "PERPLEXITY"],
  "creditsCost": 24,
  "shareSlug": "prospect-9f3a",
  "reportUrl": "https://mentionable.ai/share/audit/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"
}

Notes :

• Une réponse = un prompt × un LLM × un persona × une occurrence. metrics.totalResponses les compte toutes.
• visibilityScore = brandMentions / totalResponses en pourcentage, une décimale.
• rank commence à 1 : 1 plus le nombre de concurrents curés cités strictement plus souvent que la marque. Si aucun concurrent n'est cité plus souvent, la marque est 1.
• Les mentions d'un concurrent comptent les réponses où il apparaît, pas ses occurrences dans une réponse. Seuls les concurrents curés (selectedCompetitors) sont comptés, donc les chiffres collent au rapport partagé.
• metrics.byPersona[].personaId correspond à personas[].id ; null est le lot des prompts sans persona. C'est cette répartition qui montre une marque visible auprès du grand public et absente des réponses au prescripteur.
• promptsWithoutBrand compte les prompts dont aucune réponse ne mentionne la marque.
• topSources agrège les domaines cités dans les réponses, du plus cité au moins cité, plafonné par topSourcesLimit.
• domain est l'hôte du prospect sans protocole, sans www., sans slash final : la clé de jointure avec une base de prospects externe.
• reportUrl est absolu (le domaine du workspace en marque blanche, mentionable.ai sinon), plus besoin de concaténer shareSlug soi-même.

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. metrics, prompts, topSources et les champs de contenu figé (recommendations, contentIdeas, …) n'apparaissent que quand isComplete: true. domain, bulkAuditId et bulkLabel sont là dès le début.
• Ne parsez jamais la prose. metrics est le contrat, la formulation des recommandations non.
• 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_fix : récupérer le correctif d'une page d'un projet suivi, un objet différent.