Le plugin Wix

Le plugin est deux choses : des skills, des dossiers d'instructions et du code fourni pour construire sur Wix, chacun avec un SKILL.md à sa racine ; et le serveur Wix MCP à https://mcp.wix.com/mcp, dont les outils lisent et modifient les sites et le compte Wix de l'utilisateur. Les skills expliquent comment ; les outils font.

Comment travailler avec Wix via le plugin

Chaque tâche Wix se termine de deux façons : un appel fait maintenant avec le compte de l'utilisateur, ou du code que l'utilisateur garde et qui fait les mêmes appels (une app, un site headless, un script). Le chemin est le même.

Commencez par WixREADME, une fois par conversation. Elle retourne ce flux complet et les sites du compte avec leurs apps installées.
Choisissez le site. Le siteId vient du contexte du site ; quand plusieurs conviennent, demandez. L'API d'une solution métier fonctionne uniquement sur un site avec cette app installée, et la version d'une app change ses endpoints, donc vérifiez d'abord les apps du site.
Trouvez la méthode. La première source qui la donne : un résultat d'outil antérieur dans la conversation ; sinon la skill qui couvre la tâche (l'index ci-dessous dit à quoi chacune sert), dont l'exemple est le modèle quand il correspond au cas ; sinon la doc, SearchWixRESTDocumentation ou BrowseWixRESTDocsMenu pour REST, le SDK, CLI, headless et app searches pour du code, puis ReadFullDocsArticle sur la page de la méthode.
Obtenez la forme exacte. Une demande est modelée sur un exemple qui correspond au cas : une recette ou un modèle de skill, ou la page de docs de la méthode, quand elle montre les champs dont le cas a besoin. C'est suffisant. Le schéma sert pour ce qu'aucun exemple ne montre : un champ, une énumération, une clé de filtre ou de tri (une liste fermée par méthode). SearchWixAPISpec sur l'URL de docs de la méthode retourne les schémas de demande et de réponse, l'URL REST et l'appel SDK JavaScript ; ReadFullDocsMethodSchema quand il n'est pas disponible.
Faites l'appel, ou écrivez le code. Pour le faire maintenant : ExecuteWixAPI, une fonction tenant chaque étape de la tâche, les lectures et les écritures qu'elles alimentent. Pour du code que l'utilisateur garde : écrivez l'appel à partir de la forme trouvée à l'étape 4, REST ou SDK. wix-headless-templates est ce code déjà écrit et vérifié, un dossier par solution métier, et wix-headless-kit construit un site dessus.

Partout : rien de spécifique à Wix de mémoire. Chaque URL, id, emplacement de paramètre, fait produit, forme de demande et nom de champ vient d'une skill, des outils de docs, d'un résultat d'outil antérieur ou de l'utilisateur.

Créer un site

Un nouveau site Wix est écrit en code et uploadé. StartDeployWebsite retourne le guide pour un site que l'agent écrit ou que l'utilisateur a apporté ; StartHeadlessBuild retourne le guide pour un site qui a besoin de fonctionnalités métier Wix (une boutique, des réservations, un CMS, des membres, les paiements et le reste). Chaque guide crée le site, l'upload et dit ce qui vient ensuite ; appelez l'un et suivez-le.

Ce sur quoi les guides reposent :

Un site, créé une fois, par l'appel de provision (POST .../headless-business-setup/v1/headless-business/provision, origin: 'agent'), qui retourne metaSiteId, l'id que chaque appel ultérieur prend. Un site créé antérieurement est trouvé avec ListWixSites et uploadé à nouveau ; l'URL ne change jamais.
Les pages statiques sont supprimées, une construction Wix Astro est publiée. Un drop envoie l'ensemble complet des fichiers à chaque fois. Une build (.wix/build-metadata.json à côté de dist/) est publiée sur l'hébergement Wix, rendue côté serveur, via UploadHeadlessWebsiteFiles uniquement : en tant que pièce jointe, ou en deux appels (prepare: true avec la size du zip, puis uploadKey) depuis un shell qui atteint internet. La source du projet est stockée avec la publication, et une session ultérieure continue le site à partir de là.
UploadHeadlessWebsiteFiles prend siteId et les fichiers, en tant que attachments ou le bundle texte files, et retourne l'URL live et le tableau de bord. Sans le MCP, le même drop est un appel multipart curl, avec ou sans connexion.
Les fonctionnalités métier viennent de l'exécution de wix-headless-kit sur le même site et appId : apps installées et contenu ensemencé, le projet Astro construit à partir de wix-headless-templates, la build publiée.

Pour en lire plus : la recette, wix-manage/references/sites/upload-static-site.md (https://www.wix.com/skills/wix-manage/references/sites/upload-static-site.md) : les appels pour chaque route, drop et publication, trouver et modifier un site, la route anonyme, les limites et défaillances. Le démarrage à froid (https://www.wix.com/skills/headless-cold-start/headless-kit.md) : la construction headless depuis un environnement à froid jusqu'au site publié.

Deux façons d'utiliser Wix

Le plugin avec le MCP Wix

La façon préférée. La configuration MCP du plugin connecte le serveur Wix MCP à https://mcp.wix.com/mcp ; le client signe l'utilisateur au premier appel et les outils ci-dessous sont dans la liste des outils, sans rien à installer. Le flux ci-dessus s'exécute sur eux : WixREADME pour le contexte, les outils de documentation pour trouver une méthode et sa forme, ExecuteWixAPI pour l'appeler, StartDeployWebsite et StartHeadlessBuild avec UploadHeadlessWebsiteFiles pour créer un site et le mettre en ligne. Les skills sont lues dans le dossier du plugin, et ReadFullDocsArticle les lit en ligne quand elles n'y sont pas.

D'abord le contexte :

Outil	Ce qu'il fait
`WixREADME`	Le contexte que chaque autre outil suppose. Appelez-le une fois par conversation avant une tâche Wix ; pour un autre site plus tard, appelez `GetSiteContext` à la place.
`ListWixSites`	Liste les sites de l'utilisateur, avec un filtre de nom optionnel. N'a pas besoin de `WixREADME` d'abord.
`GetSiteContext`	Contexte profond pour un site, par nom ou id : ses apps, paramètres et données, en markdown.

Construire et déployer un site :

Outil	Ce qu'il fait
`StartDeployWebsite`	Retourne le guide pour créer un site sur Wix et y mettre des fichiers : HTML, CSS et JS, une build statique, un zip, une export d'un autre builder. Les mises à jour gardent le site et l'URL. Fonctionne avec ou sans connexion Wix.
`StartHeadlessBuild`	Retourne le guide headless, pour un site qui a besoin de fonctionnalités métier Wix : une boutique, des réservations, des événements, un menu de restaurant, un blog, des plans tarifaires, des donations, des formulaires, des membres, un CMS, des paiements.
`UploadHeadlessWebsiteFiles`	L'étape d'upload de ces deux guides : met un site statique ou une build Wix Astro sur un site Wix Headless existant par son metaSiteId, en tant que fichiers, en tant que pièces jointes, ou en deux appels avec des URLs présignées.
`GetSuggestedDomains`	Suggestions de noms de domaine pour un site.

Appeler les APIs Wix :

Outil	Ce qu'il fait
`ExecuteWixAPI`	Lit et change les données d'un site ou d'un compte avec une fonction JavaScript sur l'API REST Wix : appels chaînés, pagination, boucles, les lectures qui alimentent les écritures. Le moyen préféré d'appeler les APIs Wix.
`SearchWixAPISpec`	Inspecte la spec API REST Wix et l'appel SDK JavaScript de chaque méthode en exécutant du JavaScript contre l'index : la forme exacte de demande et de réponse, énumérations, l'import et la signature SDK.

Documentation :

Outil	Ce qu'il fait
`SearchWixRESTDocumentation`	Recherche dans la docs API REST Wix. Le point de départ pour trouver un endpoint.
`BrowseWixRESTDocsMenu`	Parcourt la docs REST en tant que menu, catégorie par catégorie.
`SearchWixSDKDocumentation`	Recherche dans la docs SDK JavaScript Wix.
`SearchWixHeadlessDocumentation`	Recherche dans la docs Wix Headless.
`SearchWixCLIDocumentation`	Recherche dans la docs Wix CLI : commandes, développement local, authentification.
`SearchWixWDSDocumentation`	Recherche dans la docs Wix Design System.
`SearchBuildAppsDocumentation`	Recherche dans la docs Wix Build Apps.
`SearchDevelopmentDocumentation`	Docs développeur Wix larges : concepts de plateforme et guides, après que les recherches spécifiques retournent rien.
`SearchWixHelpCenter`	Recherche dans le Centre d'Aide Wix : comment les propriétaires de site font les choses à la main dans le tableau de bord et les éditeurs.
`ReadFullDocsArticle`	Lit une page en intégralité par URL : un article de docs ou une page de méthode, un `SKILL.md` de skill ou un de ses fichiers, un article du Centre d'Aide.
`ReadFullDocsMethodSchema`	Le schéma complet de demande et de réponse d'une méthode, par l'URL de sa docs.

Média et feedback :

Outil	Ce qu'il fait
`UploadImageToWixSite`	Upload des images au Media Manager d'un site et retourne leurs URLs et ids de média.
`PickImagesForWixMedia`	Affiche un sélecteur de fichiers à l'utilisateur pour uploaden des images depuis son appareil au Media Manager.
`ReportIssueToWix`	Rapporte un problème avec les outils, APIs ou docs Wix à l'équipe Wix, quand l'utilisateur le demande.

La Wix CLI

L'autre façon, depuis un shell. @wix/cli est l'outil de ligne de commande de Wix : il signe dans un compte Wix, crée et gère les projets Wix sur disque, une app Wix ou un site Wix Headless, les construit et les publie sur Wix, et forge des tokens pour les appels REST. Sa session vit sur la machine. Tout comme npx @wix/cli@latest <command> :

Commande	Ce qu'elle fait
`login`	Signe avec un code d'appareil et écrit la session dans `~/.wix/auth/account.json`.
`whoami`	Affiche le compte connecté.
`create`	Crée un projet Wix avec son site : pour un site headless, le site, son app OAuth et l'hébergement, et le `wix.config.json` du projet (`siteId`, `appId`).
`env pull`	Écrit l'environnement du projet dans `.env.local` : le client id du site et les valeurs que la build lit.
`build`	Construit le projet pour Wix : pour un site Astro, `dist/` et `.wix/build-metadata.json`.
`release`	Publie la build sur Wix ; le site garde son URL.
`token`, `token --site <siteId>`	Forge un token admin, scoped au compte ou au site, pour des appels REST depuis un shell : `Authorization: Bearer <token>` (`wix-docs/references/CALLING.md`).

wix-headless-kit construit un site Wix Headless via les outils du MCP ou via la CLI ; une session CLI déjà sur la machine rend sa course la route CLI, où install/setup.mjs exécute create, et build puis release mettent le site en ligne.

Sans le MCP, chaque outil est un appel HTTP simple au même backend. wix-docs le couvre, avec les corps de demande, dans sa lane curl :

Outil	Sans le MCP
`SearchWixRESTDocumentation`, `SearchWixSDKDocumentation`, `SearchWixHeadlessDocumentation`, `SearchWixCLIDocumentation`, `SearchWixWDSDocumentation`, `SearchBuildAppsDocumentation`, `SearchDevelopmentDocumentation`	`POST https://www.wixapis.com/mcp-docs-search/v1/docs/search` (ou `/search/markdown`) avec `search_term` et le `document_type` de ce corpus.
`BrowseWixRESTDocsMenu`	`POST https://www.wixapis.com/mcp-docs-search/v1/docs/menu/browse`.
`ReadFullDocsArticle`	Ajoutez `.md` à toute URL `https://dev.wix.com/docs/...` ; le fichier d'une skill est `https://www.wix.com/skills/<skill>/<path>`.
`SearchWixAPISpec`, `ReadFullDocsMethodSchema`	`POST https://mcp.wix.com/api/code-mode/search` avec le même JavaScript.
`ExecuteWixAPI`	L'appel REST lui-même, à `https://www.wixapis.com`, avec un token : quelle identité une méthode prend et comment forger le token sont dans `wix-docs/references/CALLING.md`.
`StartDeployWebsite`, `StartHeadlessBuild`, `UploadHeadlessWebsiteFiles`	`create`, `build` et `release` depuis un shell ; la recette `wix-manage` `references/sites/upload-static-site.md` crée un site et drop les fichiers sur REST.

Skills

Chaque skill est un dossier avec un SKILL.md à sa racine qui dit ce qu'elle fait et lequel de ses fichiers lire quand. Une skill peut déjà être sur disque, dans le dossier du plugin ou sous .agents/skills/<skill>/ après npx skills add wix/skills, ou servie par l'outil skill du client ; la lire de là. Sinon chaque fichier est en ligne à https://www.wix.com/skills/<skill>/<path>, lu avec ReadFullDocsArticle ou curl ; https://www.wix.com/skills/<skill>/ avec le slash de fin liste les fichiers de la skill. Les chemins ci-dessous sont à l'intérieur du dossier de la skill.

wix-headless-kit

En ligne : https://www.wix.com/skills/wix-headless-kit/SKILL.md. Sur disque : le skills/wix-headless-kit/ du plugin, ou .agents/skills/wix-headless-kit/.

Construit un site Wix Headless sur le code @wix/sdk fourni et vérifié : une couche de données typée, des hooks, des composants, des pages Astro et un script seed par solution métier Wix, depuis wix-headless-templates. L'agent conçoit la présentation sur ces hooks et publie sur l'hébergement Wix. S'exécute comme un flux CLI depuis un shell, ou en tant qu'appels API Wix via le MCP.

Le démarrage à froid, wix-headless-cold-start/headless-kit.md (https://www.wix.com/skills/headless-cold-start/headless-kit.md, ce que StartHeadlessBuild retourne), prend un environnement à froid où wix-headless-kit s'exécute, puis passe le relais à son SKILL.md. Il mesure trois faits : les outils du MCP Wix dans la liste des outils ; Node 24.18 ou ultérieur avec npm atteignant le registre ; un moyen d'obtenir une build vers UploadHeadlessWebsiteFiles, en tant que pièce jointe ou par curl vers ses URLs d'upload. Les faits choisissent la route : les trois, la route plugin (site via ExecuteWixAPI, construction Astro ici, publication via l'outil d'upload) ; MCP mais pas de moyen de publier une build, le guide d'appel API (guides/api-run.md, pages statiques dans le files de l'outil d'upload) ; une session Wix CLI sur la machine, la route CLI. Le dossier projet vient d'abord, avec tous les fichiers remis extraits dedans. Les skills sur disque sont utilisées où elles sont ; sinon CI=1 npx skills@latest add wix/skills --skill wix-headless-kit --skill wix-docs --skill wix-manage --yes, puis node .agents/skills/wix-headless-kit/install/templates.mjs pour les modèles, et install/bootstrap.mjs sur la route CLI.

SKILL.md : les étapes d'une construction et le tableau des solutions métier.
guides/api-run.md : toute la course en tant qu'appels API Wix via le MCP, pour un agent sans shell ou un shell qui ne peut pas atteindre Wix.
guides/capabilities.md : quel produit Wix possède quelle fonctionnalité, et ce qui est fourni pour elle.
guides/existing-site.md : un nouveau frontend pour un site Wix qui a déjà son contenu, et continuer un site construit dans une session antérieure.
guides/migration.md : un site se déplaçant au code après « Go Headless » dans son tableau de bord.
guides/reference-mode.md : une pile qui ne peut pas exécuter le code React fourni.
guides/feedback.md : envoyer le feedback de l'utilisateur sur la construction avec Wix.
install/ : les scripts d'une course (setup.mjs, attach.mjs, deploy.mjs, install.mjs, templates.mjs, context.mjs, bootstrap.mjs, check.mjs) et pins.json, les versions CLI et templates épinglées.

wix-headless-templates

En ligne : https://www.wix.com/skills/wix-headless-templates/SKILL.md. Sur disque : le skills/wix-headless-templates/ du plugin, ou .agents/skills/wix-headless-templates/.

Le code depuis lequel wix-headless-kit construit, un dossier par solution métier : storefront, bookings, rentals, blog, cms, forms, members, events, restaurants, donations, pricing-plans, portfolio, faq, plus blank et shared. Chaque dossier contient :

INSTRUCTIONS.md : le playbook, avec les contrats.
app/ : la couche de données typée, agnostique du framework, sur @wix/sdk, les hooks React et composants de référence.
app-astro/ : les pages Astro avec SEO éditable par le propriétaire.
rest/ : la même couche de données que les appels REST simples, pour un site sans bundler.
seed/ : le script seed qui remplit le site à partir d'un plan, SEED.md comme le contrat du plan, et un lecteur de ce que le site contient déjà.
project/ : la solution composée dans l'échafaudage Astro de la CLI.

compose.mjs à la racine compose les couches d'une solution en un projet.

wix-manage

En ligne : https://www.wix.com/skills/wix-manage/SKILL.md. Sur disque : le skills/wix-manage/ du plugin, ou .agents/skills/wix-manage/.

Recettes REST pour configurer et gérer les solutions métier d'un site, une recette par tâche avec les endpoints exactes, les corps de demande et l'ordre des étapes. SKILL.md est l'index de chaque recette par zone, chacune est un lien. Les recettes sont sous references/<area>/ : app-installation, stores, ecommerce, bookings, calendar, donations, get-paid, pricing-plans, restaurants, events, blog, cms, rich-content, forms, contacts, automations, marketing, google-ads, google-business-profile, analytics, seo, media, sites, domains, site-properties, collaborators, custom-apps, dashboard-navigation, accessibility. Chaque recette est aussi un article de docs sous la section de son API.

wix-docs

En ligne : https://www.wix.com/skills/wix-docs/SKILL.md. Sur disque : le skills/wix-docs/ du plugin, ou .agents/skills/wix-docs/.

Vérifie la documentation API et SDK Wix pour confirmer un endpoint, une méthode, une forme de demande et de réponse, un champ, une énumération ou une erreur avant d'écrire du code Wix. SKILL.md a les deux lanes, curl simple et les outils de documentation du MCP, avec les demandes de recherche, parcourir et lire. references/API_SPEC_SEARCH.md : l'index de spec et ses requêtes. references/CALLING.md : les identités qu'un appel s'exécute et comment chaque token est forgé. references/EXTRACTING.md : lire uniquement la partie nécessaire d'un grand menu ou d'une page de méthode avec curl et grep.

wix-readme

Cet index.