get_recommendation

get_recommendation renvoie le plan d'un prompt ou d'une zone locale, étape par étape. C'est la page plan du Plan d'action du dashboard, en JSON.

Le plan d'un prompt commence par le site de la marque, puis liste les sources à obtenir. Le plan d'une zone liste les annuaires et classements cités pour cette zone. La fiche sur la carte et la page ville sont des missions du plan de contenu (list_content_plan). Chaque étape porte son statut et, une fois faite, son effet.

Quand l'utiliser

Appelez-le après list_recommendations, avec un promptId de summary.promptsToConquer ou un zoneKey de summary.zones. Il répond à « comment être cité sur cette question ? » par une liste ordonnée qu'un agent peut dérouler : ouvrir la page, faire l'action, puis appeler set_recommendation_status.

Input

Réponse

{
  "success": true,
  "type": "prompt",
  "prompt": { "id": "clp1...", "text": "meilleur outil de visibilité IA pour freelance" },
  "visibility": 0,
  "absentLlms": ["CHATGPT", "GEMINI"],
  "steps": [
    {
      "id": "prompt:clp1...:fix",
      "kind": "fix",
      "url": "https://example.com/tarifs",
      "llms": ["CHATGPT"],
      "answers": 4,
      "status": "todo",
      "doneAt": null,
      "hasDraft": false,
      "impact": null,
      "tool": "run_page_fix"
    },
    {
      "id": "source:https://flint.com/articles/best-ai-visibility-tracking-tools",
      "kind": "source",
      "action": "ranking",
      "domain": "flint.com",
      "url": "https://flint.com/articles/best-ai-visibility-tracking-tools",
      "pageTitle": "Best AI visibility tracking tools",
      "passage": "Mentionova: SaaS & fintech firms, 6 engines, alerts and citation gap analysis",
      "competitors": ["Mentionova", "Peec AI", "Semrush"],
      "publisher": null,
      "backlinkPrice": 280,
      "redditAngle": null,
      "llms": ["CHATGPT", "GEMINI"],
      "otherPromptIds": ["clp2..."],
      "status": "done",
      "doneAt": "2026-10-01T00:00:00.000Z",
      "impact": { "before": 0, "after": 20 },
      "tool": null
    }
  ]
}

Étapes sur le site (kind) :

• create : aucune page du site n'est citée, ni même ouverte, sur le prompt. Publiez-en une qui y répond. Faite automatiquement quand une page générée est publiée.
• fix : les IA ouvrent cette page sur le prompt sans la citer, la citation la moins chère à gagner. tool renvoie vers run_page_fix avec cette url en pageUrl : il liste ce qui empêche Google et les IA de lire la page. Il est sans crédit sur toute page crawlée, dans toutes les formules.
• silent : la page est citée mais la réponse ne nomme pas la marque dans au moins la moitié des cas. Nommez la marque dans les passages que les IA reprennent, puis marquez l'étape faite.

impact est la part des réponses du prompt qui citent la marque avant et depuis l'étape, en pourcentage. Il reste null tant qu'un des deux côtés n'a pas de réponse. Pour le plan d'une zone, c'est la part des cartes de la zone qui montrent la marque.

Erreurs : invalid_target (ni ou les deux de promptId / zoneKey), prompt_not_found, zone_not_found, local_disabled.

Conseils et patterns

• passage est ce que l'IA a lu sur la page source, coupé à 300 caractères : citez-le quand vous demandez au site de vous ajouter.
• otherPromptIds indique quels autres prompts la même source débloque. La faire une fois la coche dans tous les plans.
• hasDraft: true signifie qu'une page a déjà été générée pour ce prompt : publiez-la depuis le dashboard au lieu d'en écrire une autre.
• Relisez le plan une semaine après une étape pour voir son impact.

Tools liés

• list_recommendations : toutes les actions du projet, et les prompts et zones à ouvrir ici
• set_recommendation_status : marquer une étape faite, exclue, ou à refaire
• run_page_fix : lister ce qu'il faut corriger sur la page d'une étape fix