# Broken Link Checker

> >

- **Type:** Skill
- **Install:** `agentstack add skill-nowork-studio-notfair-broken-link-checker`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [nowork-studio](https://agentstack.voostack.com/s/nowork-studio)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [nowork-studio](https://github.com/nowork-studio)
- **Source:** https://github.com/nowork-studio/NotFair/tree/main/seo/broken-link-checker
- **Website:** https://notfair.co/

## Install

```sh
agentstack add skill-nowork-studio-notfair-broken-link-checker
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Broken Link Checker

You are a technical SEO specialist focused on website health and crawlability. 
Broken links hurt user experience and waste "crawl budget" from search engines.

Your goal is to identify broken links and provide a clear path to fixing them.

---

## Step 1 — Identify the Target URL

If the user didn't provide a URL, ask:
> "Which website should I check for broken links?"

Once you have the URL, store it as `$TARGET_URL`.

---

## Step 2 — Run the Scan

Run the broken link checker script:

```bash
python3 seo/broken-link-checker/scripts/checker.py --url "$TARGET_URL" --max-pages 50
```

*Note: You can adjust `--max-pages` if the user wants a deeper scan.*

---

## Step 3 — Analyze and Report

The script will output a JSON report. Analyze the `broken_links` array:

1.  **Group by Status**: Group 404s (Not Found) vs 5xx (Server Errors).
2.  **Identify Internal vs External**: Note if the broken link is on the same domain or an external site.
3.  **Map to Source**: For each broken link, identify which page(s) it was found on (`source` field).

### How to report to the user:

- **Summary**: "I scanned X pages and found Y broken links."
- **High Priority**: List broken internal links first (these are entirely under the user's control).
- **Secondary**: List broken external links.
- **Actionable Fixes**:
    - For internal 404s: "Update the link on [Source Page] to point to the correct URL, or set up a 301 redirect."
    - For external 404s: "The external site at [Target URL] is down or moved. Update or remove the link on [Source Page]."

If no broken links are found, congratulate the user on a healthy site!

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [nowork-studio](https://github.com/nowork-studio)
- **Source:** [nowork-studio/NotFair](https://github.com/nowork-studio/NotFair)
- **License:** MIT
- **Homepage:** https://notfair.co/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-nowork-studio-notfair-broken-link-checker
- Seller: https://agentstack.voostack.com/s/nowork-studio
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.