Mentionable
Mentionable

add_geo_audit_recommendation

Tool MCP add_geo_audit_recommendation : ajouter une recommandation custom au rapport d'un GEO Audit, comme un owner peut le faire à la main.

Mis à jour le 2026-07-23

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 audit avec ses propres recommandations par programmation. Tenant-scoped (écriture), single audits uniquement.

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

Champ Type Description
auditId string (CUID) L'id du GEO Audit renvoyé par list_geo_audits.
category enum technical, content, ou distribution.
severity enum critical, important, ou nice-to-have.
title string 1 à 160 caractères.
description string 1 à 1200 caractères.

Les GEO Audits sont liés au workspace, donc ce tool ne prend pas de projectId. 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": "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 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. Les générées sont figées.

Tools liés