list_geo_audit_recommendations

list_geo_audit_recommendations retourne les recommandations d'un rapport : 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). Fonctionne sur un GEO Audit simple et sur une campagne en masse, dont les recommandations sont celles de segment que rend chaque rapport de cible. 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.

Input

Les GEO Audits sont liés au workspace, donc ce tool ne prend pas de projectId. Ciblez un rapport avec auditId ou bulkAuditId, jamais les deux. Sur une campagne, la modification s'applique au template de réglages partagé que rend chaque rapport de cible : un seul appel couvre tout le lot. Passer l'auditId d'une cible résout vers sa campagne pour la même raison : une cible n'a pas de réglages propres. La réponse renvoie toujours la cible résolue en auditId / bulkAuditId (l'un des deux à null).

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": "target_required", "message": "Pass exactly one of auditId (a GEO audit) or bulkAuditId (a bulk campaign)." }
{ "success": false, "error": "audit_not_found", "message": "No GEO audit with this id exists in your workspace. ..." }
{ "success": false, "error": "bulk_audit_not_found", "message": "No bulk campaign with this id exists in your workspace. ..." }

Tips et patterns

• Listez avant d'ajouter pour éviter les quasi-doublons.
• Les items custom portent un id, les générés un hash. remove_geo_audit_recommendation accepte les deux : l'id supprime un item custom, le hash retire un item généré du rapport en le masquant (réversible avec set_geo_audit_recommendation_visibility).

Tools liés

• add_geo_audit_recommendation : ajouter une reco custom.
• remove_geo_audit_recommendation : retirer une reco custom ou générée.
• list_geo_audit_content_ideas : la même chose pour les idées de contenu du rapport.
• get_geo_audit : l'audit complet, y compris ses recos figées.