Ahrefs Platform Help

Step 1 — Gather context

If references/learnings.md exists, read it first for accumulated platform knowledge.

1. What are you trying to do?

   • A) Build an API integration — pull backlinks, organic keywords, Domain Rating, rank data
   • B) Set up the MCP server so Claude/ChatGPT can query your Ahrefs account by prompt
   • C) Fix API units / monthly credits running out, overage fees, or "suspicious activity" throttling
   • D) Migrate a dead v2 integration to v3
   • E) Pick/understand a plan — Starter vs Lite vs Standard vs Advanced vs Enterprise; the credit + API-unit model
   • F) Use a specific tool — Site Explorer, Keywords Explorer, Rank Tracker, Site Audit, Content Explorer, Brand Radar

2. REST or MCP? Scheduled pipelines/exports → REST API (tight select). Ad-hoc agent questions → the MCP server. Both spend the same API units.

Skip-ahead rule: if the user's prompt already provides enough context, skip to Step 2.

Step 2 — Route or answer directly