Mentionable
Mentionable

list_geo_audit_recommendations

Tool MCP list_geo_audit_recommendations : les recommandations générées d'un GEO Audit (avec hash et flag masqué) et les recommandations custom ajoutées.

Mis à jour le 2026-07-23

list_geo_audit_recommendations retourne les recommandations d'un GEO Audit : celles générées par l'IA à la fin de l'audit, et les recommandations custom ajoutées par-dessus par un owner (ou un agent). Utilisez-le pour lire l'état actuel avant d'ajouter ou retirer des recommandations custom avec add_geo_audit_recommendation / remove_geo_audit_recommendation.

Quand l'utiliser

Avant de modifier les recommandations d'un GEO Audit via le MCP, listez-les pour ne pas en dupliquer une existante et pour récupérer l'id d'une reco custom à retirer. Lecture seule, tenant-scoped, single audits uniquement.

Input

Champ Type Description
auditId string (CUID) L'id du GEO Audit renvoyé par list_geo_audits.

Les GEO Audits sont liés au workspace, donc ce tool ne prend pas de projectId.

Response

{
  "success": true,
  "auditId": "clx_audit_42",
  "generated": [
    {
      "category": "technical",
      "severity": "critical",
      "title": "Add FAQ schema to the pricing page",
      "description": "...",
      "metric": { "value": 0.42, "label": "of pages missing schema" },
      "hash": "1a2b3c4d",
      "hidden": false
    }
  ],
  "custom": [
    { "id": "cus_ab12cd34", "category": "content", "severity": "important", "title": "Publish a comparison page", "description": "..." }
  ]
}

Notes :

  • Les recommandations generated sont figées à la fin de l'audit et n'ont pas d'id stocké. Chacune porte un hash déterministe (dérivé de catégorie + titre) et un flag hidden reflétant la visibilité dans le rapport.
  • Les recommandations custom ont chacune un id stable (la poignée pour les retirer).
  • category vaut technical | content | distribution ; severity vaut critical | important | nice-to-have.

Erreurs

{ "success": false, "error": "audit_not_found", "message": "No GEO audit with this id exists in your workspace. ..." }
{ "success": false, "error": "bulk_unsupported", "message": "This audit is part of a bulk campaign; its recommendations are managed at the campaign level, not via this tool." }

Tips et patterns

  • Listez avant d'ajouter pour éviter les quasi-doublons.
  • L'id des items custom est ce que remove_geo_audit_recommendation consomme ; les items générés ont un hash, pas un id, et ne peuvent pas être retirés (seulement masqués).

Tools liés