Skip to main content
skill CX Codex

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.

no license 393 installs ★ 1,797 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Illyism/seo-skills --skill ahrefs-research -a claude-code
Open on GitHub

What ahrefs-research 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.

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/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about ahrefs-research

How do I install ahrefs-research in Claude Code?

Run npx skills add Illyism/seo-skills --skill ahrefs-research -a claude-code. The skill file is at ~/.claude/skills/ahrefs-research/SKILL.md.

What does ahrefs-research do?

It compares ranking pages and topics across a site and its competitors, then writes a content-gap backlog and page scaffolds into the project.

What does ahrefs-research need to run?

It needs access to Ahrefs MCP tools or an AHREFS_API_KEY for API v3. An Ahrefs CSV report export is another supported input.

Similar skills

All skills for SEO and GEO →

From the same set29

The whole set →
proof-kb The proof-kb Claude Code skill builds a repository knowledge base of first-hand product evidence for SEO pages. It runs when creating the evidence store, revising a page, or distributing a new fact across related pages. CX Codex +1 412installs seo-blog-images The seo-blog-images Claude Code skill plans blog visuals and checks image SEO details. It activates when adding a cover, product screenshots, or charts to a post. CX Codex +1 410installs reddit-serp The reddit-serp Claude Code skill finds open Reddit threads already ranking in search or cited by AI answers. It builds a thread queue when asked for Reddit marketing research. CX Codex +1 409installs honest-link-outreach The honest-link-outreach Claude Code skill generates a vetted backlink outreach batch in seo/outreach-batch-YYYY-MM-DD.md. CX Codex +1 405installs youtube-seo Claude Code skill youtube-seo turns video recordings into YouTube titles, timestamped descriptions, and launch posts. CX Codex +1 404installs dataforseo-serp The dataforseo-serp Claude Code skill gathers search results and groups queries by the pages that rank for them. Run it to map keyword intent, spot competing pages, or find sources cited by AI Overviews. CX Codex +1 399installs parasite-and-pr parasite-and-pr — a skill that generates a syndication bundle for external content distribution. It produces drafted press releases and technical articles designed to gain faster search engine visibility. CX Codex +1 398installs domain-migration The domain-migration Claude Code skill prepares URL redirects and SEO changes for a site migration. It activates for domain changes, site merges, and bulk URL renaming. CX Codex +1 395installs

Project sponsors

Companies that keep this analytics open