npx skills add https://github.com/webflow/webflow-skills --skill safe-publish通过全面的预览、验证和明确的确认工作流程发布 Webflow 站点。
始终使用 Webflow MCP 工具进行所有操作:
data_sites_tool 和 list_sites 操作来列出可用站点data_sites_tool 和 get_site 操作来获取详细的站点信息data_pages_tool 和 list_pages 操作来检索所有页面data_cms_tool 和 get_collection_list 操作来列出 CMS 集合广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
data_cms_tool 和 list_collection_items 操作来检查草稿项目data_sites_tool 和 publish_site 操作来发布站点webflow_guide_tool 在开始前获取最佳实践context 参数(15-25 个单词,第三人称视角)data_sites_tool 和 get_site 操作来检索:
* 最后发布日期
* 最后更新日期
* 配置的自定义域名
* 区域设置lastUpdated 与 lastPublished 时间戳
* 如果 lastPublished 为 null,则站点从未发布过
* 如果 lastUpdated > lastPublished,则站点有未发布的更改data_pages_tool 和 list_pages 操作lastUpdated 与站点的 lastPublished 进行比较
* 标记上次发布后修改的页面
* 按类型分类(静态、CMS 模板、已归档、草稿)data_cms_tool 和 get_collection_list 操作collections_items_list_items
* 统计 isDraft: true 的项目
* 统计自上次发布后修改的项目data_sites_tool 和 publish_site 操作,并附带正确的参数
* 如果没有自定义域名,则将 customDomains 作为空数组处理
* 根据用户选择设置 publishToWebflowSubdomainlastPublished 字段记录确切的发布时间lastPublished 时间戳是否已更新
* 验证站点在已发布的 URL 上是否可访问
* 清晰地报告任何验证失败用户提示:
Publish my site
步骤 1:站点选择
🚀 安全发布 - 站点选择
可用站点:
1. **MCP Demo#1**
- 最后发布:2026年1月9日 20:05:38 UTC
- 最后更新:2026年1月9日 20:49:37 UTC
- ⚠️ **有未发布的更改**(在最后发布后 44 分钟更新)
2. **MCP Demo#2**
- 最后更新:2026年1月9日 19:32:53 UTC
- 状态:尚未发布
您想发布哪个站点?(1-2)
步骤 2:变更检测与预览
🚀 发布预览:MCP Demo#1
**最后发布:** 2026年1月9日 20:05:38 UTC
**自上次发布以来的时间:** ~1 小时 5 分钟
---
## 要发布的更改:
### 📄 已修改的页面:1
└── **主页** (/)
- SEO 标题更新为 "Home Page"
- 最后修改:21:10:52 UTC
### 📝 CMS 项目:2 个草稿项目待发布
**博客文章 (2 个草稿):**
1. **"Why Webflow MCP Will Transform Your Workflow in 2026!"**
- 状态:草稿
- 创建时间:20:24:44 UTC
- 最后修改:21:11:03 UTC
- 精选:是
- 别名:webflow-mcp-transform-workflow-2026
2. **"Webflow E-commerce: The Future of Online Shopping in 2026!"**
- 状态:草稿
- 创建时间:20:05:24 UTC
- 最后修改:21:11:11 UTC
- 精选:是
- 别名:webflow-ecommerce-2026
---
**发布前检查:**
- ✅ 未检测到损坏的引用
- ✅ 所有必填字段已填写
- ⚠️ 2 个草稿项目将变为已发布
**发布目标:**
- Webflow 子域名:mcp-demo-1-e88499.webflow.io
- 自定义域名:未配置
**⚠️ 输入 "publish" 以使这些更改生效。**
步骤 3:用户输入 "publish" 后
🔄 正在发布 MCP Demo#1...
进度:████████████████████ 100%
✅ 发布成功!
**站点:** MCP Demo#1
**发布时间:** 2026-01-09 21:12:52 UTC (2026年1月9日 21:12:52)
---
## 已上线内容:
### 📄 页面 (1)
- ✅ 主页 (/) - SEO 标题已更新
### 📝 博客文章 (2)
- ✅ "Why Webflow MCP Will Transform Your Workflow in 2026!"
- ✅ "Webflow E-commerce: The Future of Online Shopping in 2026!"
---
## 验证:
- ✅ **站点可访问:** 是
- ✅ **URL:** https://mcp-demo-1-e88499.webflow.io
- ✅ **状态:** 页面加载成功
- ✅ **内容交付:** Webflow CDN 响应正常
---
**🎉 您的站点现已上线,所有更改均已发布!**
所有未发布的更改已成功发布到 Webflow 子域名。2 篇草稿博客文章现在可以在您的站点上看到。
替代方案:带警告
🚀 发布预览:公司站点
**最后发布:** 2026年1月8日 14:30:00 UTC
---
## 要发布的更改:
### 📄 已修改的页面:3
├── **关于** (/about)
│ └── 内容已更新
├── **联系** (/contact)
│ └── 表单字段已更改
└── **主页** (/)
└── 主图部分已更新
### 📝 CMS 项目
**博客文章:**
- 5 个已发布项目已修改
- 2 个草稿项目(将不会自动发布)
**产品:**
- 3 个新项目已创建
- 1 个项目已更新
---
**发布前检查:**
⚠️ **发现警告:**
1. **缺少 SEO 元数据 (2 个页面):**
- /about - 无元描述
- /contact - 无元标题或描述
- 💡 建议:在发布前添加 SEO 元数据
2. **草稿项目 (2):**
- "Upcoming Product Launch" (博客文章)
- "Holiday Sale Announcement" (博客文章)
- ⚠️ 这些将保持未发布状态
3. **大型更改集:**
- 3 个页面 + 9 个 CMS 项目将被更新
- 请考虑仔细审查更改
**发布目标:**
- Webflow 子域名:company-site.webflow.io
- 自定义域名:example.com, www.example.com
---
**您希望:**
1. 继续发布 (输入 "publish")
2. 取消并审查 (输入 "cancel")
站点状态检查:
sites_get 获取完整的站点详情lastUpdated 与 lastPublished 以检测未发布的更改lastPublished 为 null,警告"首次发布 - 整个站点将上线"时间戳处理:
页面变更检测:
lastUpdated 与站点的 lastPublished 进行比较lastUpdated > lastPublished 的页面CMS 项目检测:
isDraft 字段lastUpdated 与站点的 lastPublished 进行比较要检查的集合:
collections_list 查询所有集合collections_items_list_items 列出项目必需检查:
seo.title 或 seo.description警告级别:
何时阻止发布:
确认要求:
发布 API 使用:
// sites_publish 的正确格式
{
"site_id": "site-id-here",
"publishToWebflowSubdomain": true, // 或 false
"customDomains": [] // 必须是数组,即使为空
}
// 如果存在自定义域名:
{
"site_id": "site-id-here",
"publishToWebflowSubdomain": false,
"customDomains": ["example.com", "www.example.com"]
}
域名选择:
错误处理:
customDomains 验证错误:确保它是一个数组400 Bad Request:检查请求格式403 Forbidden:检查站点发布权限500 Server Error:5 秒后重试一次,然后报告失败发布后验证:
sites_getlastPublished 时间戳是否已更新验证失败处理:
成功报告格式:
✅ 发布成功!
站点:[站点名称]
发布时间:[ISO 时间戳] ([人类可读格式])
已上线内容:
- X 个页面已修改
- Y 个 CMS 项目已发布
- Z 个草稿项目已提升为已发布
验证:
✅ 站点可访问
✅ URL:[主 URL]
✅ 响应时间:[Xms]
[如果有自定义域名]
自定义域名:
✅ example.com - 可访问
⚠️ www.example.com - 正在传播(可能需要 2-3 分钟)
始终:
绝不:
边缘情况:
没有要发布的更改:
ℹ️ 没有要发布的更改
最后发布:2026年1月9日 20:05:38 UTC
最后更新:2026年1月9日 20:05:38 UTC
所有更改均已发布。您的站点是最新的!
首次发布(从未发布过):
⚠️ 首次发布警告
此站点从未发布过。
这将使整个站点公开可访问:
- 所有页面 (2 个页面)
- 所有 CMS 项目 (3 个集合中的 47 个项目)
- 所有资源
您准备好让此站点上线了吗?
输入 "publish" 继续,或输入 "cancel" 中止。
发布到暂存子域名:
不支持部分发布:
对于大型站点:
缓存:
超时:
清晰且可操作:
❌ 不好:
"发布失败"
✅ 好:
"发布失败:验证错误
Webflow API 返回错误:
- customDomains 参数必须是数组
这很可能是一个配置问题。正在重试...
常见错误:
customDomains: [] 是一个数组每周安装次数
94
代码仓库
GitHub 星标数
36
首次出现时间
2026年1月21日
安全审计
安装于
cursor82
codex80
gemini-cli79
opencode79
github-copilot71
claude-code69
Publish a Webflow site with comprehensive preview, validation, and explicit confirmation workflow.
ALWAYS use Webflow MCP tools for all operations:
data_sites_tool with action list_sites for listing available sitesdata_sites_tool with action get_site for detailed site informationdata_pages_tool with action list_pages for retrieving all pagesdata_cms_tool with action get_collection_list for listing CMS collectionsdata_cms_tool with action list_collection_items for checking draft itemsdata_sites_tool with action publish_site for publishing the sitewebflow_guide_tool to get best practices before startingcontext parameter (15-25 words, third-person perspective)data_sites_tool with action get_site to retrieve:
lastUpdated vs lastPublished timestampslastPublished is null, site has never been publishedlastUpdated > lastPublished, site has unpublished changesdata_pages_tool with action list_pageslastUpdated with site's lastPublisheddata_cms_tool with action get_collection_listcollections_items_list_itemsisDraft: truedata_sites_tool with action publish_site with correct parameters
* Handle customDomains as empty array if no custom domains
* Set publishToWebflowSubdomain based on user choicelastPublished fieldlastPublished timestamp updated
* Verify site is accessible at published URL(s)
* Report any verification failures clearlyUser prompt:
Publish my site
Step 1: Site Selection
🚀 Safe Publish - Site Selection
Available Sites:
1. **MCP Demo#1**
- Last published: January 9, 2026 at 20:05:38 UTC
- Last updated: January 9, 2026 at 20:49:37 UTC
- ⚠️ **Has unpublished changes** (updated 44 minutes after last publish)
2. **MCP Demo#2**
- Last updated: January 9, 2026 at 19:32:53 UTC
- Status: Not yet published
Which site would you like to publish? (1-2)
Step 2: Change Detection & Preview
🚀 Publish Preview: MCP Demo#1
**Last published:** January 9, 2026 at 20:05:38 UTC
**Time since last publish:** ~1 hour 5 minutes
---
## Changes to Publish:
### 📄 Pages Modified: 1
└── **Home** (/)
- SEO title updated to "Home Page"
- Last modified: 21:10:52 UTC
### 📝 CMS Items: 2 draft items to publish
**Blog Posts (2 drafts):**
1. **"Why Webflow MCP Will Transform Your Workflow in 2026!"**
- Status: Draft
- Created: 20:24:44 UTC
- Last modified: 21:11:03 UTC
- Featured: Yes
- Slug: webflow-mcp-transform-workflow-2026
2. **"Webflow E-commerce: The Future of Online Shopping in 2026!"**
- Status: Draft
- Created: 20:05:24 UTC
- Last modified: 21:11:11 UTC
- Featured: Yes
- Slug: webflow-ecommerce-2026
---
**Pre-Publish Checks:**
- ✅ No broken references detected
- ✅ All required fields populated
- ⚠️ 2 draft items will become published
**Publish Targets:**
- Webflow subdomain: mcp-demo-1-e88499.webflow.io
- Custom domains: None configured
**⚠️ Type "publish" to make these changes live.**
Step 3: After user types "publish"
🔄 Publishing MCP Demo#1...
Progress: ████████████████████ 100%
✅ Published Successfully!
**Site:** MCP Demo#1
**Published at:** 2026-01-09 21:12:52 UTC (January 9, 2026 at 21:12:52)
---
## What Went Live:
### 📄 Pages (1)
- ✅ Home (/) - SEO title updated
### 📝 Blog Posts (2)
- ✅ "Why Webflow MCP Will Transform Your Workflow in 2026!"
- ✅ "Webflow E-commerce: The Future of Online Shopping in 2026!"
---
## Verification:
- ✅ **Site accessible:** Yes
- ✅ **URL:** https://mcp-demo-1-e88499.webflow.io
- ✅ **Status:** Page loading successfully
- ✅ **Content delivery:** Webflow CDN responding
---
**🎉 Your site is now live with all changes published!**
All unpublished changes have been successfully published to the Webflow subdomain. The 2 draft blog posts are now visible on your site.
Alternative: With Warnings
🚀 Publish Preview: Company Site
**Last published:** January 8, 2026 at 14:30:00 UTC
---
## Changes to Publish:
### 📄 Pages Modified: 3
├── **About** (/about)
│ └── Content updated
├── **Contact** (/contact)
│ └── Form fields changed
└── **Home** (/)
└── Hero section updated
### 📝 CMS Items
**Blog Posts:**
- 5 published items modified
- 2 draft items (will NOT be published automatically)
**Products:**
- 3 new items created
- 1 item updated
---
**Pre-Publish Checks:**
⚠️ **Warnings Found:**
1. **Missing SEO Metadata (2 pages):**
- /about - No meta description
- /contact - No meta title or description
- 💡 Recommendation: Add SEO metadata before publishing
2. **Draft Items (2):**
- "Upcoming Product Launch" (Blog Post)
- "Holiday Sale Announcement" (Blog Post)
- ⚠️ These will remain unpublished
3. **Large Change Set:**
- 3 pages + 9 CMS items will be updated
- Consider reviewing changes carefully
**Publish Targets:**
- Webflow subdomain: company-site.webflow.io
- Custom domains: example.com, www.example.com
---
**Would you like to:**
1. Proceed with publish (type "publish")
2. Cancel and review (type "cancel")
Site Status Check:
sites_getlastUpdated vs lastPublished to detect unpublished changeslastPublished is null, warn "First publish - entire site will go live"Timestamp Handling:
Page Change Detection:
lastUpdated with site lastPublishedlastUpdated > lastPublishedCMS Item Detection:
isDraft field for all itemslastUpdated with site lastPublishedCollections to Check:
collections_listcollections_items_list_itemsRequired Checks:
Broken References:
Missing Required Fields:
SEO Completeness:
seo.title or seo.descriptionDraft Item Warning:
Warning Levels:
When to Block Publish:
Confirmation Requirements:
Publish API Usage:
// Correct format for sites_publish
{
"site_id": "site-id-here",
"publishToWebflowSubdomain": true, // or false
"customDomains": [] // MUST be array, even if empty
}
// If custom domains exist:
{
"site_id": "site-id-here",
"publishToWebflowSubdomain": false,
"customDomains": ["example.com", "www.example.com"]
}
Domain Selection:
Error Handling:
customDomains validation error: Ensure it's an array400 Bad Request: Check request format403 Forbidden: Check site publish permissions500 Server Error: Retry once after 5 seconds, then report failurePost-Publish Verification:
Fetch Updated Site Info:
sites_get againlastPublished timestamp updatedSite Accessibility Check:
Custom Domain Checks:
Verification Failure Handling:
Success Report Format:
✅ Published Successfully!
Site: [Site Name]
Published at: [ISO Timestamp] ([Human Readable])
What Went Live:
- X pages modified
- Y CMS items published
- Z draft items promoted to published
Verification:
✅ Site accessible
✅ URL: [primary URL]
✅ Response time: [Xms]
[If custom domains]
Custom Domains:
✅ example.com - accessible
⚠️ www.example.com - propagating (may take 2-3 minutes)
Always:
Never:
Edge Cases:
No Changes to Publish:
ℹ️ No Changes to Publish
Last published: January 9, 2026 at 20:05:38 UTC
Last updated: January 9, 2026 at 20:05:38 UTC
All changes are already published. Your site is up to date!
First Publish (Never Published Before):
⚠️ First Publish Warning
This site has NEVER been published before.
This will make the ENTIRE site publicly accessible:
- All pages (2 pages)
- All CMS items (47 items across 3 collections)
- All assets
Are you ready to make this site live?
Type "publish" to proceed, or "cancel" to abort.
Publish to Staging Subdomain:
Partial Publish Not Supported:
For Large Sites:
Caching:
Timeouts:
Clear and Actionable:
❌ Bad:
"Publish failed"
✅ Good:
"Publish Failed: Validation Error
The Webflow API returned an error:
- customDomains parameter must be an array
This is likely a configuration issue. Retrying...
Common Errors:
Validation Error (customDomains):
customDomains: [] is an arraySite Not Found:
Insufficient Permissions:
Publish Already in Progress:
Weekly Installs
94
Repository
GitHub Stars
36
First Seen
Jan 21, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
cursor82
codex80
gemini-cli79
opencode79
github-copilot71
claude-code69
通过 LiteLLM 代理让 Claude Code 对接 GitHub Copilot 运行 | 高级变通方案指南
43,100 周安装
GitHub Agentic Workflows 听写指令:AI驱动工作流语音输入技术指南
GraphQL Schema Stitching & Federation Agent - Apollo Federation v2 超图组合与验证工具
GraphQL Schema Stitcher:Apollo Federation v2 模式缝合工具,统一联邦网关
GraphQL Schema Introspector - 模式自省、查询复杂度分析与API差异报告工具
GraphQL模式自省映射器:API分析、类型生成与模式差异报告
GraphQL Schema Explorer - GraphQL API 模式探索与自动化工具