Mentionable
Mentionable

set_geo_audit_section_visibility

Tool MCP set_geo_audit_section_visibility : passer une section de GEO Audit en visible, teasé (derrière un CTA) ou masqué dans le rapport white-label.

Mis à jour le 2026-07-23

set_geo_audit_section_visibility définit l'affichage d'une section d'un rapport GEO Audit white-label : visible (affichée en entier), teased (floutée derrière un CTA), ou hidden (retirée). Reproduit la curation qu'un owner fait à la main avant de partager un audit avec un prospect.

Quand l'utiliser

Au moment de préparer un GEO Audit pour le partage : masquez les sections que vous ne voulez pas montrer, teasez celles à mettre derrière un call-to-action, et laissez le reste visible. Teaser une section pousse à la conversion tout en montrant qu'il y a plus derrière.

Input

Champ Type Description
auditId string (CUID) L'id du GEO Audit.
section enum Une parmi competitorRanking, personas, competitorMatrix, promptCoverage, recommendations, contentIdeas, topSources.
visibility enum visible, teased, ou hidden.
ctaId string (CUID), optionnel Le CTA affiché sur les sections teasées. Requis (ici ou déjà défini sur l'audit) quand visibility vaut teased. Passez null pour l'effacer ; omettez pour garder l'actuel.

Les GEO Audits sont liés au workspace, donc ce tool ne prend pas de projectId. Exige une clé API non read-only. Le CTA est au niveau de l'audit : un seul CTA s'applique à toutes les sections teasées.

Response

Succès

{
  "success": true,
  "auditId": "clx_audit_42",
  "section": "recommendations",
  "visibility": "teased",
  "teaserSections": ["recommendations"],
  "hiddenSections": ["topSources"],
  "ctaId": "clx_cta_1"
}

teaserSections et hiddenSections sont les ensembles complets après le changement.

Erreurs

{ "success": false, "error": "cta_required", "message": "Teasing a section requires a CTA. Pass ctaId (see list_audit_ctas) or set one first." }
{ "success": false, "error": "cta_not_found", "message": "No CTA with this id exists in your workspace. Use list_audit_ctas to get a valid id." }
{ "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 visibility is managed at the campaign level, not via this tool." }

Tips et patterns

  • Récupérez un id de CTA d'abord avec list_audit_ctas avant de teaser.
  • Un CTA par audit. Définir ctaId en teasant change le CTA pour toutes les sections teasées de cet audit.
  • Une section est dans un seul état. Passer en visible la retire des ensembles teasé et masqué.

Tools liés