toprank-broken-link-checker

Detect broken internal and external links during bounded website crawls.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/seppegadeyne/toprank-skills --skill toprank-broken-link-checker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: toprank-broken-link-checker
Source: https://github.com/seppegadeyne/toprank-skills/tree/main/toprank-broken-link-checker
Command: npx skills add https://github.com/seppegadeyne/toprank-skills --skill toprank-broken-link-checker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of undetected broken internal and external links that damage site SEO, frustrate users, and waste search engine crawl budget by providing a bounded, safe crawl to identify all broken resources.

Core Features & Use Cases

  • Bounded Safe Crawl: Limits crawl scope to avoid overloading servers or triggering rate limits.
  • Accurate Error Classification: Distinguishes hard 404/5xx errors from soft 404 pages and avoids misclassifying rate-limited 429 responses without manual verification.
  • Categorized Issue Reporting: Groups broken links by type (internal pages, assets, external references, redirects, technical endpoints) for easy remediation.
  • Safe Redirect Recommendations: Only suggests redirects when there is a clear matching destination and user intent is preserved, leaving bot/API endpoints untouched unless explicitly requested.
  • Use Case: A site manager running a pre-launch audit for a new e-commerce site can use this Skill to catch all broken links to old product pages, missing image assets, and outdated external references before search engines index the broken content.

Quick Start

Use the toprank-broken-link-checker skill to run a bounded broken link crawl on your website https://yourdomain.com and get a full report of all detected 404 and 5xx errors.

Frequently Asked Questions about toprank-broken-link-checker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the difference between hard 404 errors and soft 404 pages during a crawl audit?

Bounded website crawling limits the crawl scope to avoid overloading servers or triggering rate limits while detecting broken internal and external links. This approach safely identifies 404 and 5xx HTTP errors without disrupting live site performance during SEO audits or pre-launch checks.

Can I run a broken link crawl audit for a pre-launch e-commerce site check?

Yes, you can run a bounded broken link crawl for pre-launch e-commerce site checks to catch broken links to old product pages, missing image assets, and outdated external references. This ensures search engines do not index broken content before the site goes live.

How are detected broken links categorized for site health remediation?

Detected broken links are grouped by type for easy site health remediation, categorizing issues into internal pages, assets, external references, redirects, and technical endpoints. This classification helps prioritize fixes across different content and technical resources during a crawl audit.

Does this broken link checker automatically apply safe redirect recommendations?

The broken link checker only suggests safe redirects when a clear matching destination exists and user intent is preserved. It leaves bot and API technical endpoints untouched unless explicitly requested, ensuring site configuration is never automatically modified.

Why does crawl health monitoring matter for SEO and search engine crawl budget?

Crawl health monitoring identifies undetected broken internal and external links that damage SEO and waste search engine crawl budget. By detecting 404 and 5xx HTTP errors, it prevents search engines from wasting resources on broken content and improves overall site health.