# ahrefs-research

The ahrefs-research Claude Code skill turns Ahrefs data into a content-gap plan. It runs for competitor research, backlink audits, and requests to find topics or pages worth investigating.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 393 installs · ★ 1797 repo stars
- Author: illyism
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Illyism/seo-skills/tree/HEAD/seo/ahrefs-research/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/ahrefs-research

## What it does

The skill compares a site’s ranking pages with competitors’ pages, then writes findings to `seo/competitor-gaps.md`. It sorts topics into a backlog and prepares page scaffolds for the next items. Existing routes can be marked for refresh instead of duplicated.

Ahrefs data comes from its MCP server or API v3; REST access needs `AHREFS_API_KEY`. A CSV report export works as a fallback when only the Ahrefs interface is available. Raw API responses are cached as JSON and reused for 7 days.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill ahrefs-research -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ahrefs-research/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ahrefs-research/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill ahrefs-research -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ahrefs-research/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill ahrefs-research -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ahrefs-research/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Illyism/seo-skills seo/ahrefs-research/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/ahrefs-research/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill ahrefs-research -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Illyism/seo-skills --path seo/ahrefs-research
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ahrefs-research/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill ahrefs-research -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Illyism/seo-skills/tree/HEAD/seo/ahrefs-research/SKILL.md

## When to use it
- find topics competitors rank for that the site has not covered
- separate missing pages from content that needs a refresh
- turn Ahrefs competitor data into a prioritized page backlog

## Example prompts
- Compare our site with competitors in Ahrefs and draft a content-gap plan.
- Find competitor topics we have not covered and scaffold the highest-priority pages.
- Use this Ahrefs CSV export to identify pages that need a refresh.

## Similar
- [ahrefs-python](https://affpapa.org/en/nevibecode/skills/ahrefs-python.md) — skill · 329 installs
- [pp-ahrefs](https://affpapa.org/en/nevibecode/skills/pp-ahrefs.md) — skill · 259 installs
- [seo-ahrefs](https://affpapa.org/en/nevibecode/skills/seo-ahrefs.md) — skill · ★ 159 repo stars
- [developer-keyword-research](https://affpapa.org/en/nevibecode/skills/developer-keyword-research.md) — skill · 13400 installs
- [keyword-research](https://affpapa.org/en/nevibecode/skills/every-app-keyword-research.md) — skill · 7800 installs
- [Content Research Writer](https://affpapa.org/en/nevibecode/skills/claude-office-skills-content-research-writer.md) — skill · 4900 installs

From the same set: [illyism/seo-skills](https://affpapa.org/en/nevibecode/by/illyism/seo-skills.md) — 29 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
