get_prompt_result

Tool MCP get_prompt_result : le détail complet d'un ou plusieurs résultats de prompt : réponse brute du LLM (opt-in), sources citées séparées visibles/cachées, appels fan-out et mentions concurrents. Inputs, shape de réponse, exemple JSON.

Mis à jour le 2026-10-09

get_prompt_result renvoie le détail complet d'un ou plusieurs résultats de prompt par id : les sources citées (séparées en visibles et cachées), les appels de recherche fan-out lancés par le LLM, les mentions de concurrents et, en opt-in, la réponse brute du LLM. Il accepte jusqu'à 10 ids dans un seul appel, pour qu'une IA puisse tirer tous les LLMs d'une même date de scan d'un coup. Chaque section est activable indépendamment pour garder des payloads minimaux.

Quand l'utiliser

Appelez ce tool après que list_prompt_results vous a donné les ids qui vous intéressent. C'est la moitié "lourde" du pattern lecture-de-l'historique : c'est ici que la réponse brute et la liste complète des sources voyagent vraiment. Comme la réponse brute est le champ le plus lourd (une réponse LLM complète, souvent plusieurs Ko), elle est désactivée par défaut. Mettez include.response = true quand vous avez besoin du texte, et plafonnez-le avec maxResponseChars si vous ne voulez que le début.

Input

Champ Type Défaut Description
projectId string (CUID) requis Projet qui doit posséder chaque résultat (sert au contrôle d'accès).
resultId string (CUID) - Un id de résultat unique. Fournir celui-ci ou resultIds.
resultIds string[] (CUID) - 1 à 10 ids de résultat récupérés en un appel.
include.response boolean false Inclure la réponse brute du LLM. Off par défaut (champ le plus lourd).
include.sources boolean true Inclure les sources citées (visibles + cachées).
include.fanOut boolean true Inclure les appels fan-out (queries + sources) et les résultats de recherche web du moteur (searchResults).
include.competitors boolean false Inclure les mentions de concurrents.
include.localPlaces boolean false Inclut la carte d'établissements (ChatGPT) ou le local pack (Google AI Overview) affiché à côté de la réponse.
include.products boolean false Inclut les produits nommés dans la réponse (projets e-commerce), avec les données de leur carte et leurs sources.
maxResponseChars integer - Tronquer la réponse brute à ce nombre de caractères (met truncated: true).

Response

data contient un objet par résultat résolu, dans l'ordre demandé. errors liste les ids non trouvés ou n'appartenant pas au projet, sans bloquer le reste du batch. Une section n'apparaît que si son flag include est activé.

{
  "success": true,
  "data": [
    {
      "id": "clx_res_2001",
      "promptId": "clx_prompt_07",
      "promptText": "best affordable AI visibility tracker",
      "country": "US",
      "date": "2026-06-08T06:01:00.000Z",
      "trackingRunId": "clx_run_88",
      "llm": "PERPLEXITY",
      "persona": { "id": "clx_persona_1", "name": "Solo founder" },
      "mentioned": true,
      "mentionCount": 2,
      "brandPosition": 3,
      "sentiment": "positive",
      "mentionContext": "Cité parmi les trackers de visibilité IA abordables.",
      "response": {
        "text": "There are several affordable options...",
        "length": 4820,
        "truncated": false
      },
      "sources": {
        "visible": [
          { "url": "https://g2.com/categories/geo", "title": "GEO tools on G2", "description": null, "anchorText": "G2", "position": 1 }
        ],
        "hidden": [
          { "url": "https://reddit.com/r/SEO/x", "title": "Reddit thread", "description": null, "anchorText": null, "position": 4 }
        ]
      },
      "fanOut": [
        { "queries": ["affordable ai visibility tracker"], "sources": [{ "url": "https://g2.com/categories/geo", "title": "GEO tools on G2" }], "at": "2026-06-08T06:01:00.000Z" }
      ],
      "searchResults": [
        { "url": "https://g2.com/categories/geo", "title": "GEO tools on G2", "rank": 1 }
      ],
      "localPlaces": [
        { "rank": 1, "name": "Rank Forever - Agence SEO Strasbourg", "url": "https://rankforever.fr/", "domain": "rankforever.fr", "rating": 5, "reviewCount": 22, "category": "Internet marketing service", "city": "Strasbourg", "isBrand": true }
      ],
      "competitors": [
        { "name": "Otterly", "rawName": "Otterly.ai", "position": 1, "context": "cité comme un tracker populaire", "sourceUrls": ["https://otterly.ai", "https://g2.com/otterly"] }
      ],
      "products": [
        { "productId": "clpr1...", "name": "Trio Compact", "brand": "Inava", "rawName": "Brossettes Interdentaires Trio Compact Inava", "position": 4, "fromCard": true, "price": "4,48 €", "merchant": "Pharmacie des Drakkars", "rating": null, "reviewCount": null, "sourceUrls": [] }
      ]
    }
  ],
  "errors": []
}

Tips et patterns

  • include.products liste chaque produit jugé une seule fois (brand: null = les vôtres). fromCard: true quand le moteur l'a affiché en carte produit ; price, merchant et rating viennent de cette carte. sourceUrls sont les sources qui appuient un passage nommant le produit, même règle que competitors.
  • Laissez include.response off tant que vous n'avez pas besoin du texte. Servez-vous de responseLength (renvoyé par list_prompt_results) pour décider, et de maxResponseChars pour ne tirer que le début.
  • Groupez les ids d'une même date de scan (un par LLM) dans un seul appel pour comparer comment chaque moteur a répondu sans N allers-retours.
  • Les sources visibles sont celles citées inline dans la réponse ; les sources cachées sont celles affichées sous "More" / panneau Sources. Le découpage vous dit ce que le lecteur voit vraiment versus ce que le LLM a consulté.
  • Le sourceUrls de chaque concurrent est la liste des pages qui l'ont nommé dans cette réponse, résolue à partir de la réponse elle-même : l'IA affiche la page à côté d'un passage qui nomme ce concurrent. C'est un tableau, qui peut être vide quand le concurrent est mentionné en prose sans source citée.
  • searchResults liste les résultats de la recherche web que le moteur a vus pour répondre, dans leur ordre (rank), qu'ils soient cités ou non. ChatGPT n'expose plus ses requêtes de recherche aux visiteurs non connectés : ses fanOut sont donc souvent vides, mais searchResults reste rempli.
  • Traitez errors comme attendu, pas fatal : un id peut manquer si le résultat a été purgé ou appartient à un autre projet.
  • include.localPlaces ne renvoie quelque chose que sur ChatGPT et Google AI Overview : les quatre autres moteurs n'affichent jamais de carte d'établissements. isBrand marque la fiche de la marque suivie, reconnue d'abord par le domaine du site, puis par le nom. reviewCount reprend l'arrondi de Google sur les gros volumes.

Tools liés

  • list_prompt_results : l'index qui vous donne les ids à récupérer ici.
  • list_scans : grouper les résultats par scan avant de tirer le détail.
  • list_competitors : les totaux concurrents au niveau projet, derrière les mentions par résultat.

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

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