Ahrefs MCP
Analyze backlinks, organic search performance, keywords, competitors, rankings, and other SEO data through Ahrefs' hosted MCP server.
Verdict
Common use cases
- Compare backlink profiles of three competitors
- Check domain authority before outreach
- Pull keyword difficulty for content briefs
- Audit broken links across site sections
- Track ranking changes for target keywords
Integration
- Vendor
- Ahrefs MCP
- Category
- developer-tools
- Auth
- OAUTH2
- Composio slug
ahrefs_mcp
Tools
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Search for 'Ahrefs MCP' and click Connect. 3. You'll be redirected to Ahrefs to authorize access — log in with your Ahrefs account credentials. 4. Grant read permissions for site explorer, keywords explorer, and site audit data when prompted. 5. After authorization, Switchy redirects you back and confirms the connection is live. 6. Open any Project and type '@Ahrefs' followed by a question like 'What's the domain rating for example.com?' to test. 7. The MCP responds with current metrics pulled from your Ahrefs subscription. 8. If you see an error, verify your Ahrefs plan includes API access and that your token hasn't expired in workspace settings.
What teammates see: by default, memories from Ahrefs MCP are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Domain Authority Check
@Ahrefs What's the domain rating and referring domains count for techcrunch.com? Include the organic traffic estimate.
Competitor Backlink Gap
@Ahrefs Show me the top 10 domains linking to competitor1.com and competitor2.com but not to mysite.com.
Keyword Difficulty Research
@Ahrefs What's the keyword difficulty and monthly search volume for 'project management software for startups'?
Broken Link Audit
@Ahrefs Run a crawl of mysite.com and list all pages with broken outbound links, grouped by HTTP status code.
Content Gap Analysis
@Ahrefs Compare the top 20 organic keywords for competitor.com against mysite.com and highlight gaps where they rank in the top 10 and we don't.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@ahrefs show me the top 10 organic keywords driving traffic to example.com and their current rankings
Based on Ahrefs data, example.com's top organic keywords include 'project management software' (position 3, ~8.2K monthly searches), 'team collaboration tools' (position 7, ~5.1K searches), and 'agile workflow app' (position 12, ~2.8K searches). The remaining seven keywords span positions 5-18 with search volumes between 900-4,500 monthly queries. Total estimated organic traffic from these ten keywords is approximately 12,400 visits per month. Note: Rankings and traffic estimates reflect the most recent Ahrefs crawl, typically updated within 48-72 hours.
This example demonstrates keyword research capabilities. Requires OAuth2 authorization with read access to the Site Explorer API. Ahrefs enforces rate limits based on your subscription tier — enterprise accounts get higher quotas. Data freshness depends on Ahrefs' crawl schedule for the target domain.
@ahrefs analyze the backlink profile for competitor.io and identify their strongest referring domains by domain rating
Competitor.io has 847 referring domains with a total of 12,340 backlinks. Top referring domains by Domain Rating: techcrunch.com (DR 93, 4 backlinks), producthunt.com (DR 91, 2 backlinks), github.com (DR 96, 1 backlink), and medium.com (DR 95, 8 backlinks). The majority of high-authority links point to their blog and product pages. Approximately 68% of referring domains are dofollow. This analysis covers backlinks discovered in Ahrefs' index as of the last crawl cycle.
Showcases competitive analysis through backlink intelligence. This read-heavy query pulls from Ahrefs' massive link index but won't capture links discovered after their last crawl. Useful for understanding competitor SEO strategies, though interpreting Domain Rating requires context about your own site's profile.
@ahrefs compare the content gap between our site and the top 3 competitors for 'API documentation tools' — what keywords are they ranking for that we're missing?
Content gap analysis for 'API documentation tools': Your competitors rank for 142 keywords where your site has no presence. High-opportunity gaps include 'REST API documentation generator' (competitor avg. position 4, 1.9K searches), 'OpenAPI spec tools' (position 6, 1.2K searches), and 'developer portal examples' (position 8, 890 searches). These keywords align with your existing content themes but target adjacent use cases. Competitors are capturing an estimated 8,700 monthly visits from these gap keywords. Consider this a starting point for content strategy — manual review of search intent is recommended before production.
This synthesis example combines Ahrefs data with strategic reasoning. The MCP identifies ranking gaps, but the AI adds editorial judgment about opportunity and intent alignment. Requires access to both your site's data and competitor domains. Content gap analysis is most valuable when you validate the keywords against your actual product capabilities.
Use-case deep-dives
When Ahrefs MCP fits a 3-person content sprint
A 3-person content team runs weekly sprints to close keyword gaps against competitors. They need to pull backlink profiles, compare domain authority, and spot content opportunities without leaving their workspace. Ahrefs MCP works here if the team already subscribes to Ahrefs and wants to skip the browser tab shuffle during planning sessions. The OAuth2 flow means each writer authenticates once, then queries competitor data inline while drafting briefs. The threshold: if your team only checks SEO metrics once a month, the setup overhead outweighs the benefit—stick with the Ahrefs dashboard. If you're running daily content standups and need live rank tracking or backlink alerts in chat, this MCP turns Ahrefs into a first-class participant in your workflow.
Why agencies with 8+ clients hit the MCP ceiling fast
A 6-person agency manages SEO for 12 clients and needs to pull monthly rank reports, backlink summaries, and keyword movement into client decks. Ahrefs MCP could automate the data fetch, but the OAuth2 model means each team member authenticates separately—there's no shared service account. If your agency workflow depends on one person running all reports from a single Ahrefs login, the MCP adds friction instead of removing it. The win case: teams where each account manager owns their own Ahrefs seat and wants to query client data during live calls or Slack threads. If you're centralizing reporting through one power user, the browser extension or API scripts are faster. The MCP shines when decentralized access matters more than batch automation.
When dev teams use Ahrefs MCP for docs planning
A 4-person developer relations team writes API docs and integration guides. They want to know which search terms developers actually use before titling pages or structuring navigation. Ahrefs MCP lets them query keyword volume and SERP features without context-switching during the outline phase. The setup works if the team treats docs like a content product—planning sprints around search intent, not just feature parity. The boundary: if your docs are purely reference material with no SEO goal, Ahrefs data won't change your structure. If you're competing for "how to integrate [your API]" traffic against Stack Overflow and competitor docs, the MCP brings keyword research into the same workspace where you draft and review. One OAuth2 login per writer, then query inline during planning calls.
Frequently asked
What does the Ahrefs MCP do in Switchy?
The Ahrefs MCP connects your team's Ahrefs account to Switchy's AI workspace, letting agents query backlink data, keyword rankings, and site audits without leaving the conversation. Your team can ask questions about competitor analysis or SEO metrics and get answers pulled directly from Ahrefs, instead of switching tabs to run manual reports.
Do I need an Ahrefs admin account to set up OAuth?
You need an Ahrefs account with API access, which typically requires a paid subscription at the Standard tier or higher. During OAuth setup, Ahrefs will ask you to authorize Switchy to read your workspace data. If your team uses a shared Ahrefs login, the person who connects it controls which projects Switchy can access.
Can the Ahrefs MCP trigger new site audits or backlink crawls?
No, the MCP is read-only by design. It pulls existing data from your Ahrefs account — keyword positions, backlink profiles, domain ratings — but it won't start new crawls, update projects, or change settings. If you need to kick off a fresh audit, do that in Ahrefs directly, then query the results through Switchy.
Why use the MCP instead of just opening Ahrefs in a browser?
The MCP lets your team ask natural-language questions and get structured answers without learning Ahrefs' interface. Instead of exporting CSV files and pasting them into Slack, you ask the AI agent to compare two domains or summarize ranking changes, and it handles the API calls. Faster for ad-hoc questions; Ahrefs stays better for deep exploratory work.
Does connecting Ahrefs count against my Switchy seat limit?
No. MCP connections are workspace-level resources, not user seats. Once someone on your team connects Ahrefs via OAuth, any Switchy member with access to that workspace can query it through the AI. You're only limited by your Ahrefs subscription's API rate limits, not by Switchy's pricing tiers.