/link-checker

name: webflow-mcp:link-checker
description: Find and fix broken or insecure links across an entire site, including CMS content, to improve SEO and user experience. Audits HTTP/HTTPS issues and validates all internal and external links.
mcp-version: 2.0.1

Link Checker

Audit and fix broken or insecure links across your Webflow site to improve SEO and user experience.

Important Note

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

• Use Webflow MCP's `webflow_guide_tool` to get best practices before starting
• Use Webflow MCP's `data_sites_tool` with action `list_sites` to identify available sites
• Use Webflow MCP's `data_sites_tool` with action `get_site` to retrieve site details
• Use Webflow MCP's `data_pages_tool` with action `list_pages` to get all pages
• Use Webflow MCP's `data_pages_tool` with action `get_page_content` to extract links from static pages
• Use Webflow MCP's `data_pages_tool` with action `update_static_content` to fix links on static pages
• Use Webflow MCP's `data_cms_tool` with action `get_collection_list` to get all CMS collections
• Use Webflow MCP's `data_cms_tool` with action `get_collection_details` to get collection schemas
• Use Webflow MCP's `data_cms_tool` with action `list_collection_items` to get CMS items with links
• Use Webflow MCP's `data_cms_tool` with action `update_collection_items` to fix links in CMS (draft)
• Use Webflow MCP's `data_cms_tool` with action `publish_collection_items` to publish fixed CMS items
• 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)
• No Designer connection is required — both static page and CMS link fixes go through `data_` tools

Instructions

Phase 1: Site Selection & Discovery

1. **Get site information**: Use Webflow MCP's `data_sites_tool` with action `list_sites` to identify target site 2. **Confirm scope**: Ask user if they want to check:

• Static pages only
• CMS content only
• Both static pages and CMS content

3. **List pages**: Use Webflow MCP's `data_pages_tool` with action `list_pages` to get all pages 4. **List collections**: Use Webflow MCP's `data_cms_tool` with action `get_collection_list` to get all CMS collections

Phase 2: Link Extraction & Validation

5. **Extract links from static pages**: Use Webflow MCP's `data_pages_tool` with action `get_page_content` for each page

• Identify all link elements (Link, Button, TextLink, LinkBlock)
• Capture: pageId, nodeName, URL, link text

6. **Extract links from CMS**: Use Webflow MCP's `data_cms_tool` with action `list_collection_items` for each collection

• Identify Link fields and Rich Text fields with links
• Capture: collectionId, itemId, fieldName, URL

7. **Validate each link**: Test URL accessibility

• Check for 4xx/5xx errors (broken links)
• Check for HTTP vs HTTPS (insecure links)
• Test if HTTP has HTTPS equivalent available
• Flag redirects (3xx status codes)

8. **Categorize results**:

• ✅ Working links (2xx status)
• ❌ Broken links (4xx/5xx errors)
• ⚠️ Insecure links (HTTP when HTTPS available)
• 🔄 Redirects (3xx status)
• ⚪ Manual review needed (timeouts, DNS errors, etc.)

Phase 3: Analysis & Reporting

9. **Calculate statistics**:

• Total links scanned
• Links by type (internal vs external)
• Links by status (working, broken, insecure, redirects)
• Links by location (static pages vs CMS)

10. **Generate health score**: Calculate link health (0-100)

• Working links: +1 point each
• Broken links: -5 points each
• Insecure links: -2 points each
• Redirects: -1 point each
• Normalize to 0-100 scale

11. **Identify critical issues**: Prioritize fixes

• 🔴 Critical: Broken links on high-traffic pages
• ⚠️ Warning: Insecure HTTP links
• 💡 Suggestion: Optimize redirects

Phase 4: Suggestion Generation & Approval

12. **Generate fix suggestions**: For each problematic link, suggest fix

• Broken links: Remove link or update to correct URL
• Insecure links: Upgrade HTTP to HTTPS
• Redirects: Update to final destination URL

13. **Show preview with validation**:

    [1] ✓ Fix insecure link
        Page: About Us
        Element: Button "Learn More"
        Current: http://example.com
        Suggested: https://example.com
        ✅ HTTPS version verified working

    [2] ⚠️ Fix broken link
        Page: Blog Post "Getting Started"
        Element: Text link
        Current: https://oldsite.com/page
        Suggested: [REMOVE LINK or provide correct URL]
        ❌ URL returns 404 - manual review needed

14. **Implement granular approval**: Ask user which fixes to apply

• Type numbers to skip (e.g., "2,4")
• Type "all" to proceed with all automatic fixes
• Type "none" to cancel
• Flag manual review items separately

Phase 5: Execution & Confirmation

15. **Apply fixes to static pages**: Use Webflow MCP's `data_pages_tool` with action `update_static_content`

• Update link URLs in nodes
• Process in batches of 20 links

16. **Apply fixes to CMS content**: Use Webflow MCP's `data_cms_tool` with action `update_collection_items`

• Update Link fields directly
• Update links in Rich Text fields
• Process in batches of 50 items

17. **Publish changes** (if requested): Use Webflow MCP's `data_cms_tool` with action `publish_collection_items` 18. **Show progress**: Display progress indicators for large operations 19. **Generate final report**:

• Links scanned: X
• Links fixed: Y
• Links requiring manual review: Z
• Health score improvement: Before → After

Phase 6: Verification & Recommendations

20. **Verify fixes**: Re-check fixed links to confirm success 21. **Report failures**: Clearly identify any fixes that failed 22. **Provide recommendations**:

• Schedule regular link checks (monthly/quarterly)
• Set up monitoring for critical externa