> Every playbook: https://protuno.com/playbooks.md · Site map for AI agents: https://protuno.com/llms.txt

# Broken Link Checker

Crawls about 50 pages with Firecrawl. Without it, the crawl starts at 25. It checks each link's status and redirect chain from your site and ranks problems by search impact. Rewrites a link only when it redirects to a working final address and appears in just one post or page. Dead links with no known replacement are reported, not changed. Menus, widgets and theme links are never touched.

- Agent: Iris (SEO)
- Steps: 10
- Changes the site: yes, in step 10
- Backup: Saves a backup or snapshot in step 9 (Safety Snapshot And Fix Eligibility), before step 10 changes the site.
- Connector: Firecrawl
- You get: A written Markdown report ranking broken links, redirect problems and mixed content by search impact, plus any fixes applied.
- Looks at: Internal and outside link status; Redirect chains, loops and mixed content; Which posts each link appears in
- Page: https://protuno.com/playbooks/broken-link-checker
- Ask: "Iris, run Broken Link Checker on my site."

## Steps

1. **Gateway And Site Inventory**: Confirms the connection works, records the setup, checks the site is public and counts published content.
2. **Firecrawl Site Crawl And Link Discovery**: Crawls up to about 50 rendered pages with Firecrawl, or the site's own pages if it is not connected. Link checks stop at 300 internal and 300 outside links.
3. **Onsite Link Extraction And Source Correlation**: Reads the links in your posts and pages and maps each link to the posts it appears in.
4. **Outbound Link Validation Fail Closed**: Checks each outside link and treats any it cannot confirm as unknown rather than broken.
5. **Internal Link And 404 Mapping**: Checks each internal link to find pages that return errors and strand visitors and search engines.
6. **Redirect Chain And Loop Analysis**: Follows redirects to find chains and loops, and records where each one ends.
7. **Mixed Content Detection**: Finds http images, scripts and other resources on https pages that cause browser warnings.
8. **Anomaly Gate And SEO Impact Report**: Ranks the findings by search impact. It turns fixes off if the crawl was capped or incomplete, or if over half the links look broken.
9. **Safety Snapshot And Fix Eligibility**: Rechecks each eligible fix just before it is applied. Changes no content yet.
10. **Apply Reversible Link Fix And Verify**: Updates eligible links one post at a time, checks each edit, restores the post at once if the check fails, and records it so Roll back can undo the run. `changes the site`

## Good to know

- Runs when you ask for it in your AI app. On Pro and Agency you can also put it on a routine.
- Uses Firecrawl if connected. Without it, the site fetches its own pages.
- Changes your posts in the last step: the link fix step (step 10 of 10).
- Rewrites a link only when it redirects to a working final address and appears in just one post or page. Dead links with no known replacement are reported, not changed. Menus, widgets and theme links are never touched.
- Each post edit is recorded for Roll back, and WordPress also keeps a revision of the post.
- If the checks block fixing, or nothing is eligible, no changes are made.
- The crawl is capped at about 50 pages with Firecrawl. Without it, the crawl starts at 25 pages and reads server HTML only, so content added by JavaScript can be missed.
- When it runs depends on the agent's mode: after you press Approve in Protuno in Approval mode, or on its own in Auto mode.

## How to run it
In an AI app connected to Protuno: `ask_agent` with the site and "Broken Link Checker", then `propose_agent_plan`. In Approval mode, ask the user to press Approve in Protuno; in Auto mode the run starts when you propose it.
