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.
personavaut{ id, name }quand l'audit a tourné avec des personas,nullsinon. brandPositionest le rang de la marque parmi les marques nommées dans la réponse,nullsi elle n'est pas citée.sentimentvautpositive,neutralounegativequand elle est citée.competitorsliste les autres marques nommées dans la réponse, avec leur position et la phrase qui les nomme.citationssont les URL citées par l'IA.webSearchQueriessont les recherches lancées avant de répondre (vide pour les IA qui ne les exposent pas).responseLengthest la longueur complète de la réponse : l'agent sait combien a été coupé.summary.hiddenLlmsliste les IA écartées faute d'assez de réponses exploitables. Leurs réponses n'apparaissent jamais, même avecfilters.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_auditpour les métriques, puis ce tool seulement pour les réponses à citer ou à examiner. - Filtrer par IA.
filters.llmgarde les réponses d'une seule IA, ettotalCountdevient 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
maxResponseCharsplus grand avec unlimitplus petit pour lire une longue réponse en entier. - Même donnée que l'API REST.
GET /api/v1/audits/{id}/responsesrenvoie les mêmes lignes, avec le texte complet.
Tools liés
- get_geo_audit : statut, métriques, questions et domaines les plus cités de l'audit.
- list_geo_audits : retrouver les ids des audits du workspace.
- list_geo_audit_competitors : concurrents candidats agrégés sur toutes les réponses.
- get_bulk_audit : une campagne d'audit en masse et ses cibles.