MCP 経由で Ahrefs を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Ahrefs をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Ahrefs + Gemini

Ahrefs の SEO データを AI に届けます。ドメインレーティング、被リンク、参照ドメイン、オーガニックキーワード、トップページ、競合、検索ボリューム、キーワード難易度、キーワード候補、SERP 概要、一括比較を取得でき、リクエストごとの API ユニット消費量もわかります。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

AHREFS_API_KEY

ステップ 1 — 認証情報を取得

1. API アクセスは対象となる Ahrefs の有料プランに含まれ、プランごとに毎月の API ユニット枠があります（https://ahrefs.com/pricing を参照）。それ以外のプランでは、無料のテストクエリしか実行できません。キーを作成できるのは、ワークスペースのオーナーと管理者だけです。
2. Account settings → API keys（https://app.ahrefs.com/account/api-keys）を開いてキーを作成します。キーに月間のユニット上限を設定しておくこともおすすめします。
3. キーを AHREFS_API_KEY に貼り付け、コネクターをインストールします。キーは暗号化して保存され、Bearer トークンとして api.ahrefs.com にのみ送信されます。
4. まず ahrefs_get_limits_and_usage を使います。無料で、プラン、今月の API ユニットの使用量と上限、リセット日を表示します。

ご自身の Ahrefs API ユニットに課金: どのリクエストも、Ahrefs ワークスペースの API ユニットを消費します。1 リクエストの最低消費は 50 ユニットです。それを超える分は、要求した各列のユニット単価（標準は 1 ユニット、トラフィック、検索ボリューム、キーワード難易度、参照ドメインなどの指標は 5 または 10）に、返された行数を掛けた値になります。標準の列の場合、被リンクは 1 行あたり 8 ユニット、参照ドメインは 6、アンカーテキストは 10、オーガニックキーワードは 34、トップページは 24、キーワード指標は 1 キーワードあたり 33、SERP 概要は 1 順位あたり 25 です。リクエストは 10 行から始まり、AI は回答に必要な列だけを要求します。Ahrefs がキャッシュから返すリクエストは無料です。

無料のテストクエリ: ahrefs.com、yep.com、firehose.com に対する Site Explorer のリクエストと、キーワード ahrefs、yep、firehose 単体に対する Keywords Explorer または SERP Overview のリクエストは無料です（最大 100 行）。ユニットを使う前に、これらでツールを試せます。

できること: Site Explorer（ドメインレーティングと Ahrefs Rank、被リンクの合計、オーガニック検索と有料検索の指標、トラフィックとドメインレーティングの推移、被リンク、参照ドメイン、アンカーテキスト、オーガニックキーワード、トップページ、オーガニック競合）。Keywords Explorer（検索ボリューム、キーワード難易度、CPC、トラフィックポテンシャルと親トピック、一致するキーワードと質問、関連キーワード、月間検索ボリュームの推移）。Ahrefs が記録したキーワードの SERP Overview。最大 100 件のドメインまたは URL を 1 回の呼び出しで比較する Batch Analysis。すべてのツールは読み取り専用です。Batch Analysis は POST を使いますが、何も変更しません。

パラメーター: Site Explorer のほとんどのツールには date が必要です（最新のデータなら今日の日付）。country は小文字 2 文字の国コードです。mode は対象の範囲を指定し、subdomains（既定）、domain、prefix、exact のいずれかです。CPC とトラフィック価値は USD のセント単位で返ります。

よくあるエラー: 401 は、API キーが間違っている、期限切れ、または削除されたことを意味します。Account settings → API keys で新しいキーを作成してください。403 は、プランに API アクセスがない、キーまたはワークスペースがユニット上限に達した、またはリクエストがプランの範囲外である状態です（たとえば、1 リクエストあたりの行数がプランの上限を超えている場合）。400 はパラメーターが無効な状態で、理由にそのパラメーター名が示されます。429 は 1 分あたり 60 リクエストを超えた状態です。少し待ってから再試行してください。

このコネクターは、Rank Tracker、Site Audit、Brand Radar、Web Analytics、GSC Insights、Social Media、Content Helper、管理用エンドポイント（プロジェクト、キーワードリスト）には対応していません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Ahrefs のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「example.jp の現在のドメインレーティング、有効な参照ドメイン数、オーガニックトラフィックを教えてください。」
• 「competitor.jp の dofollow の参照ドメインのうち、ドメインレーティングが高い上位 20 件と、そのリンクで最も多く使われているアンカーテキストを一覧にしてください。」
• 「日本における example.jp のオーガニック競合と、それぞれに最も多くのトラフィックをもたらしているページを調べてください。」
• 「日本で『ランニングシューズ』のキーワード候補を、検索ボリューム 1,000 超、キーワード難易度 30 未満の条件で、トラフィックポテンシャル付きで出してください。」
• 「今月 Ahrefs の API ユニットをどれだけ使いましたか？枠はいつリセットされますか？」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続