list_geo_audit_content_ideas

list_geo_audit_content_ideas retourne les idées de contenu d'un rapport : les angles d'article générés par l'IA à la fin de l'audit, et les idées 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 idées sont celles de segment que rend chaque rapport de cible.

Quand l'utiliser

Avant de modifier les idées de contenu d'un rapport via le MCP, listez-les pour ne pas dupliquer un angle existant et pour récupérer la bonne poignée : l'id d'une idée custom, ou le hash d'une idée générée. 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. Passer l'auditId d'une cible de campagne résout vers sa campagne : une cible n'a pas d'idées propres, elle rend celles du segment. La réponse renvoie la cible résolue en auditId / bulkAuditId (l'un des deux à null).

Response

{
  "success": true,
  "auditId": "clx_audit_42",
  "bulkAuditId": null,
  "generated": [
    {
      "title": "Comment choisir un plombier à Lyon",
      "angle": "Guide d'achat qui répond aux prompts de comparaison posés aux LLM",
      "hash": "9f8e7d6c",
      "hidden": false
    }
  ],
  "custom": [
    { "id": "idea_ab12cd34", "title": "Nos tarifs, expliqués", "angle": "Page de transparence que les modèles peuvent citer" }
  ]
}

Notes sur les champs :

• Les idées generated sont figées à la fin de l'audit et n'ont pas d'id stocké. Chacune porte un hash déterministe (dérivé du titre) et un flag hidden qui reflète les réglages de visibilité du rapport.
• Les idées custom ont chacune un id stable (la poignée pour les supprimer).
• Une idée, c'est {title, angle} : l'article et ce qu'il défend.

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 deux idées qui sont le même article.
• Les items custom portent un id, les générés un hash. remove_geo_audit_content_idea accepte les deux : l'id supprime une idée custom, le hash retire une idée générée du rapport en la masquant.
• À utiliser avec list_geo_audit_recommendations, qui fonctionne exactement pareil sur l'autre liste éditable du rapport.

Tools liés

• add_geo_audit_content_idea : ajouter une idée custom.
• remove_geo_audit_content_idea : supprimer une idée custom ou masquer une générée.
• set_geo_audit_content_idea_visibility : afficher ou masquer une idée générée.
• list_geo_audit_recommendations : la même chose pour les recommandations du rapport.