Claude Skills for Ahrefs: 8 SKILL.md Files + Prompts
Quick answer: Save each Ahrefs task as a Claude skill that names the API v3 endpoint and columns to request. Run them on live data through the Ryze AI connector, which gives Claude 1 read-only Ahrefs tool that uses your own Ahrefs API key and units.
Below: 8 SKILL.md files, the Ahrefs endpoints each uses, setup and quick prompts.
Ryze AI · SEO Starter
Ahrefs skills on your own API key
- 3-day free trial, $129 a month
Used by 2,000+ marketers
The 8 Claude skills for Ahrefs at a glance
All 8 are read-only and call the single ahrefs__read tool.
- 01Units checkLimits, units used, key expiry
Ahrefs endpoint: limits-and-usage
Cadence: Before a big run
- 02Authority checkDomain Rating and site metrics for many domains
Ahrefs endpoint: domain-rating, metrics
Cadence: Monthly
- 03Broken backlink reclaimDead URLs that still have links
Ahrefs endpoint: broken-backlinks
Cadence: Quarterly
- 04Referring domain reviewWho links and how strong
Ahrefs endpoint: refdomains
Cadence: Monthly
- 05Anchor auditAnchor text mix
Ahrefs endpoint: anchors
Cadence: Quarterly
- 06Link gapDomains linking to competitors only
Ahrefs endpoint: refdomains
Cadence: Quarterly
- 07Keyword overviewVolume, difficulty, traffic potential
Ahrefs endpoint: keywords-explorer/overview
Cadence: Per content plan
- 08Organic keyword inventoryPositions 11 to 20 to push up
Ahrefs endpoint: organic-keywords
Cadence: Monthly
| # | Skill | Job | Ahrefs endpoint | Cadence |
|---|---|---|---|---|
| 01 | Units check | Limits, units used, key expiry | limits-and-usage | Before a big run |
| 02 | Authority check | Domain Rating and site metrics for many domains | domain-rating, metrics | Monthly |
| 03 | Broken backlink reclaim | Dead URLs that still have links | broken-backlinks | Quarterly |
| 04 | Referring domain review | Who links and how strong | refdomains | Monthly |
| 05 | Anchor audit | Anchor text mix | anchors | Quarterly |
| 06 | Link gap | Domains linking to competitors only | refdomains | Quarterly |
| 07 | Keyword overview | Volume, difficulty, traffic potential | keywords-explorer/overview | Per content plan |
| 08 | Organic keyword inventory | Positions 11 to 20 to push up | organic-keywords | Monthly |
Endpoint paths and column names come from the Ahrefs API v3 reference, opened November 15, 2026. Test each skill on a small limit first, because every call spends your Ahrefs API units.
What are Claude skills for Ahrefs?
A Claude skill for Ahrefs is a saved SKILL.md file that tells Claude which Ahrefs report to request and what to hand back. Per Anthropic's Agent Skills docs, the file starts with a name and a description, and Claude loads the rest only when a request matches the description.
The name allows up to 64 lowercase letters, numbers and hyphens and cannot contain the words claude or anthropic, so every skill here starts with ahrefs. The description, up to 1,024 characters, says what the skill does and when to use it.
What it is
- One-off prompt
- A question in chat
- Skill
- A saved file with a fixed endpoint, columns and output
- Ahrefs connection
- A tool Claude uses to send the request
Setup
- One-off prompt
- None
- Skill
- Save once per Claude app
- Ahrefs connection
- One Ahrefs API key
Same result each run
- One-off prompt
- No
- Skill
- Yes
- Ahrefs connection
- Depends on the prompt or skill
| One-off prompt | Skill | Ahrefs connection | |
|---|---|---|---|
| What it is | A question in chat | A saved file with a fixed endpoint, columns and output | A tool Claude uses to send the request |
| Setup | None | Save once per Claude app | One Ahrefs API key |
| Same result each run | No | Yes | Depends on the prompt or skill |
Endpoints and columns follow the Ahrefs API v3 Site Explorer reference. Without a connection, attach an export with matching columns. The connector page Ahrefs MCP server covers the tool itself.
How to install the skills in Claude Code and claude.ai
Claude Code
Save each block as ~/.claude/skills/<skill-name>/SKILL.md for yourself, or .claude/skills/<skill-name>/SKILL.md in a project to share it with the team. Claude picks a skill when your request matches it, or you type /ahrefs-units-check (Claude Code skills docs).
claude.ai
Zip each skill folder and upload it as a custom skill. Anthropic lists this on the Pro, Max, Ultra, Team and Enterprise plans with code execution on.
Connect the data
Connect Ahrefs in the Ryze AI app, then add the connector https://connector.get-ryze.ai/mcp in Claude under Customize, Connectors. The Ryze AI help center has the Ahrefs steps.
Skills uploaded to claude.ai do not reach the API, and skill folders saved in Claude Code do not upload to claude.ai. Claude Code signed in with your claude.ai account downloads your claude.ai skills (Claude Code skills docs). Anthropic advises using skills only from sources you trust. More free skills are in the Claude skills library.
Link skills: backlinks, referring domains and anchors
These five read the backlink profile. Each names the Site Explorer endpoint, so Claude does not guess a path.
01. Units check
Reads the key's limits and usage. Ahrefs documents that requests to this endpoint are free and use no API units, so run it first.
Use it when: before a multi-report task or after a rejected call.
02. Authority check
Compares Domain Rating and organic site metrics across domains you name.
Use it when: you compare competitors or vet outreach prospects.
03. Broken backlink reclaim
Finds links that point at URLs returning errors, grouped by the page they hit.
Use it when: after a migration or a content cleanup.
04. Referring domain review
Shows who links to a domain and how strong the linking sites are.
Use it when: you take over a site or prepare an outreach list.
05. Anchor audit
Groups anchor text so you can see whether the profile leans on keyword anchors.
Use it when: a link profile looks unnatural.
Competitor and keyword skills
These three look outward: competitor links and keyword data.
06. Link gap
Runs the referring domain report for your site and 2 competitors, then compares the lists inside Claude.
Use it when: you plan link outreach. The compare step happens in Claude, not in Ahrefs.
07. Keyword overview
Uses Keywords Explorer overview data for a list of keywords in one country. Ahrefs lists volume and traffic_potential as columns that cost 10 units each, so keep the list short.
Use it when: you triage keyword ideas before writing.
08. Organic keyword inventory
Lists the keywords a domain ranks for and surfaces those just off page one.
Use it when: you look for pages to improve.
Quick Ahrefs prompts: no skill file needed
For a one-time question, a plain prompt is enough once Claude can reach Ahrefs. Replace the words in brackets.
If an answer looks off, ask Claude to show the request it sent.
How to run the skills on live Ahrefs data
A skill only describes the request; Claude needs a connection to send it. The Ryze AI connector gives Claude one Ahrefs tool:
ahrefs__read
- What it does
- Runs a read-only Ahrefs API v3 GET request: Domain Rating, site metrics, referring domains, backlinks, broken backlinks, anchors, organic keywords, Keywords Explorer overview, API limits and usage
- Used by
- Skills 01 to 08
| Tool | What it does | Used by |
|---|---|---|
| ahrefs__read | Runs a read-only Ahrefs API v3 GET request: Domain Rating, site metrics, referring domains, backlinks, broken backlinks, anchors, organic keywords, Keywords Explorer overview, API limits and usage | Skills 01 to 08 |
Ryze AI uses your own Ahrefs API key. It needs an Ahrefs API subscription, and only Ahrefs workspace owners and admins can create keys, each valid for one year. Every call uses your Ahrefs API units, which Ahrefs bills, not Ryze AI credits. The tool only sends GET requests, so Claude cannot change anything in Ahrefs. In Claude, approvals are set per tool under Customize, Connectors, Ryze AI, Tool permissions.
The tools need an active Ryze AI plan or free trial. SEO Starter is $129 a month with a 3-day free trial, and the Ahrefs tool also works on Paid Ads at $89 a month with a 7-day free trial. Plans are on the pricing page. Ahrefs also documents its own MCP server on docs.ahrefs.com; check its page for URL, sign-in and plan details. The Ryze AI side is described on the Ahrefs MCP page, and the integrations hub lists the other platforms.
Troubleshooting: when an Ahrefs skill returns a wrong answer
Claude has no Ahrefs tool
Claude keeps the tool list from when you added the connector. Remove and re-add it, then start a new chat (Ryze AI connector FAQ).
The key is rejected
The key needs an Ahrefs API subscription. A plan without API access is rejected, and a key expires after one year.
No way to create a key
Only Ahrefs workspace owners and admins can. Ask one to generate it.
Units run out
Check limits and usage in Ahrefs under Account settings, run the units check skill and lower the limit values.
Columns missing from the result
Ask Claude to show the select list it sent and compare it with the Ahrefs endpoint reference.
Sources
Checked November 15, 2026
The verdict
Turn each recurring Ahrefs question into a skill with a fixed endpoint and column list. Start with the units check and the referring domain review, keep limits small, and leave one-off questions as prompts.
Ryze AI runs these skills in Claude through one read-only Ahrefs tool on your own API key. Link fixes, redirects and outreach still happen outside Ahrefs and outside this tool.




