Connect Ahrefs MCP to your AI Agents

Ask your Ahrefs SEO data anything: backlinks, keywords, and traffic.

Example prompts

Everything you can ask your agent about your Ahrefs data.

Ask in plain English — Sequel translates it into a Ahrefs query, runs it, and your agent hands back the answer. No SQL, no dashboards, no CSV exports.

Connect to your agent
What you can ask your agent
  • What's the domain rating and organic traffic for ahrefs.com?
  • Show the top 50 referring domains for competitor.com.
  • Which organic keywords does example.com rank for in the US top 10?
  • What's the search volume and difficulty for 'text to sql'?
  • List example.com's top pages by organic traffic.

Sequel CLI

Install Ahrefs MCP to your agent

The Sequel CLI installs Ahrefs into your coding agent in one step: it signs you in, provisions a scoped API key, and writes the right config to the right place. No keys to copy by hand.

Prefer npm? npm install -g @sequelsh/cli@latest works too.

  1. 1

    Install the Sequel CLI

    One line installs the latest CLI with whatever package manager you have.

    curl -fsSL https://sequel.sh/install | sh
  2. 2

    Sign in

    Authenticate in your browser and pick an organization.

    sequel login
  3. 3

    Install into your agent

    Run install and pick an agent from the list, or target one directly by its slug.

    sequel install
    • Claude Code
      sequel install claude-code
    • Claude
      sequel install claude
    • Cursor
      sequel install cursor
    • VS Code
      sequel install vscode
    • Windsurf
      sequel install windsurf
    • Zed
      sequel install zed
    • Codex
      sequel install codex
    • OpenClaw
      sequel install openclaw
    • Hermes
      sequel install hermes

Skills

Playbooks that run on Ahrefs

Step-by-step procedures your agent follows on your Ahrefs data, instead of improvising a query. Browse all skills

Analyze high-ranking landing pages

See which pages perform best in organic search: the landing pages that earn the most clicks and impressions, the queries behind each one, and how they compare with competitor estimates from Ahrefs.

Audit redirect chains and loops

Follow every redirect on the URLs Search Console still sends traffic to, on the sitemap, and on backlinked pages, to find chains, loops, redirects to the homepage, and temporary redirects that should be permanent, so link equity and crawl budget stop leaking.

Audit referring domain quality

Grade the domains linking to a site by authority, traffic and link count, spot concentration risk and link-farm patterns, and separate the referring domains that carry weight from the ones that are noise.

Backlink profile health check

See who links to the site and whether the backlink profile is healthy: referring domains, authority distribution, anchor text mix, dofollow share and concentration risk from Ahrefs, optionally compared against a competitor.

Competitor keyword gap analysis

Compare what competitors rank for against your own coverage to find high-value keywords you're missing entirely.

Find a competitor's new backlinks and turn them into prospects

Find the new backlinks a competitor has earned recently, where they came from and how they got them, then turn the pattern into a prospect list: which sites are linking to competitors in your space right now, which competitor pages attract links, and which of those sites already link to a rival but not to you.

Frequently asked questions

How do I connect Ahrefs to Sequel?

Create an API key in Ahrefs under Account settings → API keys (workspace owners and admins only), paste it into Sequel, and click Test. The key is sent to the Ahrefs API v3 as a Bearer token.

Do I need a specific Ahrefs plan?

The Ahrefs API is available on eligible paid plans. On other plans you still get a limited set of free test queries. See Ahrefs' pricing page for current API eligibility.

Can Sequel change anything in my Ahrefs account?

No. The connector only ships read-only reports (domain overview, backlinks, referring domains, organic keywords, top pages, keyword research). It cannot modify your Ahrefs projects or settings.

Will queries consume my Ahrefs API units?

Most reports cost Ahrefs API units (minimum 50 per request), billed against your plan's allowance. Validating your key is free. Use specific targets and small row limits to keep usage low.

Does Sequel store my Ahrefs data?

No. Report results are returned to your session and discarded; only your API key is stored, encrypted at rest. You can rotate or revoke it from Ahrefs at any time.

Can I combine Ahrefs with my other data sources?

Yes. Combine Ahrefs with Google Analytics or Search Console (SEO performance), or with your warehouse (organic traffic vs. revenue) and ask across all of them in a single question.

Start analyzing your Ahrefs data today

Connect in minutes — then ask across all your data, not just one source.