- Docs
- Connect Ahrefs to Claude
How to Connect Ahrefs to Claude with CorpusIQ MCP¶
Ahrefs holds the clearest view of who ranks for what, but the work of reading it is manual. A competitive question turns into five tabs, three exports and a spreadsheet that is out of date by the time anyone opens it.
Connecting Ahrefs to Claude through CorpusIQ MCP makes the research conversational. Ask how two domains compare, and the answer names the referring domains and keywords behind the comparison.
Why Connect Ahrefs to Claude?¶
- Domain comparison in one answer. Domain Rating, referring domains and organic traffic for several domains side by side.
- Keyword footprint questions. Which terms a domain ranks for in the top ten, with positions and volumes.
- Backlink reading. Live backlinks, referring domains and historical totals without the backlink explorer.
- Competitor sizing. Organic competitors and the pages earning their traffic, so content gaps are visible rather than inferred.
- Demand checks. Search volume, difficulty and CPC before a keyword decision, in the same thread as the content plan.
- Read path only. CorpusIQ reads Ahrefs data through its API and returns it to the conversation.
How It Works¶
- Connect Ahrefs to CorpusIQ using an API token from your Ahrefs account.
- Connect CorpusIQ to Claude as an MCP server, using the config block from your CorpusIQ account settings.
- CorpusIQ translates your question into the Ahrefs API calls that answer it: domain overview, organic keywords, backlinks, referring domains or keyword research.
- Claude answers from the returned data, naming the domain and metric each figure describes.
CorpusIQ uses read-only access for direct MCP live retrieval. It does not retain raw customer files or full connector response payloads; operational logs retain query text, per-user tool-call metadata, and bounded outcome summaries for up to 30 days.
Setup Steps¶
In CorpusIQ
- Log in to CorpusIQ and open Connectors.
- Select Ahrefs and click Connect.
- In a second tab, open Ahrefs Settings, API and copy your API token. API access requires an Advanced plan or higher.
- Paste the token into the CorpusIQ form and save. Ahrefs turns from gray to green.
- Copy the MCP config block under Settings, Integrations, Claude Desktop.
In Claude Desktop
- Open Settings, Developer, Edit Config. This opens
claude_desktop_config.json. - Add the CorpusIQ entry:
{
"mcpServers": {
"corpusiq": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://mcp2.corpusiq.io/mcp"
]
}
}
}
- Save the file and fully quit Claude Desktop. Not just the window: quit the application.
- Reopen Claude, complete the device login when prompted, and the tools indicator appears next to the message box.
If the tools indicator does not appear, work through Claude can't see CorpusIQ before changing anything else.
Example Claude Questions¶
Domain questions
- "What is the Domain Rating for competitor.com?"
- "Compare Domain Rating and referring domains for our domain against our three closest competitors."
- "How much organic traffic does example.com get per month?"
- "Which of these four domains has the strongest backlink profile?"
Keyword questions
- "Which keywords does my domain rank for in the top 10?"
- "What is the search volume and CPC for enterprise CRM?"
- "Which high volume keywords do competitors rank for that we do not?"
- "List our quick win keywords: positions 11 to 20 with volume above 500."
Backlink and content questions
- "Show me the top referring domains linking to my site."
- "Which competitor pages earn the most organic traffic?"
- "Who are my top organic competitors?"
- "Has our referring domain count grown this quarter?"
Security¶
- Token-scoped access. The API token carries the permissions of your Ahrefs account and the limits of your plan. Issue a token you can rotate on its own.
- Read calls only. The connection issues read calls for domain, keyword and backlink data. Your Ahrefs projects, alerts and saved reports are not modified.
- Revocable at any time. Delete the token in Ahrefs under Settings, API, and the connection stops working immediately.
- Scoped direct-MCP retention. CorpusIQ uses read-only access for direct MCP live retrieval. It does not retain raw customer files or full connector response payloads; operational logs retain query text, per-user tool-call metadata, and bounded outcome summaries for up to 30 days.
Comparison: Ahrefs dashboards vs Ahrefs Through Claude¶
| Question | Ahrefs dashboard | CorpusIQ MCP with Claude |
|---|---|---|
| Input | A report and a domain picker | A question in plain language |
| Output | Tables and charts to read | A direct answer with the metrics behind it |
| Multi-domain comparison | Export and line up by hand | One comparison answer |
| Keyword gap analysis | Manual set arithmetic | Asked as a sentence |
| Write access | Project and report edits | None exposed to the assistant |
Ahrefs is where the data lives. Claude is where the question gets answered.
FAQ: Common Questions¶
Do I need a specific Ahrefs plan?
API access requires an Advanced plan or higher. Without it the token is refused by Ahrefs and the connector cannot read data.Does every question spend API rows?
Yes. Each question issues the API calls needed to answer it, so narrower questions cost less. CorpusIQ reads only what the question requires.Can Claude see keyword and backlink data for any domain?
It can read whatever your Ahrefs plan entitles the token to read, including domains outside your own account, subject to your plan limits.Can Claude change my Ahrefs projects?
No. The connection is read-only for the documented reports. Projects, alerts and saved reports stay untouched.How current is the data?
Ahrefs refreshes on its own crawl schedule, and CorpusIQ reads the data available when you ask. Very new domains can lag until Ahrefs indexes them.Can I use this for client reporting?
Yes. The answers are drawn from the same account data you would export, with the domain and metric named so the source is checkable.Next steps: Connect Ahrefs to Claude now
Part of the MCP knowledge base at corpusiq.io - connect 40+ business tools to AI.
See also¶
- Connect Ahrefs to Perplexity - domain ratings and keyword footprints inside a Perplexity thread.
- Connect Ahrefs to ChatGPT - backlink and keyword research inside a ChatGPT thread.
- Ahrefs connector reference - connection requirements, visible data and troubleshooting.
This Hermes repo is one of the largest structured collections of public AI, automation, business, and technology documentation. Content remains attributed to original authors and repositories. Indexed and organized by www.CorpusIQ.io.