remove_geo_audit_content_idea

Tool MCP remove_geo_audit_content_idea : supprimer une idée de contenu custom ou retirer une idée générée du rapport d'un GEO Audit ou d'une campagne.

Mis à jour le 2026-09-21

remove_geo_audit_content_idea retire une idée de contenu d'un rapport. Une idée custom (ajoutée via add_geo_audit_content_idea ou à la main) est supprimée. Une idée générée est du JSON figé : elle est retirée du rapport en étant masquée, exactement ce que fait le toggle de l'app, et c'est réversible. Fonctionne sur un GEO Audit simple et sur une campagne en masse.

Quand l'utiliser

Pour écarter un angle d'article que vous ne voulez pas dans le rapport : une idée custom que vous avez ajoutée (passez son customIdeaId) ou une idée générée à côté de la plaque (passez son hash). Les deux viennent de list_geo_audit_content_ideas. Tenant-scoped (écriture) ; exige une clé API non read-only.

Input

Champ Type Description
auditId string (CUID) Un GEO Audit simple, ou une cible de campagne (qui résout vers sa campagne). Exactement un de auditId / bulkAuditId.
bulkAuditId string (CUID) Une campagne, renvoyée par list_bulk_audits. Exactement un de auditId / bulkAuditId.
customIdeaId string L'id d'une idée custom (depuis custom[].id). La supprime.
hash string Le hash d'une idée générée (depuis generated[].hash). La retire du rapport en la masquant.

Response

Succès

{ "success": true, "auditId": "clx_audit_42", "bulkAuditId": null, "removed": "generated_hidden" }

removed dit ce qui s'est réellement passé : custom_deleted (une idée custom supprimée) ou generated_hidden (une idée générée masquée).

Erreurs

{ "success": false, "error": "item_not_found", "message": "No item with this id or hash on this report. List the items first to get a valid one." }
{ "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. ..." }

Une référence qui ne correspond ni à un id custom ni à un hash généré renvoie item_not_found plutôt qu'un no-op silencieux.

Tips et patterns

  • Listez d'abord. list_geo_audit_content_ideas donne les deux poignées : custom[].id et generated[].hash.
  • Le masquage est réversible. set_geo_audit_content_idea_visibility avec hidden: false remet une idée générée. Une idée custom supprimée est perdue : il faut la ré-ajouter.
  • Lisez removed au lieu de supposer : il dit si vous avez supprimé une idée custom ou masqué une idée générée.

Tools liés

Vous pouvez voir où vous en êtes dès aujourd'hui.

Essai gratuit. Lancez le suivi de votre visibilité IA, sans carte.