Gestion du code personnalisé

Ajouter, examiner et gérer des scripts personnalisés en ligne sur un site Webflow — analytics, pixels de suivi, widgets de chat ou tout JavaScript personnalisé.

Note importante

TOUJOURS utiliser les outils Webflow MCP pour toutes les opérations :

Utiliser webflow_guide_tool de Webflow MCP pour obtenir les bonnes pratiques avant tout autre appel d'outil
Utiliser data_sites_tool de Webflow MCP avec l'action list_sites pour identifier les sites disponibles
Utiliser data_scripts_tool de Webflow MCP avec l'action list_registered_scripts pour lister tous les scripts enregistrés
Utiliser data_scripts_tool de Webflow MCP avec l'action list_applied_scripts pour lister les scripts appliqués aux pages
Utiliser data_scripts_tool de Webflow MCP avec l'action add_inline_site_script pour enregistrer un nouveau script en ligne
Utiliser data_scripts_tool de Webflow MCP avec l'action delete_all_site_scripts pour supprimer TOUS les scripts du site (pas de suppression sélective)
Utiliser data_scripts_tool de Webflow MCP avec l'action get_page_script pour obtenir le code personnalisé d'une page spécifique
Utiliser data_scripts_tool de Webflow MCP avec l'action upsert_page_script pour ajouter ou mettre à jour le code personnalisé au niveau de la page
Utiliser data_scripts_tool de Webflow MCP avec l'action delete_all_page_scripts pour supprimer tout le code personnalisé d'une page
Tous les appels d'outil doivent inclure le paramètre context requis (15-25 mots, perspective à la troisième personne)

Instructions

Phase 1 : Découverte

Appeler webflow_guide_tool en premier — toujours le premier appel d'outil MCP
Obtenir le site : Utiliser data_sites_tool avec l'action list_sites. S'il n'y a qu'un site, l'utiliser automatiquement.

Phase 2 : Analyse

Lister les scripts : Appeler list_registered_scripts et list_applied_scripts en parallèle
Vérifier les scripts au niveau de la page (si pertinent) : Utiliser get_page_script pour des pages spécifiques
Présenter les résultats : Nom, version, localisation (en-tête/pied de page), statut d'enregistrement vs application

Phase 3 : Planification et confirmation

Avant toute mutation, présenter le plan et exiger une confirmation explicite :

Ajout de scripts : l'utilisateur doit taper « add »
Suppression de TOUS les scripts du site : l'utilisateur doit taper « delete all » (avertissement : pas de suppression sélective)
Modifications au niveau de la page : l'utilisateur doit taper « update »

Phase 4 : Exécution

Ajouter un script du site : add_inline_site_script avec displayName, sourceCode, version, location, canCopy
Supprimer tous les scripts du site : delete_all_site_scripts
Ajouter/mettre à jour un script de page : upsert_page_script
Supprimer les scripts de page : delete_all_page_scripts

Phase 5 : Vérification

Re-lister les scripts pour confirmer le succès
Signaler ce qui a changé (nom, localisation, version, nombre de caractères)
Rappeler à l'utilisateur de publier — suggérer d'utiliser la skill safe-publish

Exemples

Exemple 1 : Afficher les scripts

Utilisateur : « Quels scripts sont sur mon site ? »

webflow_guide_tool → data_sites_tool → list_registered_scripts + list_applied_scripts en parallèle
Présenter un résumé de tous les scripts

Exemple 2 : Ajouter Google Tag Manager

Utilisateur : « Ajouter GTM à mon site »

webflow_guide_tool → data_sites_tool → demander l'ID du conteneur GTM
Aperçu du script, exiger « add » → add_inline_site_script (en-tête, version « 1.0.0 »)
Vérifier et rappeler de publier

Exemple 3 : Supprimer tous les scripts

Utilisateur : « Supprimer tous les scripts »

webflow_guide_tool → data_sites_tool → lister les scripts actuels
Avertir : supprime TOUS les scripts. Exiger « delete all » → delete_all_site_scripts
Vérifier et rappeler de publier

Exemple 4 : Suivi spécifique à une page

Utilisateur : « Ajouter le suivi des conversions à ma page de remerciement »

webflow_guide_tool → data_sites_tool → get_page_script pour vérifier le contenu existant
Aperçu, exiger « update » → upsert_page_script
Vérifier et rappeler de publier

Lignes directrices

webflow_guide_tool toujours en premier — avant tout autre outil MCP
Pas de balises <script> — Webflow les ajoute automatiquement
Maximum 10 000 caractères par script ; displayName + version doit être unique
Scripts au niveau du site (add_inline_site_script) s'appliquent à toutes les pages ; scripts au niveau de la page (upsert_page_script) s'appliquent à une seule page
Pas de suppression sélective — delete_all_site_scripts supprime tout ; toujours lister les scripts en premier pour que l'utilisateur sache ce qui sera perdu
Scripts hébergés/externes non disponibles via MCP — en ligne uniquement
Recommander l'en-tête pour les analytics (GA, GTM) ; le pied de page pour les widgets de chat et les scripts non critiques
Si displayName + version existe, suggérer d'incrémenter la version
Toujours rappeler aux utilisateurs de publier après les modifications

webflow-mcp:custom-code-management