ahrefs

ahrefs is a skill for Claude Code, Codex from withoneai/one-agent-plugin. It costs 0 tokens per session (7,009 once invoked), scanned A, original, MIT.

A connection to Ahrefs, an SEO service for studying search keywords, incoming links, website performance, content, and competitors.

In plain words
What is it for?
Use it for keyword research, backlink checks, content audits, website analysis, and competitive SEO research.
Why use it?
It lets an agent work with SEO research and website search-ranking data through Ahrefs instead of handling that work manually.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/withoneai/one-agent-plugin/ahrefs
Any agent
npx skills add withoneai/one-agent-plugin --skill ahrefs
Clone the repo
git clone --depth 1 https://github.com/withoneai/one-agent-plugin

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ahrefs

README.md
[![agentmods](https://agentmods.dev/badge/skills/withoneai/one-agent-plugin/ahrefs.svg)](https://agentmods.dev/skills/withoneai/one-agent-plugin/ahrefs)
Your own site
<a href="https://agentmods.dev/skills/withoneai/one-agent-plugin/ahrefs"><img src="https://agentmods.dev/badge/skills/withoneai/one-agent-plugin/ahrefs.svg" alt="Measured on agentmods" height="20"></a>
Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 7,009 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.07009
Opus 5 $0.00000 $0.03504
Sonnet 5 $0.00000 $0.01402
Haiku 4.5 $0.00000 $0.00701

Measured 3d ago against content hash c31708379cd3, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

ahrefs scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

platforms/one-ahrefs/skills/ahrefs/SKILL.md · 429 lines

How it starts

The opening of the file, as written. The whole thing — 429 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Ahrefs through One

Ahrefs is an all-in-one SEO toolset that helps businesses and marketers improve their website’s search engine rankings through keyword research, backlink analysis, content audits, and competitive insights.

One exposes Ahrefs through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

  1. Find the action in the table below, or call search_one_platform_actions with platform ahrefs if it is not listed.
  2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
  3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Ahrefs is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Ahrefs account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

SiteExplorer

Action Method Path Action id
Get a Site Explorer Target’s Keywords History GET /v3/site-explorer/keywords-history conn_mod_def::GJz-x6PUgRM::zai-0o8mR0CpFjUOGEYs0g
Get a Site Explorer Target’s Total Search Volume History GET /v3/site-explorer/total-search-volume-history conn_mod_def::GJz-zNNTW68::PfTm2C5lQTChT801fMMDdg
Get Pages by Traffic GET /v3/site-explorer/pages-by-traffic conn_mod_def::GJz-ytSHxgM::5SThItv8SYSst064Y0wGXA
Get Referring Domains History for a Target GET /v3/site-explorer/refdomains-history conn_mod_def::GJz-zB8r8zs::QcdpeFcPTLWZQsRomoI_jA
Get Site Explorer Backlinks Stats Overview GET /site-explorer/backlinks-stats conn_mod_def::GJz-xeOnPvw::vzC1UMYHRGyxCer2nyQCqw
Get Site Explorer Metrics by Country GET /v3/site-explorer/metrics-by-country conn_mod_def::GJz-yNAGn_I::ohUaXdWfS76tBNiZRtRT5A
Get URL Rating History for a Target (Site Explorer) GET /v3/site-explorer/url-rating-history conn_mod_def::GJz-zXF1IrU::orKWOe6PRNaT3un_29-N2w
List a Target’s External Linked Anchors GET /v3/site-explorer/linked-anchors-external conn_mod_def::GJz-xLkETP8::6bCHqi9YSCSTVtfPAY6EIw
List a Target’s Outgoing Internal Anchors GET /site-explorer/linked-anchors-internal conn_mod_def::GJz-xViNBbQ::jUTZ4S1rQ4WHBODMzr5T8g
List All Backlinks for a Target (Site Explorer) GET /v3/site-explorer/all-backlinks conn_mod_def::GJz-v2c8EaI::TO6oXW4HTYiV1CUG-GSR3A
List Best Pages by Internal Links GET /site-explorer/pages-by-internal-links conn_mod_def::GJz-zrPYav8::1NYsEAgnRyWK538JM9HFxQ
List Broken Backlinks for a Target (Site Explorer) GET /site-explorer/broken-backlinks conn_mod_def::GJz-wAn4gFE::uo0jcyS6TUqbZY0GIZ4Zsg

Read the full file on GitHub · 429 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 429 lines · 0 tokens per session scan A c31708379cd3

Subscribe to this mod's changes

ahrefs is a skill published in the GitHub repository withoneai/one-agent-plugin (1 stars, last pushed 14d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 7,009 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.