Seo ahrefs broken links

Skill lionkiii/claude-seo-skills/skills/seo-ahrefs-broken-links

Find broken backlinks pointing to a domain using Ahrefs: links targeting 404 pages that can be reclaimed. Prioritizes highest-DR lost links for maximum recovery impact. Use when user says "broken backlinks", "broken links", "link reclamation", "dead backlinks", or "404 backlinks".From its SKILL.md

Install

npx -y skills add lionkiii/claude-seo-skills --skill seo-ahrefs-broken-links

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

20 stars20 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
runs commandsInstructs the agent to run 2 commands, including `ToolSearch with query `+ahrefs`` and 1 more.

SKILL.md

3.6 KB, 853 tokens by cl100k_base, as published. Nobody here has run it

Ahrefs Broken Backlinks

Fetches broken backlinks pointing to a domain (links targeting 404/gone pages), sorted by source Domain Rating to prioritize the highest-value reclamation opportunities.

References

@skills/seo/references/mcp-degradation.md @skills/seo/references/ahrefs-api-reference.md

Inputs

domain: The bare domain to analyze (e.g., example.com). Strip https://, http://, and trailing slashes before passing to Ahrefs tools.

MCP Check

Before proceeding, verify Ahrefs MCP is available:

Use ToolSearch with query +ahrefs
If tools are returned → Ahrefs MCP is available, proceed to Execution
If no tools returned → display the Ahrefs MCP error template from references/mcp-degradation.md and stop

Execution

Step 1 — Call Broken Backlinks

Call mcp__claude_ai_ahrefs__site-explorer-broken-backlinks with:

target: the bare domain (e.g., example.com)

Returns per broken backlink: url_from, url_to (the 404 target page), anchor, domain_rating_source, http_code, first_seen

Step 2 — Sort by Priority

Sort by domain_rating_source descending — highest-authority broken links first, as reclaiming them delivers the greatest SEO value.

Step 3 — Generate Reclamation Recommendations

For each broken backlink in the top results:

Suggest the closest matching live page on the domain to redirect the 404 target
If no obvious match exists, recommend contacting the linking site with an updated URL

Output Format

## Ahrefs Broken Backlinks: example.com

### Broken Backlink Summary
| Metric | Value |
|--------|-------|
| Total Broken Backlinks | 87 |
| Unique Linking Domains | 34 |
| High-DR Sources (DR 50+) | 12 |

### Broken Backlinks (sorted by Source DR)

| Linking Page | Linking Page DR | Target Page (404) | Anchor Text | HTTP Code | First Seen |
|-------------|-----------------|-------------------|-------------|-----------|------------|
| news.com/article | 76 | example.com/old-guide | "seo guide" | 404 | 2023-03-12 |
| blog.io/post | 63 | example.com/resources/pdf | "download" | 404 | 2022-11-08 |

### Link Reclamation Opportunities

**1. example.com/old-guide (DR 76 source — news.com/article)**
- Source anchor: "seo guide"
- Action: Redirect `/old-guide` → `/blog/complete-seo-guide` (301 redirect)
- OR: Contact news.com and provide updated URL

**2. example.com/resources/pdf (DR 63 source — blog.io/post)**
- Source anchor: "download"
- Action: Redirect `/resources/pdf` → `/downloads/seo-checklist.pdf` (301 redirect)
- OR: Contact blog.io/post author with updated resource URL

Error — Ahrefs MCP Not Available

If MCP check fails, display the Ahrefs error template from references/mcp-degradation.md:

## Ahrefs MCP Not Available

The `/seo ahrefs broken-links` command requires the Ahrefs MCP, which is not
currently connected.

**What you can do:**
- Use `/seo audit <url>` for a full static SEO analysis without live Ahrefs data
- Use `/seo technical <url>` for technical SEO issues without backlink/keyword data

**To connect Ahrefs MCP:**
- Ensure the Ahrefs MCP is registered at user scope in ~/.claude/mcp.json
- Verify with: cat ~/.claude/mcp.json | grep -i ahrefs
- Ahrefs MCP must be registered at user scope (not project scope) to work in subagents

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Gives 0 of the 12 instructions most marketing audience skills give in 853 tokens

Counted across 690 of the 894 authors here whose files we hold, read 2026-08-07

Apply Poppins font to headingsin 41 of 690, across 6 files
Apply Lora font to body textin 41 of 690, across 6 files
Use Arial fallback for headingsin 39 of 690, across 4 files
Use Georgia fallback for body textin 39 of 690, across 4 files
Maintain text hierarchy and formattingin 39 of 690, across 4 files
Use accent colors for non-text shapesin 38 of 690, across 3 files
Use RGB values for precise color matchingin 38 of 690, across 3 files
Use brand colors for primary text and backgroundsin 36 of 690, across 1 file
Read product marketing context file before asking questions, starting, or auditingin 35 of 690, across 23 files
Use active voice instead of passive voicein 26 of 690, across 10 files
Implement or generate appropriate JSON-LD structured datain 24 of 690, across 17 files
Prioritize clarity over clevernessin 22 of 690, across 8 files

Said here and by no other author read

strip protocol and trailing slash from domain input
verify Ahrefs MCP availability before proceeding
fetch broken backlinks using Ahrefs MCP
sort broken backlinks by domain rating descending
suggest matching live page redirects for broken targets
recommend contacting linking sites for updated URLs

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.