broken-link-checker

Crawl website pages and report broken links with HTTP status categories.

Updated Sep 20, 2025
One-click install
npx skills add https://github.com/quanghuynguyen1902/truongphat --skill broken-link-checker-quanghuynguyen1902
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: broken-link-checker
Source: https://github.com/quanghuynguyen1902/truongphat/tree/main/seo/broken-link-checker
Command: npx skills add https://github.com/quanghuynguyen1902/truongphat --skill broken-link-checker-quanghuynguyen1902

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Scans a website to find broken links (404s, 500s). Crawls internal pages, identifies broken outbound links, and reports source pages for easy fixing. Use this when the user asks to "check for broken links", "find 404s", "audit my links", or "is my site healthy".

Core Features & Use Cases

  • Crawls a site up to a configurable page limit and respects robots.txt where possible.
  • Detects broken links (404s and 5xx server errors) and reports the source page for quick fixes.
  • Distinguishes internal vs external broken links and provides actionable fixes.

Quick Start

Run the checker against your target URL to start scanning for broken links within the specified page limit.

Frequently Asked Questions about broken-link-checker

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

FAQPage Schema
How do I find and fix broken links on my website?

Broken link checkers scan website pages by crawling internal links and validating HTTP responses to identify 4xx and 5xx errors. They distinguish internal versus external targets and map each broken link back to its source page for quick fixes.

How does a website crawler detect 404 and 500 server errors?

A website crawler detects 404 and 500 server errors by requesting URLs found on your internal pages and evaluating their returned HTTP status codes. It categorizes any 4xx or 5xx response as a broken link and logs the specific source page where the dead link was found.

How do I audit my website links for internal vs external errors?

You audit website links by crawling internal pages and categorizing broken outbound links by their HTTP status codes. The audit distinguishes whether the broken targets are internal pages or external domains, mapping each error to its source page for targeted fixes.

Can I limit the crawl depth when checking for broken links?

Yes, you can limit crawl depth by specifying a max-pages parameter when running the broken link checker script. This configurable limit restricts the number of internal pages scanned, allowing you to control the scope and duration of the website audit.

What format does the broken link audit report use?

The broken link audit outputs a structured JSON report. This format contains source-page mappings that categorize broken links by their HTTP status codes and distinguish between internal and external targets for actionable website fixes.

Do I need to install dependencies to run the broken link checker?

No external dependencies are required to run the broken link checker script. You simply execute the provided Python script with your target URL and an optional max-pages parameter to start scanning and generating the JSON report.