Wix 插件由两部分组成:技能(skills)和 Wix MCP 服务器。技能是用于在 Wix 上构建的指令与随附代码文件夹,每个技能的根目录都有一个 SKILL.md;Wix MCP 服务器位于 https://mcp.wix.com/mcp,其工具可读取和修改用户的 Wix 站点与账户。技能说明“怎么做”,工具负责“执行”。
【使用流程】 每次对话先调用一次 WixREADME,它返回完整流程以及账户的站点及其已安装应用。随后选择站点:siteId 来自站点上下文,若有多个匹配项需询问用户;某项业务方案的 API 仅在该站点已安装对应应用时可用,应用版本会影响端点,因此需先检查站点应用。接着查找方法:优先使用对话中较早的工具结果;其次是覆盖该任务的技能(技能索引说明各自用途),若其示例与当前情形匹配即以该示例为模型;再次是文档工具——REST 用 SearchWixRESTDocumentation 或 BrowseWixRESTDocsMenu,代码用 SDK、CLI、headless 及应用相关搜索,再用 ReadFullDocsArticle 读取方法页面。然后获取精确结构:请求以匹配情形的示例为模型(技能中的配方或模板,或方法文档页展示所需字段时),这已足够;schema 用于示例未展示的内容,如字段、枚举、过滤或排序键(每个方法的封闭列表)。SearchWixAPISpec 针对方法文档 URL 返回请求与响应 schema、REST URL 和 JavaScript SDK 调用;不可用时用 ReadFullDocsMethodSchema。最后发起调用或编写代码:立即执行用 ExecuteWixAPI,一个函数承载任务的全部步骤及读写;用户保留的代码则按第 4 步找到的结构编写 REST 或 SDK 调用。wix-headless-templates 是已编写并验证的代码,每个业务方案一个文件夹;wix-headless-kit 在其上构建站点。全程不得凭记忆使用任何 Wix 专有信息:每个 URL、id、设置位置、产品事实、请求结构和字段名都须来自技能、文档工具、较早的工具结果或用户。
【创建站点】 新的 Wix 站点以代码编写并上传。StartDeployWebsite 返回由智能体编写站点或归档用户带来文件的指南;StartHeadlessBuild 返回需要 Wix 业务功能(商店、预订、CMS、会员、支付等)站点的 headless 指南。每个指南负责创建站点、上传并说明后续步骤,调用其一并遵循。指南基于:站点由 provision 调用(POST .../headless-business-setup/v1/headless-business/provision,origin: 'agent')创建一次,返回 metaSiteId,即后续每次调用所用的 id;较早创建的站点用 ListWixSites 找到并可再次上传,URL 不变。静态页面可投放,Wix Astro 构建可发布:投放每次发送完整文件集;构建(dist/ 旁的 .wix/build-metadata.json)通过 UploadHeadlessWebsiteFiles 发布到 Wix 托管并服务端渲染,可作为附件,或分两步(prepare: true 携带 zip 大小,再 uploadKey)从可联网的 shell 上传。项目源代码随发布存储,后续会话可据此继续站点。UploadHeadlessWebsiteFiles 接收 siteId 和文件(附件或文件文本包),返回线上 URL 和仪表板。无 MCP 时,同样的投放是 curl multipart 调用,可带或不带登录。业务功能来自 wix-headless-kit 在同一站点和 appId 上的运行:安装应用并填充内容,从 wix-headless-templates 构建 Astro 项目,发布构建。
【两种使用方式】 首选方式为插件加 Wix MCP:插件的 MCP 配置连接 https://mcp.wix.com/mcp,客户端在首次调用时让用户登录,工具列表中出现相应工具,无需安装。上述流程在其上运行:WixREADME 获取上下文,文档工具查找方法与结构,ExecuteWixAPI 调用,StartDeployWebsite 和 StartHeadlessBuild 配合 UploadHeadlessWebsiteFiles 创建站点并上线。技能从插件文件夹读取,不在本地时用 ReadFullDocsArticle 在线阅读。另一种方式是从 shell 使用 Wix CLI(@wix/cli):登录 Wix 账户,在磁盘上创建和管理 Wix 项目(Wix 应用或 Wix Headless 站点),构建并发布到 Wix,为 REST 调用铸造令牌;会话保存在本机。命令均以 npx @wix/cli@latest <command> 形式执行,包括 login、whoami、create、env pull、build、release、token(及 token --site <siteId>)。无 MCP 时,每个工具都是对同一后端的普通 HTTP 调用,wix-docs 以 curl 方式覆盖这些请求体。
【技能索引】 wix-headless-kit:基于随附已验证的 @wix/sdk 代码构建 Wix Headless 站点,每个 Wix 业务方案含类型化数据层、hooks、组件、Astro 页面和种子脚本,源自 wix-headless-templates;智能体在这些 hooks 上设计展示并发布到 Wix 托管。可作为 CLI 流程或经 MCP 的 Wix API 调用运行。其文件包含 SKILL.md、guides/api-run.md、guides/capabilities.md、guides/existing-site.md、guides/migration.md、guides/reference-mode.md、guides/feedback.md,以及 install/ 下的运行脚本和 pins.json。冷启动文档 wix-headless-cold-start/headless-kit.md 衡量三项事实(MCP 工具是否在工具列表、Node 24.18 或更高且 npm 可达注册表、能否将构建交给 UploadHeadlessWebsiteFiles)以选择路线。 wix-headless-templates:wix-headless-kit 构建所依据的代码,每个业务方案一个文件夹(storefront、bookings、rentals、blog、cms、forms、members、events、restaurants、donations、pricing-plans、portfolio、faq,以及 blank 和 shared),每个含 INSTRUCTIONS.md、app/、app-astro/、rest/、seed/、project/,根目录 compose.mjs 组合各层。 wix-manage:配置和管理站点业务方案的 REST 配方,每个任务一份,含精确端点、请求体和步骤顺序;SKILL.md 是全部配方的索引,配方位于 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 等。 wix-docs:在编写 Wix 代码前查找 Wix API 和 SDK 文档以确认端点、方法、请求与响应结构、字段、枚举或错误;含 curl 与 MCP 文档工具两条路线,以及 references/API_SPEC_SEARCH.md、references/CALLING.md、references/EXTRACTING.md。 wix-readme:即本索引。
【工具一览】 上下文类:WixREADME、ListWixSites、GetSiteContext。建站与部署类:StartDeployWebsite、StartHeadlessBuild、UploadHeadlessWebsiteFiles、GetSuggestedDomains。API 调用类:ExecuteWixAPI、SearchWixAPISpec。文档类:SearchWixRESTDocumentation、BrowseWixRESTDocsMenu、SearchWixSDKDocumentation、SearchWixHeadlessDocumentation、SearchWixCLIDocumentation、SearchWixWDSDocumentation、SearchBuildAppsDocumentation、SearchDevelopmentDocumentation、SearchWixHelpCenter、ReadFullDocsArticle、ReadFullDocsMethodSchema。媒体与反馈类:UploadImageToWixSite、PickImagesForWixMedia、ReportIssueToWix。
【适用场景与限制】 适用于通过智能体或 CLI 在 Wix 上建站、部署静态站或 Headless 站点、调用 Wix REST API 与 SDK、查阅 Wix 文档以及管理站点业务方案。限制包括:需连接 Wix MCP 并登录账户,或在本机建立 Wix CLI 会话;headless 构建路线对环境有要求(如 Node 版本与 npm 可达性、将构建交给上传工具的方式);不得依赖记忆中的 Wix 信息;资料未提供具体收费、价格与效果数据。