list_geo_audit_responses

Tool MCP list_geo_audit_responses : chaque réponse des IA d'un GEO Audit, avec son texte, les positions des marques, les sources et les recherches.

Mis à jour le 2026-11-06

list_geo_audit_responses renvoie les réponses d'un GEO Audit une par une. Chaque ligne correspond à une question posée à une IA, pour un persona et un passage. Elle donne le texte de la réponse, si la marque auditée est citée et à quelle position, les concurrents cités avec leur position, les sources citées par l'IA et les recherches qu'elle a lancées. C'est la matière brute derrière les métriques de get_geo_audit, la même donnée que le rapport partagé montre réponse par réponse.

Quand l'utiliser

Appelez-le quand un agent doit citer ce qu'une IA a vraiment répondu, comprendre pourquoi une marque manque dans une réponse, ou reconstruire son propre rapport à partir des réponses. get_geo_audit donne la vue d'ensemble (visibilité, questions jouées, domaines les plus cités, recommandations) ; ce tool donne les preuves. Il marche sur un audit terminé, sur un audit en cours (les réponses déjà reçues) et sur une cible d'audit en masse.

Input

Champ Type Défaut Description
auditId string (CUID) - L'id du GEO Audit renvoyé par list_geo_audits, ou l'id d'une cible d'audit en masse. Renvoie audit_not_found s'il n'appartient pas à votre workspace.
limit integer (1-50) 10 Réponses par page. Les textes sont longs : gardez des pages courtes.
cursor string - Curseur opaque tiré de pageInfo.nextCursor de la page précédente.
maxResponseChars integer (min 1) 3000 Longueur maximale du texte de chaque réponse. Une réponse plus longue est coupée et signalée par responseTruncated.
filters.llm enum - Une seule IA, par sa clé (par exemple CHATGPT). get_audit_options liste les clés.

Les GEO Audits appartiennent au workspace : le tool ne prend pas de projectId. Une clé limitée à certains projets ne peut pas lire les audits.

Réponse

{
  "data": [
    {
      "id": "cmw5ewvxp006dzko7tekni1rx",
      "question": "Quel cabinet de conseil RH choisir pour une PME ?",
      "persona": null,
      "llm": "CHATGPT",
      "brandMentioned": true,
      "brandPosition": 4,
      "sentiment": "positive",
      "competitors": [
        { "name": "Lumen Partners", "position": 1, "context": "**Lumen Partners** (lumenpartners.com) : souvent cité dans les comparatifs.", "url": "lumenpartners.com" }
      ],
      "citations": ["https://www.lumenpartners.com/", "https://www.trustpilot.com/comparatif"],
      "webSearchQueries": ["Quel cabinet de conseil RH choisir pour une PME ?"],
      "createdAt": "2026-11-06T20:13:44.749Z",
      "response": "Voici les options les plus recommandées...",
      "responseLength": 574,
      "responseTruncated": false
    }
  ],
  "pageInfo": { "hasMore": true, "nextCursor": "cmw5ewvxp006dzko7tekni1rx", "totalCount": 120 },
  "summary": { "hiddenLlms": [] }
}

Notes sur les champs :

  • Les lignes sont triées par question, puis par IA. persona vaut { id, name } quand l'audit a tourné avec des personas, null sinon.
  • brandPosition est le rang de la marque parmi les marques nommées dans la réponse, null si elle n'est pas citée. sentiment vaut positive, neutral ou negative quand elle est citée.
  • competitors liste les autres marques nommées dans la réponse, avec leur position et la phrase qui les nomme.
  • citations sont les URL citées par l'IA. webSearchQueries sont les recherches lancées avant de répondre (vide pour les IA qui ne les exposent pas).
  • responseLength est la longueur complète de la réponse : l'agent sait combien a été coupé.
  • summary.hiddenLlms liste les IA écartées faute d'assez de réponses exploitables. Leurs réponses n'apparaissent jamais, même avec filters.llm.
  • Pour une cible d'audit en masse, les réponses viennent du scan partagé de la campagne, et les champs de la marque sont ceux de cette cible.

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." }

Conseils et patterns

  • Lire la synthèse d'abord. Appelez get_geo_audit pour les métriques, puis ce tool seulement pour les réponses à citer ou à examiner.
  • Filtrer par IA. filters.llm garde les réponses d'une seule IA, et totalCount devient le nombre de réponses de cette IA.
  • Relever la limite seulement si besoin. Les 3 000 caractères par défaut couvrent la plupart des réponses. Passez un maxResponseChars plus grand avec un limit plus petit pour lire une longue réponse en entier.
  • Même donnée que l'API REST. GET /api/v1/audits/{id}/responses renvoie les mêmes lignes, avec le texte complet.

Tools liés

Vous pouvez voir où vous en êtes dès aujourd'hui.

Essai gratuit. Lancez le suivi de votre visibilité IA, sans carte.