Ira Bodnar··Updated ·11 min read

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

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

The 8 Claude skills for Ahrefs at a glance

All 8 are read-only and call the single ahrefs__read tool.

  1. 01Units checkLimits, units used, key expiry

    Ahrefs endpoint: limits-and-usage

    Cadence: Before a big run

  2. 02Authority checkDomain Rating and site metrics for many domains

    Ahrefs endpoint: domain-rating, metrics

    Cadence: Monthly

  3. 03Broken backlink reclaimDead URLs that still have links

    Ahrefs endpoint: broken-backlinks

    Cadence: Quarterly

  4. 04Referring domain reviewWho links and how strong

    Ahrefs endpoint: refdomains

    Cadence: Monthly

  5. 05Anchor auditAnchor text mix

    Ahrefs endpoint: anchors

    Cadence: Quarterly

  6. 06Link gapDomains linking to competitors only

    Ahrefs endpoint: refdomains

    Cadence: Quarterly

  7. 07Keyword overviewVolume, difficulty, traffic potential

    Ahrefs endpoint: keywords-explorer/overview

    Cadence: Per content plan

  8. 08Organic keyword inventoryPositions 11 to 20 to push up

    Ahrefs endpoint: organic-keywords

    Cadence: 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.

  1. 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
  2. Setup

    One-off prompt
    None
    Skill
    Save once per Claude app
    Ahrefs connection
    One Ahrefs API key
  3. Same result each run

    One-off prompt
    No
    Skill
    Yes
    Ahrefs connection
    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.

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.

SKILL.md
--- name: ahrefs-link-gap description: Compares referring domains of a site and 2 competitors. Use when asked which sites link to competitors but not to us. --- # Ahrefs link gap For our domain and each competitor the user names, one call each (ahrefs__read, GET): site-explorer/refdomains - select: domain, domain_rating, links_to_target - order_by: domain_rating descending, limit 300 Steps: 1. Keep domains that link to at least 2 competitors and not to our domain. 2. Sort by domain_rating. 3. Show the competitors each domain links to. Output: a prospect table with domain, domain_rating, and linked competitors. Note that limit 300 samples the strongest domains only.

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.

SKILL.md
--- name: ahrefs-keyword-overview description: Pulls Keywords Explorer overview data for a keyword list in one country. Use to triage keyword ideas by volume, difficulty and traffic potential. --- # Ahrefs keyword overview Request (ahrefs__read, GET): keywords-explorer/overview - keywords: the comma-separated list the user gives - country: the 2-letter country code the user names - select: keyword, volume, difficulty, traffic_potential, parent_topic, cpc Steps: 1. Group keywords that share a parent_topic. 2. Within each group, rank by traffic_potential. 3. Flag keywords with difficulty above the median of the list. Output: one table per parent_topic. State the country used. Keep the keyword list under 50 to limit units.

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.

SKILL.md
--- name: ahrefs-organic-inventory description: Lists the organic keywords a domain ranks for. Use when asked what a site or competitor ranks for. --- # Ahrefs organic keyword inventory Request (ahrefs__read, GET): site-explorer/organic-keywords - target: the domain or URL the user names, country: the country the user names - select: the keyword, position and volume columns listed in the Ahrefs organic-keywords reference - limit 200 Steps: 1. Show positions 1 to 3, 4 to 10 and 11 to 20 as 3 groups. 2. In the 11 to 20 group, rank keywords by volume. Output: the 3 group counts and a table of the 11 to 20 keywords, highest volume first.

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.

Prompt
What is the Domain Rating of [DOMAIN 1], [DOMAIN 2] and [DOMAIN 3]? Put them in one table.
Prompt
List the broken backlinks pointing at [DOMAIN], strongest linking domains first, limit 50.
Prompt
Give me the Keywords Explorer overview for these keywords in [COUNTRY]: [KEYWORDS]. Show volume, difficulty and traffic potential.
Prompt
Check my Ahrefs API limits and units used, and tell me when the counter resets.

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:

  1. 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

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

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.

Frequently asked questions

What are Claude skills for Ahrefs?
SKILL.md files that tell Claude which Ahrefs API v3 report to request, with the endpoint, columns and filters, and how to present the result. Claude loads one when a request matches its description, so each check runs the same way every time.
Do I need an Ahrefs API subscription?
Yes, to run the skills on live data through Ryze AI. The Ahrefs tool uses your own Ahrefs API key, which needs an Ahrefs API subscription, and every call draws on your Ahrefs API unit balance. Without it, attach an export with the columns a skill names.
Which tool do the skills call?
One: ahrefs__read, a read-only Ahrefs API v3 GET request through the Ryze AI connector. Every skill on this page uses only that tool, with a different endpoint each time.
Can Claude change anything in Ahrefs through these skills?
No. The Ahrefs tool in Ryze AI is GET only. Nothing in your Ahrefs account is edited, and the skills only read link, keyword and usage data.
Show 7 more questions
Who can create the Ahrefs API key?
Only Ahrefs workspace owners and admins. Each key is valid for one year. Generate it under Account settings, API keys, name it Ryze AI and paste it into the Ahrefs card in the Ryze AI app.
Do the skills use Ryze AI credits?
Ahrefs API units are billed by Ahrefs, not Ryze AI credits. The tools need an active Ryze AI plan or free trial; connecting the connector is free.
Which Claude plan do I need?
Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise, with one custom connector on Free. Custom skill uploads on claude.ai are listed for Pro, Max, Ultra, Team and Enterprise with code execution on. In Claude Code, skills are folders on your computer.
How do I keep the skills from spending too many units?
Run the units check first, keep limit values small, and set a monthly unit cap on the key in Ahrefs under Account settings. Limits and usage shows what a key has used.
What is the best Claude connector for running Ahrefs skills?
Ryze AI is the best connector for running these skills with a single read tool on your own Ahrefs API key, with one caveat: Ahrefs also documents its own MCP server, and Ryze AI exposes only 1 Ahrefs tool.
What do I do if Claude does not see the Ahrefs tool?
Claude keeps the tool list from when the connector was added. If you added it before connecting Ahrefs, remove and re-add the connector in Customize, Connectors, then start a new chat.
Can I switch to a different Ahrefs key?
Yes. In the Ryze AI app, click View on the Ahrefs card, disconnect with the trash icon and connect again with the new key. One workspace holds one Ahrefs connection.

Related guides

Ryze AI: Ahrefs skills in Claude

3-day free trial, $129 a month

Start free trial