Ahrefs自動化 (ComposioHQ/Ahrefs-Automation)

Ahrefs自動化

Claude Codeから直接AhrefsのSEO分析を実行します。被リンクプロファイルの分析、キーワード調査、ドメインオーソリティの経時追跡、オーガニックキーワード順位の監査、複数URLのバッチ分析をターミナルから離れずに行えます。

ツールキットドキュメント: composio.dev/toolkits/ahrefs

---

セットアップ

1. Composio MCPサーバーを設定に追加します：

   https://rube.app/mcp
   

2. プロンプトに従い、Ahrefsアカウントを接続します。エージェントが認証リンクを提供します。
3. ほとんどのツールでは、target（ドメインまたはURL）とcountryコード（ISO 3166-1 alpha-2）が必要です。一部のツールではdateをYYYY-MM-DD形式で指定する必要があります。

---

コアワークフロー

1. サイトエクスプローラーメトリクス

ドメインの包括的なSEOメトリクス（被リンク数、参照ドメイン、オーガニックキーワード順位、トラフィック推定値など）を取得します。

ツール: AHREFS_RETRIEVE_SITE_EXPLORER_METRICS

主要パラメータ:

• target（必須） -- 分析するドメインまたはURL
• date（必須） -- YYYY-MM-DD形式のメトリクス日付
• country -- ISO国コード（例：us、gb、de）
• mode -- スコープ：exact、prefix、domain、またはsubdomains（デフォルト）
• protocol -- both、http、またはhttps
• volume_mode -- monthlyまたはaverage

プロンプト例：「example.comの本日時点のAhrefsサイトメトリクスをアメリカで取得して」

---

2. 履歴メトリクス追跡

トレンド分析や競合ベンチマークのために、ドメインのSEOメトリクスが時間とともにどのように変化したかを追跡します。

ツール: AHREFS_RETRIEVE_SITE_EXPLORER_METRICS_HISTORY、AHREFS_DOMAIN_RATING_HISTORY

全メトリクス履歴の場合:

• target（必須） -- 追跡するドメイン
• date_from（必須） -- YYYY-MM-DD形式の開始日
• date_to -- 終了日
• history_grouping -- daily、weekly、またはmonthly（デフォルト）
• select -- date,org_cost,org_traffic,paid_cost,paid_trafficなどのカラム

ドメインレーティング（DR）履歴の場合:

• target（必須）、date_from（必須）、date_to、history_grouping

プロンプト例：「過去1年間のexample.comの月次ドメインレーティング履歴を表示して」

---

3. 被リンク分析

ソースURL、アンカーテキスト、リンク属性、参照ドメインメトリクスを含む包括的な被リンクリストを取得します。

ツール: AHREFS_FETCH_ALL_BACKLINKS

主要パラメータ:

• target（必須） -- ドメインまたはURL
• select（必須） -- カンマ区切りのカラム（例：url_from,url_to,anchor,domain_rating_source,first_seen_link）
• limit（デフォルト1000） -- 結果数
• aggregation -- similar_links（デフォルト）、1_per_domain、またはall
• mode -- exact、prefix、domain、またはsubdomains
• history -- live、since:YYYY-MM-DD、またはall_time
• where -- is_dofollow、domain_rating_source、anchorなどのカラムに対するリッチフィルター式

プロンプト例：「example.comへのフォロータイプの被リンク上位100件をアンカーテキストと参照DRとともに取得して」

---

4. キーワード調査

キーワード概要メトリクスを取得し、コンテンツ戦略のための一致するキーワードバリエーションを発見します。

ツール: AHREFS_EXPLORE_KEYWORDS_OVERVIEW、AHREFS_EXPLORE_MATCHING_TERMS_FOR_KEYWORDS

キーワード概要の場合:

• select（必須） -- 返すカラム（ボリューム、難易度、CPCなど）
• country（必須） -- ISO国コード
• keywords -- カンマ区切りのキーワードリスト
• where -- ボリューム、難易度、インテントなどでフィルタリング

マッチング用語の場合:

• select（必須）およびcountry（必須）
• keywords -- カンマ区切りのシードキーワード
• match_mode -- terms（任意の順序）またはphrase（正確な順序）
• terms -- allまたはquestions（質問形式のキーワードのみ）

プロンプト例：「'プロジェクト管理'に関連するキーワードバリエーションをアメリカでボリュームと難易度とともに見つけて」

---

5. オーガニックキーワード監査

ドメインがオーガニック検索でどのキーワードでランクインしているか、順位追跡と履歴比較を確認します。

ツール: AHREFS_RETRIEVE_ORGANIC_KEYWORDS

主要パラメータ:

• target（必須） -- ドメインまたはURL
• country（必須） -- ISO国コード
• date（必須） -- YYYY-MM-DD形式の日付
• select -- 返すカラム（キーワード、順位、ボリューム、トラフィック、URLなど）
• date_compared -- 過去の日付と比較する場合
• where -- keyword、volume、best_position、インテントフラグなどに対するリッチフィルター式
• limit（デフォルト1000）、order_by

プロンプト例：「アメリカでexample.comがトップ10にランクインしているすべてのオーガニックキーワードを表示して」

---

6. バッチURL分析

最大100のURLまたはドメインを同時に分析し、競合他社やサイトセクション間のSEOメトリクスを比較します。

ツール: AHREFS_BATCH_URL_ANALYSIS

主要パラメータ:

• targets（必須） -- url、mode（exact/prefix/domain/subdomains）、protocol（both/http/https）を持つオブジェクトの配列
• select（必須） -- カラム識別子の配列
• country -- ISO国コード
• output -- jsonまたはphp

プロンプト例：「competitor1.com、competitor2.com、competitor3.comのSEOメトリクスを比較して」

---

既知の落とし穴

• カラム選択は必須： ほとんどのAhrefsツールでは、返すカラムを指定するselectパラメータが必要です。省略したり無効なカラム名を使用するとエラーになります。各ツールのレスポンススキーマで有効な識別子を確認してください。
• 日付形式の一貫性： 日付はYYYY-MM-DD形式で指定する必要があります。一部の履歴エンドポイントは、正確な日付ではなくhistory_groupingで設定された粒度でデータを返します。
• APIユニットコストは異なる： カラムによって消費されるユニット数が異なります。スキーマで「(5 units)」や「(10 units)」とマークされたカラムはより高コストです。traffic、refdomains_source、difficultyのような高コストカラムをリクエストする場合はAPI使用量を監視してください。
• バッチ制限は100ターゲット： AHREFS_BATCH_URL_ANALYSISはリクエストあたり最大100ターゲットまで受け付けます。より大規模な分析の場合は、複数のバッチに分割してください。
• フィルター式は複雑： whereパラメータは標準SQLではなく、Ahrefsのフィルター式構文を使用します。各ツールのスキーマにあるカラム説明で、サポートされるフィルタータイプと値の形式を確認してください。
• 非推奨のoffsetパラメータ： offsetパラメータは2024年5月31日をもって非推奨になりました。カーソルベースのページネーションを使用するか、代わりにlimitを調整してください。
• モードがスコープに大きく影響： modeをsubdomains（デフォルト）に設定するとすべてのサブドメインが含まれ、domainやexactと比較して結果数が大幅に増加する可能性があります。

---

クイックリファレンス

ツールスラッグ	説明
AHREFS_RETRIEVE_SITE_EXPLORER_METRICS	ドメイン/URLの現在のSEOメトリクス
AHREFS_RETRIEVE_SITE_EXPLORER_METRICS_HISTORY	経時的なSEOメトリクス履歴
AHREFS_DOMAIN_RATING_HISTORY	ドメインレーティング（DR）履歴
AHREFS_FETCH_ALL_BACKLINKS	フィルタリング付き包括的被リンクリスト
AHREFS_FETCH_SITE_EXPLORER_REFERRING_DOMAINS	参照ドメインのリスト
AHREFS_GET_SITE_EXPLORER_COUNTRY_METRICS	国別トラフィック内訳
AHREFS_BATCH_URL_ANALYSIS	最大100URLのバッチ分析
AHREFS_EXPLORE_KEYWORDS_OVERVIEW	キーワードメトリクス概要
AHREFS_EXPLORE_MATCHING_TERMS_FOR_KEYWORDS	一致するキーワードバリエーション
AHREFS_EXPLORE_KEYWORD_VOLUME_BY_COUNTRY	国別キーワードボリューム
AHREFS_RETRIEVE_ORGANIC_KEYWORDS	ドメインのオーガニックキーワード順位
AHREFS_RETRIEVE_SITE_EXPLORER_KEYWORDS_HISTORY	キーワード順位の履歴データ
AHREFS_RETRIEVE_TOP_PAGES_FROM_SITE_EXPLORER	SEOメトリクスによるトップパフォーマンスページ
AHREFS_GET_SERP_OVERVIEW	特定キーワードのSERP概要

---

Powered by Composio