Official Ahrefs MCP server that lets AI agents securely access Ahrefs SEO data, site metrics, keyword research, and competitor analysis through the Ahrefs API.
Hermes is Nous Research's command-line agent. MCP servers are declared in its YAML config and reloaded without a restart.
This guide connects Ahrefs MCP to Hermes through MewCP, so Hermes can use Ahrefs MCP's 135 tools, like site-explorer-organic-competitors, social-media-activity-history and site-explorer-crawled-pages, without your Ahrefs MCP credentials ever reaching the app.
Ahrefs MCP signs in through managed OAuth. MewCP stores the token encrypted, refreshes it before it expires and injects it only at call time. Your agent never holds it, so it can never leak it.
More apps
Manage your Google Business Profile, business information and customer engagement. Update listings, publish content, monitor reviews and maintain your local presence across Google services.
Full Google Search Console control for search analytics, sitemaps, sites, and URL inspection, directly from your AI workflows. This MCP server exposes the Google Search Console API for querying search traffic data, managing sitemaps and site properties, and inspecting the indexing status of any URL. It is built for SEO teams monitoring search performance, developers automating sitemap and property management, and analysts pulling search traffic data into reporting pipelines.
Brevo's marketing and CRM platform — manage contacts, lists and segments, send transactional and campaign email, run SMS and WhatsApp campaigns, and track deals and companies
Meta Ads connects AI agents to Facebook and Instagram advertising accounts to analyze campaign performance, create and edit campaigns, ad sets and creatives, manage custom audiences and product catalogs, inspect conversion tracking signals, run A/B tests, and investigate advertising issues.
Other clients
Ahrefs MCP works the same way in every client below. Pick yours for its own guide.
Free to start.
Scope access to the exact Ahrefs MCP tools and accounts you allow, work and personal side by side. Anything outside that scope is refused at call time, even when the model asks for it.
Each call is logged: what ran, on which account, and whether it worked. Failures come back structured, so the agent knows whether to retry instead of guessing.
Every app sits behind one secure MCP URL, and there is no server for you to deploy or keep running. Add an integration in the dashboard and it is live on the next call, with no config to change and no new credentials to wire up. Tools load only when a task needs them, so your agent stays fast and focused however many apps you connect.
Edit config.yaml in your Hermes config directory (~/.hermes).
Put this under the top-level "mcp_servers:" key.
Run /reload-mcp in Hermes, or start a fresh session. Sign in when the browser window opens.
Start a new chat and ask: "List the tools you can use from MewCP." You should see your connected apps.
Retrieves a list of organic search competitors for a specified website or URL, providing comparative SEO metrics such as common keywords, traffic estimations, and domain strength for a chosen country and date. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Get the activity history log for posts (published, scheduled, failed, etc.). Use doc tool first to get the real input schema.
Returns a list of pages crawled by Ahrefs for a specified domain or URL, including the page URLs. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Returns time-series chart data grouped by source channel (e.g., organic, paid, social, direct) for a Web Analytics project, showing metrics over time. Use doc tool first to get the real input schema.
Returns an overview of the top search results (SERP) for a specified keyword and country, including detailed metrics about each result like position, backlinks, traffic, domain rating, and related keywords. Requests will not consume API units if you use only "ahrefs" or "wordcount" in the `keywords` or `keyword` query parameter. Use doc tool first to get the real input schema.
Provides historical data on referring domains linking to a specified target (domain or URL) over a defined date range, with customizable grouping and analysis scope. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Returns Google Search Console click metrics grouped by country for a project. Use doc tool first to get the real input schema.
Full documentation for Ahrefs API v3 and the corresponding MCP tools. You must use this tool to get the input schema for any other tool. The documentation is returned in OpenAPI format. It can be used to craft a request to the API v3 directly, or to the MCP server. Online documentation for the Ahrefs API v3 is also available at https://docs.ahrefs.com/docs/api/reference/introduction
Retrieves subscription information including limits and usage statistics for API units, workspace quotas, and API key details. This endpoint is free and does not consume any API units. Use doc tool first to get the real input schema.
Returns visitor data grouped by browser language for a Web Analytics project, showing visitor counts for each language. Use doc tool first to get the real input schema.
Returns visitor data grouped by country for a Web Analytics project, showing visitor counts for each location. Use doc tool first to get the real input schema.
Retrieves a site's or page's internal link metrics, allowing analysis of how pages within the given domain or URL are interconnected and which pages receive the most internal links. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Returns Google Search Console performance metrics (clicks, impressions, keyword count) grouped by position ranges (1-3, 4-10, 11-20, 21-50, 51+) for a project. Use doc tool first to get the real input schema.
Returns traffic grouped by source channel (e.g., organic, paid, social, direct) for a Web Analytics project, including visitor counts, bounce rates, and session durations. Use doc tool first to get the real input schema.
Returns all issues from your Site Audit crawl. By default, it provides data from the latest available crawl, but you can also specify a crawl date and time to retrieve historical metrics. Use doc tool first to get the real input schema.
Provides an overview of competitor domains and their share of voice for a specified project and date in Ahrefs Rank Tracker, allowing comparison between current and previous data. Use doc tool first to get the real input schema.
Provides an overview of competitor metrics for a specified project and date in Ahrefs Rank Tracker. Metrics include: share of voice, share of traffic value, average position, traffic, traffic value, and positions, and counts of SERP features. Use doc tool first to get the real input schema.
Returns time-series chart data grouped by a specified UTM param for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time. Use doc tool first to get the real input schema.
Returns time-series chart data grouped by referrer for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time. Use doc tool first to get the real input schema.
Returns time-series chart data grouped by continent for a Web Analytics project, showing visitor counts over time for each region. Use doc tool first to get the real input schema.
Provides the pages cited in AI-generated responses that mention your brand or competitors' brands in an LLM you specify, including how many responses referenced each page (broken down by brand) and estimated monthly search volume where each page was mentioned. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.
Returns operating system statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by OS. Use doc tool first to get the real input schema.
Returns the most visited pages for a Web Analytics project, including pageview counts, visitor counts, bounce rates, and average page visit durations. Use doc tool first to get the real input schema.
Provides questions asked to AI assistants and the corresponding AI-generated responses that mention your brand or competitors’ brands, including cited sources and search volume estimates. Prefer using the equivalent 'brand-radar-ai-responses-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.
Returns time-series chart data grouped by OS version for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time. Use doc tool first to get the real input schema.
Retrieves the historical URL rating data for a specified domain or URL over a defined date range, grouped by a chosen time interval. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Retrieves keywords from a keyword list. Requests to this endpoint are free and do not consume any API units. Use doc tool first to get the real input schema.
Returns the IP ranges used by the Ahrefs public web crawler, typically for allowlisting or firewall configuration. Use doc tool first to get the real input schema.
Provides SEO performance metrics for a specified domain, URL, or site section as of a given date, with options to customize search scope, protocol, country, and search volume mode. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Retrieves detailed information about referring domains that link to a specified target domain or URL, with flexible filtering, selection, and sorting of backlink-related metrics. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Get historical follower count data for connected channels. Use doc tool first to get the real input schema.
Retrieves detailed information about all backlinks pointing to a specified URL or domain, with extensive filtering, sorting, selection, and aggregation options. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Returns historical totals of search volume for keywords that the specified domain or URL ranks for in the top 10 or top 100 results, across all countries or for a specified country. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Retrieves data about external anchor text (the clickable words in outbound links) used on a specified domain, subdomain, or URL, including metrics like dofollow link counts, distinct linked domains, and other attributes about the links. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Retrieves internal anchor text data for a given website or URL, detailing how anchor texts are used in links between pages on the same site. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Retrieves detailed organic keyword data for a given domain, URL, or path, including rankings, search intent, SERP features, traffic and CPC metrics, with the ability to filter, sort, and compare metrics across dates and regions. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Returns browser statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by browser. Use doc tool first to get the real input schema.
Retrieves the domain rating for a specified domain or URL as of today. Use doc tool first to get the real input schema.
Returns all tracked keywords for a specific Rank Tracker project, including associated tracking metadata. Use doc tool first to get the real input schema.
Retrieves a list of management locations filtered by country code and optionally by US state. Use doc tool first to get the real input schema.
Returns organic keywords that rank for the project but are not reported by Google Search Console (anonymized queries), with position, traffic, volume, and CPC data. Use doc tool first to get the real input schema.
Returns Google Search Console performance chart data (clicks, impressions, CTR, position) for a project over time, grouped by daily, weekly, or monthly intervals. Use doc tool first to get the real input schema.
Render a scorecard widget showing key metrics as a card grid. Accepts metric cards with labels, raw numeric values, optional unit, optional change indicators, and optional grouping. IMPORTANT: 'value' is a raw number (e.g. 1234567 not '1,234,567' or '1.2M'); the frontend handles all display formatting. Use 'unit' for symbols: '$' for currency, '%' for percentages, 's' for duration in seconds (rendered as e.g. '11m 27s'). Monetary values are in USD cents (not dollars), make sure to divide them by 100 first such that they are displayed in USD. Omit 'value' or pass null for N/A. Change indicators: change.value is a positive number (the percentage amount, e.g. 12.4 for a 12.4% change); change.direction is 'up' or 'down'. When there are more than 4 cards, use the 'group' field to organize them into logical sections (e.g. 'Organic' and 'Paid'). Always include the source field when the data came from an Ahrefs tool call. Set source.tool to the bare tool name without any connector or namespace prefix (e.g. 'site-explorer-metrics' not 'my-connector:site-explorer-metrics'), and source.params to the arguments you passed, to generate an 'Open in Ahrefs' link.
Returns the HTML and extracted text content of a page from your Site Audit crawl. By default, it provides the latest available snapshot, but you can also specify a crawl date and time to retrieve historical snapshots. You can choose to pull raw HTML, rendered HTML, or page text. The endpoint is available only for projects with verified ownership. Use doc tool first to get the real input schema.
Provides the historical number of impressions for your and competitors's brands in an LLM you specify. Prefer using the equivalent 'brand-radar-impressions-history-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.
Returns a list of the top-performing pages for a specified website or URL, including detailed SEO metrics (such as organic rankings, traffic, top keyword, and changes over time), with support for comparison between two dates and flexible filtering. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
List social media channels with their connection status and metadata. Use doc tool first to get the real input schema.
Returns Google Search Console keyword count data grouped by position ranges (1-3, 4-10, 11-20, 21-50, 51+) over time for a project. Use doc tool first to get the real input schema.
Returns Google Search Console pages chart data showing total indexed pages over time for a project. Use doc tool first to get the real input schema.
Returns time-series chart data grouped by country for a Web Analytics project, showing visitor counts over time for each location. Use doc tool first to get the real input schema.
Retrieves historical data on key organic and paid search traffic and cost metrics for a specified domain, URL, or path over a selectable date range and grouping interval. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Provides the number of mentions for your and competitors's brands in an LLM you specify, with filters for locations, query text, URL, and more. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.
Analyse the pages currently ranking for a keyword and return the core topics they cover, with per-page coverage scores and supporting extracts. Use it to find what a piece of content about this keyword needs to cover. The analysis is generated on demand and takes a few seconds on a keyword that has not been analysed recently. Use doc tool first to get the real input schema.
Provides the historical number of citations for your and competitors' brand URLs in an LLM you specify. Every entity provided in `brands` (and `competitors`, when applicable) must include at least one value in `url_groups`. Entities consisting only of `names` are not supported here because citations are matched against URL groups. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.
Returns statistics for a specified UTM paramater for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by utm_source. Use doc tool first to get the real input schema.
Returns time-series chart data grouped by city for a Web Analytics project, showing visitor counts over time for each location. Use doc tool first to get the real input schema.
Returns time-series chart data grouped by browser for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time. Use doc tool first to get the real input schema.
Returns detailed information about pages discovered in a Site Audit project, including URLs, crawl metadata, and selected on-page metrics. Use doc tool first to get the real input schema.
Returns browser version statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by browser version. Use doc tool first to get the real input schema.
Retrieves historical data about pages from a specified domain, URL, or section of a site, grouped by a chosen time interval. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Retrieves search volume metrics for a specified keyword broken down by country. Requests will not consume API units if you use only "ahrefs" or "wordcount" in the `keywords` or `keyword` query parameter. Use doc tool first to get the real input schema.
Retrieves information about existing projects, including ownership, access type, presence of Rank Tracker keywords, and project ID. Use doc tool first to get the real input schema.
Returns the distribution of pages by estimated organic traffic buckets for a specified domain or URL, across all locations or for a specified country. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Returns SERP overview for a specified keyword in a Rank Tracker project, showing detailed information about each position including title, URL, type, backlink metrics, and traffic data. Use doc tool first to get the real input schema.
Retrieves the list of competitors associated with a specific Rank Tracker project in Ahrefs, using the project's unique identifier. Use doc tool first to get the real input schema.
Returns time-series chart data grouped by operating system for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time. Use doc tool first to get the real input schema.
Returns device type statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by device type. Use doc tool first to get the real input schema.
Returns detailed metrics about pages on a specified site or URL that are ranking in paid search results, including traffic, keyword data, ad presence, and changes over time, with powerful filtering and comparison capabilities. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Returns time-series chart data grouped by browser version for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time. Use doc tool first to get the real input schema.
Provides domains cited in AI-generated responses that mention your brand or competitors' brands in an LLM you specify, including how many responses referenced each domain (broken down by brand) and estimated monthly search volume where each domain was mentioned. Prefer using the equivalent 'brand-radar-cited-domains-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.
Returns referrer statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by referrer URL. Use doc tool first to get the real input schema.
Retrieves the historical domain rating data for a specified domain or URL over a defined date range and grouping interval. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Provides domains cited in AI-generated responses that mention your brand or competitors' brands in an LLM you specify, including how many responses referenced each domain (broken down by brand) and estimated monthly search volume where each domain was mentioned. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.
Provides an overview of tracked keyword rankings and related search metrics for a specified project and date, with support for historical comparison, filtering, column selection, and device type. Use doc tool first to get the real input schema.
Provides the historical number of mentions for your and competitors's brands in an LLM you specify. Prefer using the equivalent 'brand-radar-mentions-history-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.
Provides the number of impressions for your and competitors's brands in an LLM you specify, with filters for locations, query text, URL, and more. Prefer using the equivalent 'brand-radar-impressions-overview-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.
Provides the number of citations for your and competitors's brands in an LLM you specify, with filters for locations, query text, URL, and more. Every entity provided in `brands` (and `competitors`, when applicable) must include at least one value in `url_groups`. Entities consisting only of `names` are not supported here because citations are matched against URL groups. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.
Returns entry page statistics for a Web Analytics project, showing which pages visitors land on first, including visitor counts and entry rates. Use doc tool first to get the real input schema.
Provides questions asked to AI assistants and the corresponding AI-generated responses that mention your brand or competitors’ brands, including cited sources and search volume estimates. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.
List social media posts with filtering by channel, status, and author. Use doc tool first to get the real input schema.
Retrieves historical search volume data for a specified keyword within a given country and date range. Requests will not consume API units if you use only "ahrefs" or "wordcount" in the `keywords` or `keyword` query parameter. Use doc tool first to get the real input schema.
Provides the historical share of voice for your and competitors's brands in an LLM you specify. Prefer using the equivalent 'brand-radar-sov-history-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.
Provides an overview of competitor pages and keyword metrics for a specified project and date in Ahrefs Rank Tracker, allowing comparison between current and previous data. Use doc tool first to get the real input schema.
Provides the pages cited in AI-generated responses that mention your brand or competitors' brands in an LLM you specify, including how many responses referenced each page (broken down by brand) and estimated monthly search volume where each page was mentioned. Prefer using the equivalent 'brand-radar-cited-pages-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.
Returns Google Search Console performance metrics (clicks, impressions, CTR, position) broken down by device type (desktop, mobile, tablet) for a project. Use doc tool first to get the real input schema.
Returns the list of individual IP addresses currently used by the Ahrefs public web crawler. Use doc tool first to get the real input schema.
Returns exit page statistics for a Web Analytics project, showing which pages visitors leave from, including visitor counts and exit rates. Use doc tool first to get the real input schema.
Returns Google Search Console performance history chart data (clicks, impressions, CTR, position) for specific pages over time, grouped by daily, weekly, or monthly intervals. Use doc tool first to get the real input schema.
Retrieves statistical data about the outbound links (outlinks) from a specified URL, domain, or site section. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
List users who have created posts in the account. Use doc tool first to get the real input schema.
Returns visitor data grouped by city for a Web Analytics project, showing visitor counts for each location. Use doc tool first to get the real input schema.
Provides the number of mentions for your and competitors's brands in an LLM you specify, with filters for locations, query text, URL, and more. Prefer using the equivalent 'brand-radar-mentions-overview-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.
Provides the historical share of voice for your and competitors's brands in an LLM you specify. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.
Retrieves a list of broken backlinks (i.e., links pointing to non-functioning pages) for a specified domain or URL, with customizable filtering, field selection, and aggregation options. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Returns time-series chart data for entry pages of a Web Analytics project, showing visitor counts and entry rates over time. Use doc tool first to get the real input schema.
Returns aggregate statistics for a Web Analytics project, including total visitors, bounce rate, and average session duration without any dimension grouping. Use doc tool first to get the real input schema.
Provides backlink statistics for a specified URL or domain as of a given date, with options to control protocol and scope. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Get engagement metrics (views, likes, etc.) for a specific post. Use doc tool first to get the real input schema.
Returns time-series chart data grouped by device type for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time. Use doc tool first to get the real input schema.
Returns time-series chart data for aggregate statistics of a Web Analytics project, with metrics like pageviews, visitors, visits, bounce rate, and session duration at the specified granularity. Use doc tool first to get the real input schema.
Provides an overview of keyword metrics—including search volume, CPC, ranking difficulty, traffic potential, and intent—for specified keywords, domains, or URLs within a given country. Requests will not consume API units if you use only "ahrefs" or "wordcount" in the `keywords` or `keyword` query parameter. Use doc tool first to get the real input schema.
Returns time-series chart data for traffic sources of a Web Analytics project, showing how visitor counts, bounce rates, and session durations change over time for each referral source. Use doc tool first to get the real input schema.
Provides the historical number of impressions for your and competitors's brands in an LLM you specify. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.
Retrieves the list of custom brand radar reports. Requests to this endpoint are free and do not consume any API units. Use doc tool first to get the real input schema.
Returns Google Search Console performance history chart data (clicks, impressions, CTR, position) for specific keywords over time, grouped by daily, weekly, or monthly intervals. Use doc tool first to get the real input schema.
Render an interactive time series line chart. Accepts one or more named data series. Supports multi-series with automatic dual Y-axis when 2 series have different units. Features hover tooltip, vertical crosshair, and toggleable legend. IMPORTANT: series names are shown in the chart legend and must be human-readable labels. Convert snake_case identifiers to Title Case (e.g. 'position_1_to_3' becomes 'Position 1 to 3', 'org_traffic' becomes 'Organic Traffic'). Expand abbreviations where possible (e.g. 'ctr' becomes 'CTR', 'org' becomes 'Organic', 'avg' becomes 'Average'). Never pass an empty string as a series name; use a descriptive label like 'Other' or 'Not Set' instead. The source field is optional: set source.tool to the bare tool name without any connector or namespace prefix (e.g. 'brand-radar-sov-history' not 'my-connector:brand-radar-sov-history'), and source.params to the arguments you passed, to generate an 'Open in Ahrefs' link. Unit labels appear next to values in tooltips: only set unit for currencies ('$') or percentages ('%'). Omit unit for all other metrics. Monetary values are in USD cents (not dollars), make sure to divide them by 100 first such that they are displayed in USD.
Provides organic and paid search performance metrics for a specified website, broken down by country, for a specific date. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Returns time-series chart data for exit pages of a Web Analytics project, showing visitor counts and exit rates over time. Use doc tool first to get the real input schema.
Returns Google Search Console keywords table data with metrics (clicks, impressions, CTR, position) and associated URLs for a project. Use doc tool first to get the real input schema.
Returns traffic source breakdown for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by referral source. Use doc tool first to get the real input schema.
Retrieves custom prompts for a specific brand radar report. Requests to this endpoint are free and do not consume any API units. Use doc tool first to get the real input schema.
Returns keyword metrics and related terms—such as "also rank for" keywords and "also talk about" keywords—for a given keyword or keyword list, with filtering and sorting options. Requests will not consume API units if you use only "ahrefs" or "wordcount" in the `keywords` or `keyword` query parameter. Use doc tool first to get the real input schema.
Returns time-series chart data grouped by browser language for a Web Analytics project, showing visitor counts over time for each language. Use doc tool first to get the real input schema.
Retrieves keyword ideas and their associated SEO metrics by matching input terms or phrases in a specified country, with extensive support for filtering, sorting, and metric selection. Requests will not consume API units if you use only "ahrefs" or "wordcount" in the `keywords` or `keyword` query parameter. Use doc tool first to get the real input schema.
Provides the share of voice for your and competitors's brands in an LLM you specify, with filters for locations, query text, URL, and more. Prefer using the equivalent 'brand-radar-sov-overview-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.
Provides the number of impressions for your and competitors's brands in an LLM you specify, with filters for locations, query text, URL, and more. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.
Returns how often AI search platforms cite the target, with the number of citation links and distinct cited pages per platform as of a given date. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Returns Google Search Console CTR (click-through rate) data by keyword position, showing each keyword's average position, CTR percentage, and click count. Use doc tool first to get the real input schema.
Provides keyword search suggestions and related keyword metrics (e.g., search volume, difficulty, CPC) for specified queries or keyword lists, with options to filter, sort, and customize returned fields by country. Requests will not consume API units if you use only "ahrefs" or "wordcount" in the `keywords` or `keyword` query parameter. Use doc tool first to get the real input schema.
Returns time-series chart data for the most visited pages of a Web Analytics project, showing how pageviews, visitors, and other metrics change over time. Use doc tool first to get the real input schema.
Render an interactive data table widget with sorting, search, and pagination. Accepts column definitions (key and label) and row data. Column types are inferred automatically from the data. IMPORTANT: preserve array values in row data as JSON arrays (e.g. tags: ["tag1", "tag2"]), do not flatten them to comma-separated strings. The source field is optional: set source.tool to the bare tool name without any connector or namespace prefix (e.g. 'site-explorer-all-backlinks' not 'my-connector:site-explorer-all-backlinks'), and source.params to the arguments you passed, to generate an 'Open in Ahrefs' link.
Retrieves historical data on the number of organic keywords a specified website or URL has ranked for, segmented by various search position ranges and grouped by a chosen time interval. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Retrieves anchor text and associated backlink metrics for a specified domain or URL, with filtering and selection options. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Provides an overview of competitor rankings and keyword metrics for a specified project and date in Ahrefs Rank Tracker, allowing comparison between current and previous data. Use doc tool first to get the real input schema.
Provides the historical number of mentions for your and competitors's brands in an LLM you specify. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.
Returns a list of a site's or URL's best-performing pages, ranked by the number of referring external links, with flexible filtering and sorting options. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Retrieves the domain rating and related metrics for a specified domain or URL as of a specific date. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Provides the share of voice for your and competitors's brands in an LLM you specify, with filters for locations, query text, URL, and more. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.
Returns the top 1M domains ranked by Ahrefs Domain Rating, together with each domain's current Domain Rating. Use doc tool first to get the real input schema.
Returns OS version statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by OS version. Use doc tool first to get the real input schema.
Returns Site Audit project summaries (all projects or a specific project), including health scores, issue counts, and crawled page counts for the latest crawl or a specified historical point in time. Use doc tool first to get the real input schema.
Performs a batch analysis of multiple URLs, domains, or subdomains to retrieve selected SEO, backlink, organic, and paid traffic metrics. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Use doc tool first to get the real input schema.
Returns Google Search Console pages table data with metrics (clicks, impressions, CTR, position) and associated keywords for a project. Use doc tool first to get the real input schema.
Retrieves information about external domains that are linked from a specified target domain or URL, allowing for filtering, field selection, and various scopes of analysis. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Requests will not consume API units if you use the "ahrefs.com" or "wordcount.com" domains, or any URL from these domains, in the `target` query parameter. Use doc tool first to get the real input schema.
Returns visitor data grouped by continent for a Web Analytics project, showing visitor counts for each region. Use doc tool first to get the real input schema.
