301→302
A temporary redirect where a permanent one belongs. Found by Redirect checker →redirect loop
The URL redirects back to itself and never settles. Found by Redirect checker →
A temporary redirect where a permanent one belongs. Found by Redirect checker →redirect loop
The URL redirects back to itself and never settles. Found by Redirect checker →
Audit
Broken link checker with source and position
Find internal and external links to 4xx and 5xx URLs together with the page that links to them, the template area (content, footer, navigation) and the XPath.
How it works
Three steps, one saved scan
Check one page or the whole site
links-check tests the links on one page live. crawl-site walks the site from a start URL and stores the result for a full audit.
See where each broken link sits
With Screaming Frog Inlinks exports, each broken link is listed with its source page, link position and XPath.
Fix the shared block once
Each broken destination lists every page that links to it, so a broken footer or menu link is fixed in one template.
What it checks
Checks in this feature
| Check | What it means | Severity | Evidence |
|---|---|---|---|
BROKEN_INTERNAL_LINK | Internal link points to a 4xx URL | Critical | Screaming Frog Inlinks export (Client Error 4xx) |
LINK_TO_5XX | Internal link points to a 5xx URL | Critical | Screaming Frog Inlinks export (Server Error 5xx) |
BROKEN_EXTERNAL_LINK | External link points to a broken (4xx or 5xx) URL | Important | Screaming Frog Inlinks export (Client Error 4xx) |
BROKEN_BOOKMARK | Link fragment (#id) names no element on the destination page | Important | Crawl fragment check on retained page HTML |
IMAGE_LINK_WITHOUT_TEXT | Image link has neither anchor text nor alt text, so nothing says where it goes | Important | Crawl link placement |
UNSAFE_CROSS_ORIGIN_LINK | target="_blank" link has no rel="noopener" or rel="noreferrer" | Important | Crawl link findings |
How to run it
One command
bash
seohead links-check --url https://example.com/Install first: installation guide. Every command also runs as an MCP tool for AI agents.
Related checks
From the check registry
BROKEN_INTERNAL_LINKLINK_TO_5XXBROKEN_EXTERNAL_LINKBROKEN_BOOKMARKIMAGE_LINK_WITHOUT_TEXTLearn more
From the blog and glossary
Audit
More in this group
Technical SEO audit with 182 checks
FeatureRedirect checker: chains, loops and 302s
FeatureCanonical tag checker
FeatureHreflang checker
FeatureStructured data and schema validator
FeatureTitle and meta description checker
FeatureHeading structure checker
FeatureDuplicate and thin content checker
FeatureImage SEO checker and optimizer
FeatureInternal linking and crawl depth audit
FeaturePage weight and speed checks
FeatureHTTPS and security headers check
FeatureAI search visibility (GEO/AEO)
FeatureFAQ

