list_recommendations

list_recommendations renvoie les actions qui feraient citer un projet par les IA, classées par impact. C'est la vue MCP du Plan d'action du dashboard : la même liste, le même ordre, les mêmes décisions.

Deux types de lignes reviennent. Une ligne source est une page sur laquelle les IA s'appuient pour recommander vos concurrents, et jamais vous : un annuaire où vous inscrire, un classement où demander à figurer, ou une discussion Reddit où répondre. Une ligne local, pour un établissement qui reçoit des clients, concerne la carte : avis, catégorie de la fiche, site, ou zone à conquérir.

Une ligne par action, même quand plusieurs prompts la partagent. Un classement qui soutient vos concurrents sur douze prompts est une seule ligne avec douze promptIds, pas douze lignes.

Quand l'utiliser

Commencez ici quand un agent doit répondre à « que faire pour être cité ? ». La réponse par défaut est la liste des actions encore à faire, les meilleures d'abord. Ouvrez ensuite le plan d'un prompt ou d'une zone avec get_recommendation pour voir chaque étape et sa preuve, puis bouclez avec set_recommendation_status une fois l'action faite.

Le summary répond déjà à la question suivante, « sur quels prompts travailler ? », sans second appel : les prompts où au moins un moteur ne cite jamais la marque, les moins visibles d'abord.

Input

Réponse

{
  "data": [
    {
      "id": "source:https://www.semrush.com/blog/best-ai-visibility-tools",
      "type": "source",
      "action": "ranking",
      "domain": "semrush.com",
      "url": "https://www.semrush.com/blog/best-ai-visibility-tools",
      "pageTitle": "The 9 Best AI Visibility Tools in 2026",
      "competitors": ["Otterly AI", "Profound", "Peec AI"],
      "publisher": "Semrush",
      "backlinkPrice": null,
      "promptIds": ["clp1...", "clp2..."],
      "llms": ["CHATGPT", "GEMINI"],
      "score": 41,
      "confirmed": true,
      "status": "todo",
      "doneAt": null
    }
  ],
  "pageInfo": { "hasMore": true, "nextCursor": "20", "totalCount": 31 },
  "summary": {
    "localEnabled": false,
    "promptsToConquer": [
      { "promptId": "clp1...", "text": "meilleur outil de visibilité IA pour freelance", "visibility": 0, "absentLlms": ["CHATGPT", "GEMINI"], "steps": 7, "done": 2 }
    ],
    "promptsToConquerCount": 17,
    "zones": []
  }
}

action vaut directory (s'inscrire, fait une fois pour tout le domaine), ranking (demander à figurer sur cette page précise) ou reddit (répondre dans la discussion). publisher nomme le concurrent qui publie son propre comparatif : la demande vaut toujours le coup, mais attendez-vous à moins de réponses. backlinkPrice est renseigné quand le site vend des liens dans le catalogue de backlinks du projet, l'alternative payante à la demande.

Pour une ligne local, action est le type de recommandation (reviews_count, rating, category, website, not_in_map, never_in_map, zone, page) et params porte ses chiffres (écart d'avis, nom de la zone, présence).

Conseils et patterns

• Les sites d'entreprise et les articles d'information n'apparaissent jamais : il n'y a rien à y faire. Une page pas encore classée apparaît une fois jugée, en général après le scan suivant.
• id est stable d'un scan à l'autre, et c'est lui qu'attend set_recommendation_status.
• Une source faite ou exclue une fois l'est dans tous les plans qui la partagent, zones locales comprises.
• Passez filters.status: ["done"] pour faire le point sur ce qui a été fait et quand (doneAt).
• Croisez backlinkPrice avec list_backlink_opportunities pour comparer les offres avant d'acheter.

Tools liés

• get_recommendation : le plan pas à pas d'un prompt ou d'une zone
• set_recommendation_status : marquer une action faite, exclue, ou à refaire
• list_competitor_sources : tous les domaines qui citent un concurrent donné