Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Marketing & sales

webflow-mcp:asset-audit

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.

webflow · AI review on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add webflow/webflow-skills --skill webflow-mcp:asset-audit

About this skill


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

  1. 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
  2. Pattern detection report: Show detected patterns:
    🔍 Detected patterns:
    - 15 assets start with "IMG_" (camera uploads)
    - 8 assets contain "screenshot"
    - Suggest: Bulk rename these patterns
    
  3. 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

  1. 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
  2. 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
  3. 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

  1. 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
  2. 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
    
  3. Store rollback data: Before applying changes, store:
    • Original asset names
    • Original alt text
    • Timestamp
    • Assets modified
  4. 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
  5. 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
Read the complete source ↗