/asset-audit

name: webflow-mcp:asset-audit
description: Analyze assets on a Webflow site for SEO optimization. Identifies assets missing alt text and assets with non-SEO-friendly names, then generates and applies improvements.
mcp-version: 2.0.1

Asset Audit

Analyze assets on a Webflow site for SEO optimization.

Important Note

**ALWAYS use Webflow MCP tools for all operations:**

• Use Webflow MCP's `data_assets_tool` for fetching and updating assets
• Use Webflow MCP's `get_asset_preview` (with the asset's `asset_id`) for analyzing image content
• Use Webflow MCP's `data_sites_tool` with action `list_sites` for listing available sites
• 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 & Asset Discovery

1. **Get site**: Identify the target site. If user does not provide site ID, ask for it. 2. **Fetch all assets**: Use Webflow MCP's `data_assets_tool` to get all assets from the site (each asset record includes its `asset_id`, needed for previews)

• For sites with 50+ assets, process in batches of 20
• Show progress: "Processing assets 1-20 of 150..."

3. **Detect patterns**: Analyze asset naming for common patterns:

• Camera uploads (IMG_, DSC_, etc.)
• Screenshots (screenshot, Screen Shot, etc.)
• Generic names (untitled, image-1, etc.)
• Date-based names (2024-01-10, etc.)

Phase 2: Issue Analysis & Pattern Recognition

4. **Identify issues**: List all assets which:

• Do not have alt text set (null or empty string)
• Have existing alt text but it's poor quality (too short, redundant phrases, etc.)
• Do not have SEO-friendly asset names
• Are duplicates or very similar

5. **Pattern detection report**: Show detected patterns:

   🔍 Detected patterns:
   - 15 assets start with "IMG_" (camera uploads)
   - 8 assets contain "screenshot"
   - Suggest: Bulk rename these patterns

6. **Ask user preference**: Ask if they want to generate:

• Alt text only
• SEO-friendly names only
• Both
• Apply naming pattern/template

Phase 3: Analysis & Suggestion Generation

7. **Analyze assets**: Use Webflow MCP's `get_asset_preview` tool, passing each asset's `asset_id` (from Phase 1), to analyze the assets that need updates

• **Error handling**: If Webflow MCP's `get_asset_preview` fails, use fallback:
• Extract description from existing filename
• Use generic placeholder with warning
• Continue with other assets
• Process in batches to avoid timeout

8. **Generate suggestions with validation**:

• **Alt text validation**:
• Max 125 characters (warn if longer)
• No redundant phrases ("image of", "picture of", "photo of")
• Must end with punctuation
• Flag generic descriptions (confidence < 50%)
• **SEO name validation**:
• Only lowercase a-z, 0-9, hyphens
• No double extensions (.webp.webp) - strip existing extension first
• Max 100 characters
• Replace spaces/underscores with hyphens
• No special characters

9. **Folder organization suggestions**: If patterns detected, suggest folder structure:

   💡 Organization suggestions:
   - Create "team-photos" folder for 8 team images
   - Create "product-images" folder for 15 product shots

Phase 4: Granular Approval & Application

10. **Present suggestions with granular approval**:

• Show numbered list with checkboxes
• Allow individual toggle: "Enter numbers to skip (e.g., '2,4')"
• Options: "all", "none", or specific numbers
• Show validation warnings for each suggestion

11. **Offer naming template** (if many similar assets):

    🎨 Apply naming pattern?
    1. [category]-[description] (e.g., team-john-headshot)
    2. [description]-[location] (e.g., office-workspace-desk)
    3. Custom pattern...
    4. Skip patterns, use individual names

12. **Store rollback data**: Before applying changes, store:

• Original asset names
• Original alt text
• Timestamp
• Assets modified

13. **Apply updates**: Use Webflow MCP's `data_assets_tool` to update approved assets only

• Show progress for batch updates
• Handle partial failures gracefully
• Report successes and failures separately

14. **Offer rollback option**: After changes applied:

    📋 Rollback Available:
    Last update: 4 assets modified 2 minutes ago
    Type "undo" to revert these changes

Examples

**User prompt:**

Run an asset audit on my site.

**Step 1: Initial Audit Report**

📊 SEO Asset Audit: MCP Demo #2

Total: 4 assets

🔍 Detected patterns:
- 4 assets have generic numeric names (1.webp, 2.webp, 3.webp, 4.webp)
- All assets are in WebP format ✓

⚠️ Missing Alt Text (4 assets):
├── 1.webp (empty alt text)
├── 2.webp (empty alt text)
├── 3.webp (empty alt text)
└── 4.webp (empty alt text)

⚠️ Non-SEO-Friendly Names (4 assets):
├── 1.webp (generic numeric name)
├── 2.webp (generic numeric name)
├── 3.webp (generic numeric name)
└── 4.webp (generic numeric name)

---

What would you like to generate?
1. Alt text only
2. SEO-friendly names only
3. Both alt text and SEO-friendly names

Please select an option (1, 2, or 3).

**Example with Validation Warnings:**

📋 Suggested Improvements:

[1] ✓ IMG_1234.jpg
    Alt text: "Professional team member headshot with blue background."
    New name: professional-team-member-headshot.jpg
    ✅ Validation passed

[2] ✓ screenshot-2024.png
    Alt text: "Dashboard analytics overview showing user engagement metrics."
    New name: dashboard-analytics-overview.png
    ✅ Validation passed

[3] ⚠️ untitled-image.webp
    Alt text: "Photo"
    ⚠️ Warning: Alt text too short (< 10 chars) - needs more detail
    New name: untitled-image.webp
    ⚠️ Warning: Unable to generate better name (image p