add_geo_audit_content_idea

add_geo_audit_content_idea ajoute une idée de contenu custom à un rapport, exactement comme un owner peut le faire à la main dans l'UI. Un agent qui a repéré un trou dans les réponses des LLM peut le transformer en angle d'article porté par le rapport. Sur une campagne, l'idée se pose sur le template partagé : chaque rapport de cible la reçoit.

Quand l'utiliser

Après avoir lu les fan-outs, les sources et les idées existantes du rapport, ajoutez les angles produits par votre workflow. La nouvelle idée apparaît dans la section idées de contenu, à côté de celles générées par l'IA. Tenant-scoped (écriture) ; exige une clé API non read-only.

Input

Response

Succès

{
  "success": true,
  "auditId": null,
  "bulkAuditId": "clx_bulk_42",
  "idea": {
    "id": "idea_ab12cd34",
    "title": "Comment choisir un plombier à Lyon",
    "angle": "Guide d'achat qui répond aux prompts de comparaison posés aux LLM"
  }
}

L'idea.id renvoyé est la poignée pour la supprimer plus tard avec remove_geo_audit_content_idea.

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_content_ideas pour éviter deux idées qui sont le même article.
• Mettez le lecteur dans l'angle. Le titre est l'article ; l'angle dit ce qu'il défend et pour qui, c'est ce qui le rend actionnable.
• Il n'y a pas d'appel de mise à jour. Pour reformuler une idée custom, retirez-la puis ré-ajoutez-la.
• Sur une campagne, un ajout sert N rapports. Utilisez bulkAuditId (ou l'auditId d'une cible) quand l'angle vaut pour tout le segment.

Tools liés

• list_geo_audit_content_ideas : lire les idées actuelles d'abord.
• remove_geo_audit_content_idea : supprimer une idée custom.
• add_geo_audit_recommendation : la même chose pour les recommandations du rapport.