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_ideasdonne les deux poignées :custom[].idetgenerated[].hash. - Le masquage est réversible.
set_geo_audit_content_idea_visibilityavechidden: falseremet une idée générée. Une idée custom supprimée est perdue : il faut la ré-ajouter. - Lisez
removedau 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
- list_geo_audit_content_ideas : trouver l'id ou le hash.
- set_geo_audit_content_idea_visibility : annuler un retrait
generated_hidden. - remove_geo_audit_recommendation : la même chose pour les recommandations du rapport.