site-audit

站点审计

全面审计 Webflow 站点的结构、内容健康状况和质量，并提供详细分析和多种导出格式。

重要说明

所有操作始终使用 Webflow MCP 工具：

• 使用 Webflow MCP 的 data_sites_tool，通过 list_sites 操作列出可用站点
• 使用 Webflow MCP 的 data_sites_tool，通过 get_site 操作获取站点详细信息
• 使用 Webflow MCP 的 data_pages_tool，通过 list_pages 操作获取所有页面
• 使用 Webflow MCP 的 data_cms_tool，通过 get_collection_list 操作列出 CMS 集合
• 使用 Webflow MCP 的 data_cms_tool，通过 get_collection_details 操作获取集合的详细架构
• 使用 Webflow MCP 的 data_cms_tool，通过 list_collection_items 操作统计条目数量
• 开始前使用 Webflow MCP 的 webflow_guide_tool 获取最佳实践
• 请勿使用其他工具或方法操作 Webflow
• 所有工具调用都必须包含必需的 context 参数（15-25 个词，使用第三人称视角）

说明

阶段 1：站点选择与发现

1. 获取站点：确定目标站点。如果用户未提供站点 ID，请向其询问。
2. 获取站点详情：使用 Webflow MCP 的 data_sites_tool，通过 get_site 操作获取：
   • 站点名称和 ID
   • 上次发布的日期
   • 上次更新的日期
   • 时区
   • 区域设置（主要和次要）
   • 自定义域名
3. 询问用户偏好：询问用户希望获得哪种详细程度：
   • 快速摘要（仅计数）
   • 标准清单（页面 + 集合 + 计数）
   • 详细清单（包括所有字段架构、条目示例、SEO 数据）
   • 完整导出（全部内容 + 导出为文件格式）

阶段 2：页面清单

4. 列出所有页面：使用 Webflow MCP 的 data_pages_tool，通过 list_pages 操作获取所有页面
5. 对页面分类：
   • 静态页面（没有 collectionId）
   • CMS 模板页面（有 collectionId）
   • 已归档页面
   • 草稿页面
6. 分析页面结构：
   • 按类型统计页面数量
   • 找出缺少 SEO 元数据的页面
   • 检测孤立页面（没有导航链接）
   • 检查重复的 slug

阶段 3：CMS 集合清单

7. 列出所有集合：使用 Webflow MCP 的 data_cms_tool，通过 get_collection_list 操作
8. 针对每个集合：
   • 使用 Webflow MCP 的 data_cms_tool，通过 get_collection_details 操作获取详细架构
   • 使用 Webflow MCP 的 data_cms_tool，通过 list_collection_items 操作统计条目数量
   • 分析字段类型和要求
   • 确定必填字段与可选字段
   • 检测引用字段和关系
9. 分析集合：
   • 空集合（0 个条目）
   • 未使用的集合（没有模板页面）
   • 大型集合（100 个以上条目）
   • 缺少必填字段的集合

阶段 4：分析与洞察

10. 生成洞察：
    • 内容总量（页面 + 条目）
    • 内容健康评分
    • SEO 就绪情况
    • 改进建议
11. 找出问题：
    • 缺少 SEO 元数据
    • 空集合
    • 孤立页面
    • 草稿内容占比
12. 展示关系：
    • 页面使用了哪些集合
    • 引用字段的关联
    • 内容依赖关系

阶段 5：导出与格式

13. 询问导出格式（如果用户需要完整导出）：
    • Markdown（易于阅读，适合编写文档）
    • JSON（机器可读，适合迁移）
    • CSV（便于在电子表格中使用，适合分析）
    • 文本摘要（仅输出到控制台）
14. 按指定格式生成报告
15. 提供可执行的洞察：根据调查结果建议后续步骤

示例

用户提示词：

Give me a complete inventory of my site.

步骤 1：初始报告（标准清单）

📊 Site Audit: MCP Demo#1

**Site Details:**
- Site ID: 6924868ede9d3fbbc3195eb0
- Last published: January 9, 2026
- Last updated: January 9, 2026
- Timezone: Asia/Calcutta
- Primary locale: English (en)

---

**Pages (2 total):**

Static Pages (1):
├── Home (/)

CMS Template Pages (1):
└── Blog Posts Template (/post)
    - Collection: Blog Posts

---

**CMS Collections (1):**

Blog Posts (9 items)
├── Slug: post
├── Fields (8):
│   ├── Name (PlainText, required)
│   ├── Slug (PlainText, required)
│   ├── Post Body (RichText)
│   ├── Post Summary (PlainText)
│   ├── Main Image (Image)
│   ├── Thumbnail image (Image)
│   ├── Featured? (Switch)
│   └── Color (Color)

---

**Summary:**
- ✅ 2 pages (1 static, 1 CMS template)
- ✅ 1 CMS collection with 9 published items
- ✅ Site fully published and up-to-date

Would you like a detailed analysis or export in a specific format?

步骤 2：详细分析（用户提出要求时）

🔍 Detailed Analysis: MCP Demo#1

**Content Health Score: 85/100**

✅ Strengths:
- All collections have items (no empty collections)
- All pages are published (no drafts)
- Site recently published (Jan 9, 2026)
- Consistent field structure in Blog Posts

⚠️ Areas for Improvement:
- No SEO metadata on template page (missing meta description)
- Limited page count (consider adding About, Contact pages)
- No reference fields (could link categories/authors to posts)

💡 Recommendations:
1. Add meta descriptions to all pages for better SEO
2. Consider creating a Categories collection for post organization
3. Add an Authors collection for multi-author blog support
4. Create navigation pages (About, Contact, Privacy Policy)

**Collection Breakdown:**

Blog Posts:
- 9 published items (0 drafts, 0 archived)
- 5 featured posts (56%)
- All required fields populated ✓
- Field usage:
  - Name: 100% (9/9)
  - Slug: 100% (9/9)
  - Post Body: 100% (9/9)
  - Post Summary: 100% (9/9)
  - Main Image: 100% (9/9)
  - Thumbnail: 100% (9/9)
  - Featured: 100% (9/9)
  - Color: 100% (9/9)

**Sample Items:**
1. "Why Webflow is the Best Choice for 2026" (featured)
2. "Top Webflow Features to Look Forward to in 2026"
3. "Webflow vs. Competitors: Who Will Win in 2026?" (featured)

---

Export this inventory? (markdown/json/csv/no)

步骤 3：导出选项

📥 Export Format Options:

1. **Markdown** - Human-readable documentation
   - Great for README files, wikis, documentation
   - Preserves structure and formatting

2. **JSON** - Machine-readable structured data
   - Perfect for migrations, integrations
   - Includes all raw API data

3. **CSV** - Spreadsheet-friendly
   - Easy to analyze in Excel/Google Sheets
   - Separate files for pages and collections

Which format would you like? (1/2/3)

指南

阶段 1：关键要求

站点信息：

• 始终使用 data_sites_tool，并通过 action get_site 获取完整的站点详情
• 包含最近发布和最近更新的日期
• 显示时区和区域设置信息
• 如果已配置自定义域名，则显示这些域名

用户选项： 提供多个详情级别：

• 快速：仅显示数量
• 标准：页面 + 集合 + 基本信息
• 详细：完整架构 + 分析 + 洞察
• 导出：所有信息 + 文件输出

阶段 2：页面分析

页面分类：

• 将静态页面与 CMS 模板页面分开
• 分别标记已归档页面和草稿页面
• 显示页面 slug/URL，以供参考
• 找出缺少 SEO 元数据的页面

页面健康检查：

• 缺少 meta description
• 缺少 OG 标签
• slug 重复（错误条件）
• 孤立页面（未链接到导航）

阶段 3：集合分析

集合详情： 对于每个集合，显示：

• 显示名称和单数名称
• slug（URL 结构）
• 字段总数
• 必填字段与可选字段细分
• 项目数量（已发布/草稿/已归档）
• 最近更新日期

字段分析： 按类型分类：

• 文本字段（PlainText、RichText）
• 媒体字段（Image、Video、File）
• 关系字段（Reference、MultiReference）
• 数据字段（DateTime、Number、Color）
• 布尔字段（Switch）
• 选择字段（Option）

字段验证：

• 显示最大长度限制
• 显示验证模式
• 标记必填字段
• 找出引用字段的目标

阶段 4：分析与洞察

内容健康评分（0-100）： 根据以下项目计算：

• SEO 元数据完整度（25 分）
• 内容与页面比例（20 分）
• 字段利用率（20 分）
• 最近更新情况（15 分）
• 结构质量（20 分）

问题检测：

• 🔴 严重：缺少必填字段、slug 重复
• ⚠️ 警告：空集合、缺少 SEO、草稿
• 💡 建议：添加页面、创建关系、整理内容

建议： 根据以下情况提出改进建议：

• 缺少的页面类型（关于、联系等）
• 利用率低的集合
• 集合之间缺少关系
• SEO 优化机会

阶段 5：导出格式

Markdown 导出：

# Site Audit: [Site Name]

## Site Information
- ID: [site-id]
- Last Published: [date]

## Pages
### Static Pages
- Home (/)
- About (/about)

### CMS Templates
- Blog Post (/post/[slug])

## Collections
### Blog Posts (47 items)
**Fields:**
- Title (PlainText, required)
- Slug (PlainText, required)
- Content (RichText)
...

JSON 导出：

{
  "site": {
    "id": "...",
    "name": "...",
    "lastPublished": "..."
  },
  "pages": [...],
  "collections": [...]
}

CSV 导出： 生成单独的文件：

• pages.csv：所有页面及其元数据
• collections.csv：集合元数据
• fields.csv：所有集合中的字段
• items.csv：每个集合的项目数量

性能优化

批处理：

• 对于包含 20 个以上集合的站点，显示进度
• 对于包含 100 个以上项目的集合，分页统计数量
• 为大型站点提供预计耗时

错误处理：

• 如果 data_pages_tool 使用 action list_pages 失败，则继续处理集合
• 如果 data_cms_tool 使用 action get_collection_details 失败，则显示基本集合信息
• 单独报告部分成功的操作
• 提供重试失败操作的选项

数据效率：

• 对大型结果集使用分页
• 仅在需要时获取详细架构
• 每个集合最多取 3-5 个项目样本
• 缓存站点信息，以便重复操作时使用

最佳实践

只读操作：

• 无需确认（只读）
• 可安全地多次运行
• 不会产生副作用或修改

清晰的组织结构：

• 按内容类型分组（页面/集合）
• 使用视觉层级（├── └──）
• 突出显示数量
• 使用图标突出问题（✅ ⚠️ 🔴 💡）

可执行的输出：

• 始终以建议结尾
• 为详细清单提供导出选项
• 根据发现的问题建议后续步骤
• 提供与最佳实践的对照

版本跟踪： 如果用户多次运行清单：

• 与上一次运行结果进行比较
• 显示变化（新增页面、已删除集合）
• 跟踪内容随时间的增长情况
• 对重大变化发出提醒