ahrefs-research — Claude Code skill: competitor analysis
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.
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.
What it helps with
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 for the agent
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.
How to install ahrefs-research
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill ahrefs-research -a claude-code
2Manually: put the files in place
~/.claude/skills/ahrefs-research/SKILL.md
Copy the whole skill folder; for one project use .claude/skills/ahrefs-research/
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill ahrefs-research -a codex
2Manually: put the files in place
.agents/skills/ahrefs-research/SKILL.md
For all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill ahrefs-research -a cursor
2Manually: put the files in place
.cursor/skills/ahrefs-research/SKILL.md
Cursor also reads .agents/skills/ and .claude/skills/