May 14, 2026

How to Find Broken Links with Claude and MCP

Let Claude crawl your site and flag every broken link, with context on where each one is linked from.

Mehmet Kose
2 mins read

Broken links hurt SEO and user experience. Instead of running a CLI command and reading raw output, you can ask Claude to find broken links for you. The agent crawls the site, checks outgoing links, and presents the results in plain language.

This guide shows the agent-driven equivalent of the CLI broken link audit.

Step 1: Install crawler-mcp

Run the install script:

curl -fsSL https://install.crawler.sh/install-mcp.sh | sh

This downloads the correct binary for your platform to ~/.crawler/bin/crawler-mcp.

For more detail, see the installation guide.

Step 2: Wire it into your client

Ask the agent to crawl and check outgoing links:

Use crawler-sh to crawl https://example.com to depth 3. Check outgoing links and report any that return 4xx or 5xx.

The crawl_site tool checks outgoing links by default. Each page result includes an outgoing_link_errors array with broken URLs, status codes, and the linking page.

Ask Claude to summarise the findings:

List every broken link, the page it was found on, and the HTTP status code.

Claude extracts the outgoing_link_errors from each page and presents a clean table.

Step 5: Export for your team

Ask Claude to format the report:

Create a CSV with columns: broken_url, status_code, found_on_page, link_type.

Claude writes a structured report you can share with developers or content editors.

Frequently Asked Questions

Crawler.sh - Free Local AEO & SEO Spider and a Markdown content extractor | Product Hunt