Dome Systems
Dashboard
DocsLearnHands-on LabsTemplatesHelpChangelogCLIAPIMCPSDKs

Ask questions about Ahrefs

A read-only managed agent for Ahrefs SEO data.

User
Caller
  • chat
App
Agent
  • ahrefs-answerer
Governance
Gateway
  • ahrefs-readonly
Pool

ahrefs-answerer-pool

  • ahrefs-answerer-model
Tools

ahrefs

    What this template gives you

    • Interface

      A chat window, in your browser

      Use the included interface to send a request to this template.

    • Gateway

      ahrefs-readonly gateway

      This template sends its requests through ahrefs-readonly gateway, where its access rules and limits apply.

    • Model

      ahrefs-answerer-model

      This template uses ahrefs-answerer-model through the ahrefs-answerer-pool pool.

    Usage

    Hand this template to an AI agent to set up this template

    Node.js and npm to run npx.

    Dome CLI, installed with brew install dome-systems/tap/dome, then signed in with dome auth login.

    Docker Compose to run the companion app locally.

    1. 1

      Create a workspace

      dome workspaces create --name <workspace-name>

      The CLI creates and selects a workspace context for you.

    2. 2

      Confirm the workspace context

      dome context list

      The workspace you just created is already selected.

    3. 3

      Pull the template

      npx @domesystems/templates pull dome-systems/ai-agent-for-ahrefs@0.1.0 --dir ai-agent-for-ahrefs

      Downloads this immutable release and verifies its digest.

    4. 4

      Run the template

      npx @domesystems/templates up --dir ai-agent-for-ahrefs

      Imports it into Dome and starts the companion app.

    Dome import variables

    npx @domesystems/templates up imports the template into Dome and prompts for required values. For unattended runs, set them as DOME_IMPORT_VAR_… environment variables.

    Required values

    • DOME_IMPORT_VAR_anthropic_api_key

    Setup guide

    Follow this template's setup guidance for agent variables and upstream connections.

    # Connect Ahrefs

Ahrefs' hosted MCP server is read-only, and each request consumes API units.
It is available on Ahrefs Lite and higher plans. Use the official
[Ahrefs MCP guide](https://docs.ahrefs.com/en/mcp/docs/introduction) for the
current endpoint, plan limits, and vendor-specific setup details.

## Recommended: OAuth consent

OAuth is the normal way to connect an Ahrefs account to an MCP-compatible AI
client. Ahrefs creates a dedicated API key with the `MCP` scope after consent.

Start the shared Ahrefs OAuth connection after importing this template, sign in
to the intended account, and approve the consent screen. Confirm that the
resulting connection appears in Ahrefs' API keys report; workspace
administrators can adjust its per-key API-unit limit there. Then test with
“Show the top organic pages for example.com” or “What are the remaining API
limits?”

OAuth-created MCP keys default to a 200,000 monthly API-unit limit per key.
The workspace plan limit still applies.

## Alternative: Manually generated MCP key

Use this option when a shared, non-interactive connection is required.

- In Ahrefs, generate an MCP key for the intended account.
- In Dome, create a separate API key/token tool connection instead of using
  this OAuth template.
- Send the static credential as `Authorization: Bearer <MCP key>`.
- Keep the value out of source control and local `.env` files, and rotate or
  revoke it in Ahrefs when access should end.

## Alternative: Enterprise API key

Enterprise customers can connect with an Ahrefs API key instead. Create a
separate API key/token tool connection and send
`Authorization: Bearer <API key>`. API keys and MCP keys are not
interchangeable, so use the credential type appropriate to the selected flow.

    Runtime environment

    These variables are required to run the agent. During pull, .env.example is copied to .env when available. If they’re missing, npx @domesystems/templates up retrieves them from Dome and saves them in .env. Pass --provision to refresh them.

    No .env.example is included in this release.

    Agent instructions

    Use Ahrefs only to answer SEO and search-performance questions. Be economical:
queries consume API units. Use the available read tools and report uncertainty
and coverage limits. Do not perform actions outside the connected Ahrefs data.