Site Audit

Comprehensive audit of a Webflow site's structure, content health, and quality with detailed analysis and multiple export formats.

Important Note

ALWAYS use Webflow MCP tools for all operations:

Use Webflow MCP's
```
data_sites_tool
```
with action
```
list_sites
```
for listing available sites
Use Webflow MCP's
```
data_sites_tool
```
with action
```
get_site
```
for detailed site information
Use Webflow MCP's
```
data_pages_tool
```
with action
```
list_pages
```
for retrieving all pages
Use Webflow MCP's
```
data_cms_tool
```
with action
```
get_collection_list
```
for listing CMS collections
Use Webflow MCP's
```
data_cms_tool
```
with action
```
get_collection_details
```
for detailed collection schemas
Use Webflow MCP's
```
data_cms_tool
```
with action
```
list_collection_items
```
for counting items
Use Webflow MCP's
```
webflow_guide_tool
```
to get best practices before starting
DO NOT use any other tools or methods for Webflow operations
All tool calls must include the required
```
context
```
parameter (15-25 words, third-person perspective)

Instructions

Phase 1: Site Selection & Discovery

Get site: Identify the target site. If user does not provide site ID, ask for it.
Fetch site details: Use Webflow MCP's
```
data_sites_tool
```
with action
```
get_site
```
to retrieve:
- Site name and ID
- Last published date
- Last updated date
- Timezone
- Locales (primary and secondary)
- Custom domains
Ask user preferences: Ask what level of detail they want:
- Quick summary (counts only)
- Standard inventory (pages + collections + counts)
- Detailed inventory (includes all field schemas, item samples, SEO data)
- Full export (everything + export to file format)

Phase 2: Pages Inventory

List all pages: Use Webflow MCP's
```
data_pages_tool
```
with action
```
list_pages
```
to fetch all pages
Categorize pages:
- Static pages (no collectionId)
- CMS template pages (has collectionId)
- Archived pages
- Draft pages
Analyze page structure:
- Count pages by type
- Identify pages missing SEO metadata
- Detect orphaned pages (no navigation links)
- Check for duplicate slugs

Phase 3: CMS Collections Inventory

List all collections: Use Webflow MCP's
```
data_cms_tool
```
with action
```
get_collection_list
```
For each collection:
- Get detailed schema using Webflow MCP's
```
collections_get
```
- Count items using Webflow MCP's
```
collections_items_list_items
```
- Analyze field types and requirements
- Identify required vs optional fields
- Detect reference fields and relationships
Collection analysis:
- Empty collections (0 items)
- Unused collections (no template page)
- Large collections (100+ items)
- Collections with missing required fields

Phase 4: Analysis & Insights

Generate insights:
- Total content count (pages + items)
- Content health score
- SEO readiness
- Recommended improvements
Identify issues:
- Missing SEO metadata
- Empty collections
- Orphaned pages
- Draft content ratio
Show relationships:
- Which pages use which collections
- Reference field connections
- Content dependencies

Phase 5: Export & Formatting

Ask export format (if user wants full export):
- Markdown (readable, great for documentation)
- JSON (machine-readable, for migrations)
- CSV (spreadsheet-friendly, for analysis)
- Text summary (console output only)
Generate report in requested format
Provide actionable insights: Suggest next steps based on findings

Examples

User prompt:

Give me a complete inventory of my site.

Step 1: Initial Report (Standard Inventory)

📊 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?

Step 2: Detailed Analysis (when user requests)

🔍 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)

Step 3: Export Options

📥 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)

Guidelines

Phase 1: Critical Requirements

Site Information:

Always fetch complete site details using
```
sites_get
```
Include last published and last updated dates
Show timezone and locale information
Display custom domains if configured

User Options: Offer multiple detail levels:

Quick: Just counts
Standard: Pages + collections + basic info
Detailed: Full schema + analysis + insights
Export: Everything + file output

Phase 2: Pages Analysis

Page Categorization:

Separate static pages from CMS template pages
Flag archived and draft pages separately
Show page slugs/URLs for reference
Identify pages with missing SEO metadata

Page Health Checks:

Missing meta descriptions
Missing OG tags
Duplicate slugs (error condition)
Orphaned pages (not linked in nav)

Phase 3: Collections Analysis

Collection Details: For each collection, show:

Display name and singular name
Slug (URL structure)
Total field count
Required vs optional fields breakdown
Item count (published/draft/archived)
Last updated date

Field Analysis: Categorize by type:

Text fields (PlainText, RichText)
Media fields (Image, Video, File)
Relationship fields (Reference, MultiReference)
Data fields (DateTime, Number, Color)
Boolean fields (Switch)
Selection fields (Option)

Field Validation:

Show max length constraints
Show validation patterns
Flag required fields
Identify reference field targets

Phase 4: Analysis & Insights

Content Health Score (0-100): Calculate based on:

SEO metadata completeness (25 points)
Content-to-page ratio (20 points)
Field utilization (20 points)
Recent updates (15 points)
Structure quality (20 points)

Issue Detection:

🔴 Critical: Missing required fields, duplicate slugs
⚠️ Warning: Empty collections, missing SEO, drafts
💡 Suggestion: Add pages, create relationships, organize

Recommendations: Suggest improvements based on:

Missing page types (About, Contact, etc.)
Underutilized collections
Missing relationships between collections
SEO optimization opportunities

Phase 5: Export Formats

Markdown Export:

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 Export:

json

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

CSV Export: Generate separate files:

```
pages.csv
```
: All pages with metadata
```
collections.csv
```
: Collection metadata
```
fields.csv
```
: All fields across collections
```
items.csv
```
: Item counts per collection

Performance Optimization

Batch Processing:

For sites with 20+ collections, show progress
For collections with 100+ items, paginate counts
Provide estimated time for large sites

Error Handling:

If
```
pages_list
```
fails, continue with collections
If
```
collections_get
```
fails, show basic collection info
Report partial successes separately
Offer to retry failed operations

Data Efficiency:

Use pagination for large result sets
Only fetch detailed schemas when needed
Limit item samples to 3-5 per collection
Cache site info for repeat operations

Best Practices

Read-Only Operation:

No confirmation needed (read-only)
Safe to run multiple times
No side effects or modifications

Clear Organization:

Group by content type (pages/collections)
Use visual hierarchy (├── └──)
Show counts prominently
Highlight issues with icons (✅ ⚠️ 🔴 💡)

Actionable Output:

Always end with recommendations
Offer export options for detailed inventories
Suggest next steps based on findings
Provide comparison against best practices

Version Tracking: If user runs inventory multiple times:

Compare with previous run
Show changes (new pages, deleted collections)
Track content growth over time
Alert on significant changes

site-audit

NPX Install

Tags

SKILL.md Content

Site Audit

Important Note

Instructions

Phase 1: Site Selection & Discovery

Phase 2: Pages Inventory

Phase 3: CMS Collections Inventory

Phase 4: Analysis & Insights

Phase 5: Export & Formatting

Examples

Guidelines

Phase 1: Critical Requirements

Phase 2: Pages Analysis

Phase 3: Collections Analysis

Phase 4: Analysis & Insights

Phase 5: Export Formats

Performance Optimization

Best Practices