add_geo_audit_recommendation

add_geo_audit_recommendation ajoute une recommandation custom au rapport d'un GEO Audit, exactement comme un owner peut le faire à la main dans l'UI. Ça permet à un agent d'enrichir un rapport avec ses propres recommandations par programmation. Sur une campagne, la recommandation se pose sur le template partagé : chaque rapport de cible la reçoit. Tenant-scoped (écriture).

Quand l'utiliser

Après avoir lu l'audit et ses recommandations existantes (get_geo_audit, list_geo_audit_recommendations), ajoutez les recommandations produites par votre workflow. La nouvelle recommandation apparaît dans le rapport, à côté de celles générées par l'IA.

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). Exige une clé API non read-only.

Response

Succès

{
  "success": true,
  "auditId": "clx_audit_42",
  "reco": {
    "id": "cus_ab12cd34",
    "category": "content",
    "severity": "important",
    "title": "Publish a head-to-head comparison page",
    "description": "Cover the three competitors named most often by the LLMs."
  }
}

Le reco.id retourné est la poignée pour la retirer ensuite avec remove_geo_audit_recommendation.

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 d'abord avec list_geo_audit_recommendations pour éviter de dupliquer une recommandation existante.
• Titres spécifiques. Le titre est ce que le lecteur scanne ; mettez l'action dedans (par ex. "Add FAQ schema to the pricing page").
• Les recos custom sont modifiables : retirez-les avec remove_geo_audit_recommendation. Il n'y a pas d'appel de mise à jour : retirez, puis ajoutez.
• Sur une campagne, un ajout sert N rapports. Utilisez bulkAuditId (ou l'auditId d'une cible) quand le point vaut pour tout le segment.

Tools liés

• list_geo_audit_recommendations : lire les recommandations actuelles d'abord.
• remove_geo_audit_recommendation : retirer une reco custom par id.