Ahrefs MCP integration for AI agents.
Connect AI agents to Ahrefs through 4 structured actions, including get keywords overview, get limits and usage, and get site explorer metrics. Review authen…
- ACTION CONTRACTS
- 4
- AUTHENTICATION
- API key
- SOURCE STATUS
- Provider-backed
CATALOG SOURCE REVIEWED AUGUST 23, 2026 / ACTION NAMES AND SCHEMAS DERIVED FROM WORKING MACHINES PROVIDER SOURCE
CAPABILITY PROFILE
What the Ahrefs integration exposes
The Ahrefs Agent App exposes 4 provider-backed actions for marketing and data work. Its current contract lets an authorized agent retrieve keywords explorer overview rows for keywords, a target, or a keyword list, retrieve ahrefs api subscription limits and current usage, and retrieve site explorer metrics for a domain or url. These operations are called through Working Machines as typed capabilities rather than through browser navigation or copied UI steps.
A connection uses API key. Before execution, the agent can inspect the selected action, its required fields, declared scopes, and expected output contract. Provider credentials remain inside the Working Machines runtime; the calling agent receives the capability and its structured result, not the underlying secret.
For reliable operation, start with the narrowest action that satisfies the task, resolve stable provider identifiers before changing state, and validate the returned object or status after execution. Availability still depends on the connected Ahrefs account, granted provider permissions, workspace policy, region, plan, and upstream API behavior.
VERIFIED ACTION SAMPLE
Real Ahrefs capabilities.
Showing 4 of 4 actions. Risk labels are conservative signals based on operation names, not substitutes for provider documentation or runtime policy.
get_keywords_overviewREADRetrieve Keywords Explorer overview rows for keywords, a target, or a keyword list.
INPUTS: country / select / keywords / target / targetMode
get_limits_and_usageREADRetrieve Ahrefs API subscription limits and current usage.
get_site_explorer_metricsREADRetrieve Site Explorer metrics for a domain or URL.
INPUTS: target / date / mode / country / protocol
get_site_explorer_metrics_by_countryREADRetrieve Site Explorer metrics grouped by country for a domain or URL.
INPUTS: target / date / mode / select / protocol
INPUT CONTRACTS
Know what the action needs before it runs.
get_keywords_overview
countryREQUIRED- Two-letter country code in ISO 3166-1 alpha-2 format.
selectREQUIRED- Comma-separated list of columns to return.
keywordsOPTIONAL- Comma-separated list of keywords to show metrics for.
targetOPTIONAL- Domain or URL used to filter keyword data.
targetModeOPTIONAL- Scope of the Ahrefs target search.
get_site_explorer_metrics
targetREQUIRED- Domain or URL to analyze with Ahrefs.
dateREQUIRED- Date to report metrics on in YYYY-MM-DD format.
modeOPTIONAL- Scope of the Ahrefs target search.
countryOPTIONAL- Two-letter country code in ISO 3166-1 alpha-2 format.
protocolOPTIONAL- Protocol filter for the target.
get_site_explorer_metrics_by_country
targetREQUIRED- Domain or URL to analyze with Ahrefs.
dateREQUIRED- Date to report metrics on in YYYY-MM-DD format.
modeOPTIONAL- Scope of the Ahrefs target search.
selectOPTIONAL- Comma-separated list of columns to return.
protocolOPTIONAL- Protocol filter for the target.
PROVIDER-SPECIFIC WORKFLOWS
Jobs this Agent App can support
Inspect Get Keywords Overview
Retrieve Keywords Explorer overview rows for keywords, a target, or a keyword list. Use this as a bounded discovery step, retain the returned identifier, and avoid expanding the read beyond the task's stated scope.
get_keywords_overviewVerify with Get Limits And Usage
Retrieve Ahrefs API subscription limits and current usage. Compare the returned provider state with the intended outcome and preserve stable IDs or canonical links in the run record.
get_limits_and_usageSAFETY BOUNDARY
Operate Ahrefs with explicit limits
- Authorize Ahrefs with API key and grant only the provider access required by the selected actions.
- The current action names appear read-oriented, but returned Ahrefs data may still be sensitive and should be minimized before it enters model context.
- Do not infer permission from catalog visibility. Workspace policy, connection identity, and upstream authorization still govern execution.
- No provider scope string is declared on the sampled actions. Verify the connected account's actual permissions in Ahrefs rather than assuming unrestricted access.
- After a call, inspect the structured result and execution record before reporting that the Ahrefs task completed successfully.
CONNECTION MODEL
API key
Ahrefs API key used as a Bearer token. Create or manage API keys in Account settings / API keys after signing in: https://docs.ahrefs.com/en/api/docs/api-keys-creation-and-management.
Working Machines stores provider credentials behind the execution boundary. An agent can use an authorized connection identity, but catalog discovery alone does not reveal OAuth tokens, API keys, or provider secrets.
- READ SIGNALS
- 4
- WRITE SIGNALS
- 0
- HIGH IMPACT
- 0
- REVIEW SIGNALS
- 0
EVIDENCE AND AVAILABILITY
Provider reference
Action names, input fields, authentication types, and counts on this page are generated from the Working Machines provider catalog. Provider behavior, quotas, object semantics, account eligibility, and regional availability remain governed by Ahrefs.