Plug Ahrefs into your assistant
If you already pay for Ahrefs and spend too long exporting tables for clients, plug it in: your assistant queries keywords, links and rankings for you. Every question draws on your plan's units, so keep requests short and precise.
In Ahrefs, your assistant can read, edit and delete your data. Plans: on Lite, Standard, Advanced and Enterprise plans, not on the free one. Connecting takes one click from Claude or ChatGPT.
Official, published by Ahrefs · checked on 16 November 2026
What changes for you
Everyday situations, and what to write to your assistant.
Client report
The monthly report, no export needed.
Using Ahrefs, which keywords did the Martin bakery's site gain or lose rankings on this month? Keep the ten that matter most.
Competitor links
A list of sites to pitch.
Using Ahrefs, which sites link to my client's two main competitors but never to my client?
Article ideas
Topics built on real searches.
Using Ahrefs, find what people search for before buying a coffee table and suggest five blog topics for my client.
From one freelancer to another
Ahrefs is a gold mine… with a meter at the entrance. Plugging in your assistant hands it the pickaxe: it digs into a client's keywords, a competitor's links, this month's rankings, and gives you an answer you can read. But every swing is paid for in units, and one overly broad question can take a real bite out of your monthly allowance. Here is how to dig in the right spot.
What works
Start with “Using Ahrefs”
Otherwise the assistant may search the web instead of your data. Ahrefs itself recommends this, especially in ChatGPT.
Source: ahrefs.comA number, a time range
“The top ten keywords since last month” rather than “all my keywords”: the answer is sharper and the unit bill lighter.
Source: help.ahrefs.comA small sample is often enough
One user who combed through their logs found that a short keyword list led to the same conclusion as a long one, for far fewer units. Widen only if it changes your decision.
From user reports · studiomeyer.ioA starting point, not a verdict
Ahrefs warns that the assistant can make things sound simpler than they are. Check the key figures in Ahrefs before they go into a client report.
Source: ahrefs.com
Where it falls short
An API key isn't an MCP key
A 401 error often comes from an API key pasted instead of the MCP key, an expired key or a lapsed subscription. Workaround: generate an MCP key in Ahrefs, or use your assistant's official connector, which handles sign-in for you.
Source: help.ahrefs.comThe meter that runs away
One user reports that three tools, including link lists and keyword ideas, ate most of their units. Workaround: cap the number of results, estimate before a big batch, and watch your usage in your Ahrefs account settings.
From user reports · studiomeyer.ioResults cut off silently
Your plan caps the rows per request: an overly broad question gets truncated, not refused. Workaround: split by country, time range or top N, and sanity-check totals before drawing conclusions.
From user reports · aitoolsreview.co.uk
Plug in Ahrefs
Pick your assistant: the steps follow.
You need a paid Ahrefs plan.
Open Ahrefs's page in Claude's directory and add the connector.
Open in ClaudeConnect your Ahrefs account and read the access requested.
Check it by asking:
Which keywords did my site move up for this month?
Depending on your plan. Your unit allowance and rows per request grow with the plan: 200,000 units and 100 rows on Lite.
Stay in control
The assistant never has more rights than your account.
Your safeguards
Each request has a cost
Each request uses at least 50 API units, shared with the Ahrefs API: ask for short results.
What it can do
Ahrefs does not publish a readable tool list at the moment (its documentation pages return errors).
| Action | Identifier |
|---|---|
| Deletes data | |
| Delete social media posts. | |
| Edits your data | |
| Create and edit social media posts. | |
| Read onlyNo effect on your data | |
| Read SEO data: keywords, backlinks, rankings. | |
Our view
Useful if
You pay for Ahrefs and track the search rankings of your site or your clients' sites.
Less useful if
You don't have a paid plan: the server is only available on paid plans.