keyword-clustering

OpenSEO キーワードクラスタリング

目的

キーワードをページ単位のクラスターにまとめ、各クラスターのターゲットにする既存ページまたは新規ページを決定します。これは単なる意味的なグループ分けではなく、キーワードをページに割り当てるワークフローです。

必要な入力

• projectId
• キーワードリスト、保存済みキーワードタグ、シードトピック、またはターゲットドメイン
• マッピング対象となる既存の URL／ページ（任意）

キーワードが指定されていない場合、保存済みセットには list_saved_keywords、シードの調査には research_keywords、ターゲットドメインを起点とする場合は get_ranked_keywords を使用します。

プロジェクトのコンテキスト

プロジェクトコンテキストツールは無料で、アプリやほかのエージェントと共有されています。

1. まず get_project_context を呼び出し、マッピングの根拠にします。保存済みの主要ページはクラスターの割り当て先となる既存ページであり、ビジネスと目標によって、ターゲットにする価値のあるクラスターが決まります。
2. このスキルには主要ページが必要です。保存されていない場合は、最小限のインライン設定を行います。ユーザーに重要なページを尋ねるか、サイト、監査、または Search Console から候補を提案して確認し、update_project_context（addKeyPages）に書き戻してからクラスタリングを続けます。最初に詳細なヒアリングをすべて行わないでください。残りの設定には最後に seo-project-setup を案内します。
3. クレジットを使う前に、調査ログを確認します。同じ調査が過去30日以内に実施されている場合は、その結果を再利用し、再購入するのではなく、その旨を伝えます。
4. 完了したら、長期的に役立つ情報を update_project_context に書き戻します。新規または修正した addKeyPages エントリには、各ページが現在ターゲットにするトピックを記載します。また、調査ログに次のエントリを追加します。{ appendResearchLog: { summary: "Keyword clustering: <keyword set>. Verdict: <conclusion>" } }

レポートとして納品

seo-report スキルを使って納品し、skill: "keyword-clustering" を指定して保存します。そのスキルが利用できない場合は、その旨を伝え、HTML の作成に進まず終了します。

OpenSEO MCP ツール

• list_saved_keywords：既存のキーワードセットを取得します。タグによる絞り込みも可能です。
• research_keywords：ユーザーがトピックを起点とする場合、シードを拡張します。
• get_ranked_keywords：ユーザーがドメインまたはページを起点とする場合、実際に順位を獲得しているキーワードと URL を収集します。
• get_search_console_performance：Search Console が接続されている場合、dimensions: ["query","page"] を指定して実際のクエリを取得します。すでに表示回数を獲得しているページに用語を割り当て、カニバリゼーション（1つのクエリが複数の URL にクリックを分散させている状態）を特定します。
• get_serp_results：SERP の重複状況と検索意図を確認し、キーワードを同じページに割り当てるべきか検証します。
• get_local_serp_results：マップやローカルパックの検索意図をページの割り当てに反映する場合、ローカル SEO クラスターに使用します。
• save_keywords：ユーザーの確認後、最終クラスターにタグを付ける場合に使用します。

ワークフロー

1. 候補となるキーワードセットを集めます。
   • Search Console が接続されている場合は、get_search_console_performance（ディメンション ["query","page"]）を使い、実際のクエリと、それらですでにランキングしているページから始めます。
   • ドメイン／ページ主導のクラスタリングには、get_ranked_keywords を使います。
   • 距離、ローカルパック、Google ビジネスの結果によって、キーワードを地域ページに含めるべきかどうかが決まる場合は、search_local_businesses と get_local_serp_results を使います。
2. 重複、関連性のないキーワード、明らかに別の製品や対象者を必要とするキーワードを除外します。
3. 検索意図とページタイプに基づいてクラスターを作成します。
   • SERP 上の検索意図が同じで、ランキングページも似ているキーワードは、同じクラスターにまとめます。
   • 検索意図、購入段階、SERP の形式が異なる場合は、分けます。
   • 語句が似ていても、同じクラスターになるとは限りません。
4. 判断が難しい重要なキーワードについては、少数の get_serp_results バッチを使って重複を確認します。
5. 各クラスターを次のいずれかに割り当てます。
   • 適切な既存 URL（指定されている場合）
   • 該当する既存ページがない場合は、新規ページの提案
   • 優先度が低い、または戦略に合わない場合は、ターゲットにしない／後回しにする項目
6. 複数のページが同じ検索意図をターゲットにする場合は、カニバリゼーションのリスクを特定します。Search Console が接続されている場合は、get_search_console_performance（dimensions: ["query","page"]）を使って実データで確認します。同じクエリで複数の URL にインプレッションが発生している状態です。
7. クラスタータグを save_keywords で適用する前に、確認を求めます。

出力形式

h1：サイトまたはキーワードセット。

レポートテンプレートが適用される場合（seo-report を参照）、そのセクションと文体をこのリストの代わりに使用します。

次の順にセクションを並べます。

1. 全体像 — クラスター数、新規作成が必要なページ数、更新が必要なページ数、見つかったカニバリゼーションを、冒頭の1～2文で説明します。
2. クラスター — クラスター、主要キーワード、検索意図、ターゲットページ、優先度を記載した表です。セカンダリーキーワードはこの表ではなく、各クラスターの概要に記載します。
3. ページ概要 — 各クラスターについて、ページタイプと検索者の課題を1つずつ示し、その後に作成または更新するページを記載します。必要なセクションと内部リンクは、その下に列挙します。
4. カニバリゼーション — 実際の根拠がある場合に限り、クエリ、競合する URL、残す URL を記載した表を示します。
5. 次に行うこと — タグの提案と、適用前に明示的に確認を求める手順を含む順序付きリストです。
6. このレポートの作成方法 — seo-report のスキルリンク行から始め、https://openseo.so/docs/skills/keyword-clustering を参照するリンクテキスト「OpenSEO Keyword Clustering skill」を記載します。続けてキーワードの取得元を説明し、URL データが提供されていない場合はターゲットページが提案であることを明記します。

ガードレール

• キーワードセットが少ない場合は、細かくクラスター化しすぎないでください。使用可能な語句が10個未満の場合は、簡潔な全体像を作成します。
• 語句の類似性だけに頼らないでください。SERP の検索意図を優先します。
• 明示的な確認なしにタグを広範囲に置き換えないでください。
• 既存 URL のデータがない場合は、ターゲットページが提案であることを明記します。