rank-monitor

/digital-marketing-pro:rank-monitor

スクリプトの場所。 ホストが ${CLAUDE_PLUGIN_ROOT} を設定しない場合、スクリプトは skills/ と同じ階層にあるこのプラグインの scripts/ フォルダーにあります。Python 3.10 以降で実行してください。python を使用し、見つからない場合（macOS、多くの Linux システム）は python3 を使用します。

目的

キーワードのランキング監視を設定・管理します。--features を指定すると、同じ実行で SERP の機能も追跡できます。Google でのターゲットキーワードの順位を追跡し、ベースラインを設定して、順位が 5 位を超えて下落したことを検出し、ランキングに大きな変化があった場合にアラートを生成します。--features モードでは、各クエリに表示される SERP の機能（AI Overviews、Featured Snippets、People Also Ask、Knowledge Panels、Local Pack、Image Pack、Video Carousel、Shopping）と、ブランドがそれらを獲得しているかどうかも追跡します。これにより、オーガニック検索のパフォーマンスを継続的に把握し、ランキングの下落を早期に検知し、上昇傾向を見つけ、機能がますます充実する検索結果ページを追跡できます。

スキルの統合（旧 rank-monitor ＋ serp-tracker）。 SERP の機能の追跡は、このスキルの --features モードになりました。旧 /digital-marketing-pro:serp-tracker は、このスキルへの非推奨案内です。

データソース（設定前にお読みください）

• Google Search Console MCP は、確認済みプロパティの順位と表示回数に関する信頼できるデータソースです。GSC はクエリ／ページごとの順位、表示回数、クリック数、CTR を返しますが、クエリごとの SERP 機能の全体的な配置や AI Overview の引用一覧は返しません。そうであるかのように説明しないでください。
• ランクトラッカー MCP（Ahrefs／Semrush／SE Ranking が接続されている場合）は、GSC では確認できないキーワードや競合の順位を補完し、独自の SERP 機能フラグを提供します。
• SERP スナップショットファイル（任意。任意のプロバイダーから取得）：ブランドがすでに任意の SERP API またはランクトラッカーからクエリごとの SERP 結果をエクスポートしている場合は、エクスポートを --serp-snapshot <file> で渡し、最初に検証してください。

  python "${CLAUDE_PLUGIN_ROOT}/scripts/serp-snapshot.py" --file <export.csv|export.json> --brand-domain <brand domain>
  

  各行には、そのクエリの順位、AI Overview の有無と引用、People Also Ask と Featured Snippet の獲得状況が含まれます。形式については、このファイルと同じ場所にある serp-snapshot-format.md を参照してください。スクリプトはそのファイルのみを読み込みます（ネットワーク、API キー、プロバイダーコードは不要です）。エクスポートの形式に誤りがある場合は終了コード 1 で終了し、不正な行をすべて一覧表示します（エラーを表示し、そのファイルは使用しないでください）。ファイルが指定されていない場合、何も変更されません。
• Moz MCP（mcp-moz）は任意です。使用前に npm にパッケージが存在することを確認してください（npm view mcp-moz）。npx はリモートコードを実行するため、未検証のパッケージを接続しないでください。Moz が接続されていない場合は、GSC と、ブランドがすでに使用しているランクトラッカー MCP を利用してください。
• --features モードの AI Overview の有無では、AI Overview が表示されたかどうかと、ブランドがその中で引用されたかどうかのみを記録します（SERP 機能の二値シグナル）。6 つの標準 AI サーフェスにわたるスコア付き AI 可視性測定には、/digital-marketing-pro:geo-monitor ／ /digital-marketing-pro:aeo-audit（標準の AI 可視性スコアリング基準）を使用し、実際の表示回数には /digital-marketing-pro:gsc-ai-performance を使用してください。ここで AI 可視性のスコアリングを再実装しないでください。

必要な入力

ユーザーは以下を指定する必要があります（または入力を促されます）。

• ターゲットキーワード：モニタリングするキーワードのリストです。直接指定するか、CSV または Google スプレッドシートからインポートするか、ブランド既存のキーワードトラッキングリスト ${CLAUDE_PLUGIN_DATA}/{brand}/seo/keywords.json から取得します。可能な場合は、キーワードに検索意図の分類（情報収集型、ナビゲーション型、取引型、商用型）を含めてください
• モード：デフォルトはランキングのみです。同じ実行でクエリごとの SERP 機能の有無を示すマトリックスも作成するには、--features を渡します
• モニタリング頻度：daily または weekly です。優先度の高いヘッドキーワード、実施中のキャンペーンのキーワード、変動の大きい機能セットには毎日、ロングテールや優先度の低いキーワードには毎週設定します
• アラートのしきい値：アラートを発生させる順位変動です。デフォルトは5位を超える下落です。キーワードグループごとにカスタマイズできます（例：ブランドキーワードは3位超、ヘッドキーワードは5位超、ロングテールは10位超）。下落と上昇の両方のしきい値に対応しています
• 競合ドメイン（任意）：同じキーワード／機能でブランドと併せて追跡するドメインです。最大10件まで指定できます
• デバイスタイプ：mobile、desktop、または both です
• 対象国：ランキングを確認する Google のロケールです（例：US、UK、AU、CA、IN）

プロセス

1. ブランドのコンテキストを読み込む：~/.claude-marketing/brands/_active-brand.jsonを読み、アクティブなスラッグを確認してから、~/.claude-marketing/brands/{slug}/profile.jsonを読み込みます。ブランドのトーン、対象市場のコンプライアンス規則（skills/context-engine/compliance-rules.md）、業界のコンテキストを適用します。また、~/.claude-marketing/brands/{slug}/guidelines/_manifest.jsonにガイドラインがあるか確認し、存在する場合は制約を読み込みます。~/.claude-marketing/sops/にエージェンシーのSOPがあるかも確認します。ブランドが存在しない場合は、「先にブランドを設定しますか（/digital-marketing-pro:brand-setup）？」と尋ねるか、デフォルト設定で続行します。
2. 現在のランキングのベースラインを記録する：接続済みの順位情報ソース（GSC MCPに加え、利用可能な順位トラッカー／Moz MCP）に問い合わせ、対象キーワードごとの現在の検索順位を取得します。利用可能な場合は、GSCから順位、ランキングURL、クリック率、インプレッションを記録します。--featuresモードでは、クエリに存在するSERP機能（順位トラッカーの機能フラグ、検証済みのSERPスナップショットファイル、または手動確認から取得）と、機能ごとの所有ドメインも記録し、各クエリのフラグがどのソースに由来するかを示します。競合ドメインについても、同じキーワードの順位（および機能の所有状況）を記録します。
3. 監視スケジュールを設定する：キーワードリスト、モード（rankingsまたはrankings+features）、監視頻度、アラートのしきい値、競合ドメイン、デバイスの種類、対象国を${CLAUDE_PLUGIN_DATA}/{brand}/seo/rank-monitor/config.jsonに保存します。現在の順位を基準点とするベースラインスナップショットを${CLAUDE_PLUGIN_DATA}/{brand}/seo/rank-monitor/baseline.jsonに作成または更新します（--featuresモードでは、機能マトリックスも含めます）。
4. 各監視チェックで、照会して比較する：追跡対象のすべてのキーワードの現在の順位を取得します。各キーワードの現在の順位を、ベースライン（監視開始時の順位）と前回のチェック（最後に記録した順位）の両方と比較します。ベースラインからの絶対変動、前回チェックからの変動、直近7日間と30日間のトレンド方向、追跡対象キーワード全体の平均順位を計算します。--featuresモードでは、前回のスナップショットと機能マトリックスを比較し、機能の獲得／喪失、所有状況の変化、AI Overviewの表示／引用の変化を確認します。
5. 重要な変化を検出する：アラートのしきい値を超えたキーワードを特定します。具体的には、設定済みの順位しきい値を超えて順位が下落したキーワード、1ページ目（順位1～10位）から2ページ目以降に落ちたキーワード、5順位を超える上昇を獲得したキーワード（早期に成果を得られる可能性）、および--featuresモードでは、ブランドのランキングURLにおける新たなSERP機能の表示または喪失、ブランドより上位または下位に移動した競合の順位／機能の変化を特定します。
6. しきい値を超えた場合にアラートを生成する：アラートを重大度別に分類します。minorは3～5順位の下落（監視）、majorは5～10順位の下落（コンテンツの鮮度、技術的な問題、競合の動向を調査）、criticalは10順位を超える下落、または1ページ目から2ページ目への移動（アルゴリズムの更新、手動による対策、技術的エラー、コンテンツのカニバリゼーションをすぐに調査）です。--featuresモードでは、所有していた強調スニペット、またはAI Overviewの引用を失った場合は、少なくともmajorとして扱います。各重大度レベルに応じた推奨される次のステップを含めます。

SERP 機能の追跡（--features モード）

--features を設定すると、実行時にクエリと機能のマトリックスも作成されます。追跡する機能とその見方は次のとおりです。

機能	「所有」の意味	最適化の指標
AI Overview	AI Overview が表示され、ブランドの URL が引用元の 1 つになっている	引用の有無のみを示すバイナリー指標です。AI の可視性をスコアで確認するには、/digital-marketing-pro:geo-monitor を使用します
強調スニペット	ブランドがクエリで 0 位を獲得している	抽出しやすい形式にします。段落（40～60 語）、リスト（5～8 項目）、または表が適しています
他の人はこちらも質問	クエリに関する PAA の質問にブランドの URL が回答している	FAQ 形式の H2/H3 コンテンツで PAA の質問を狙います
ナレッジパネル	ブランドのエンティティに関するパネルが表示されている	エンティティのシグナル（Wikidata、GBP、構造化データ）を強化します。詳しくは /digital-marketing-pro:entity-audit を参照してください
ローカルパック	ブランドが地図の 3 件枠に表示されている	GBP の最適化とローカルスキーマが有効です。詳しくは /digital-marketing-pro:local-seo を参照してください
画像／動画カルーセル	ブランドのアセットがカルーセルに表示されている	画像は代替テキスト／ファイル名、動画はタイトル、説明、トランスクリプトを最適化します
ショッピング／サイトリンク	ブランドの掲載情報が表示されている	商品スキーマ／サイト構造を最適化します

機能の獲得可能性は、達成可能性（現在の掲載順位とコンテンツ形式から見た、ブランドがその機能を獲得できる可能性）×トラフィックへの影響（クエリの検索ボリュームと機能の目立ちやすさに基づく、推定 CTR への影響）でスコア化されます。

出力

次の内容を含む、構造化されたランキングレポート（--features モードでは SERP 機能レポートも含む）が出力されます。

• ランキングのスナップショット：追跡対象のすべてのキーワードの現在の順位。順位、ランキング URL、デバイス、国、日付、ベースラインおよび前回のチェックとの比較を、上昇、下降、横ばいの方向指標とともに表示します
• 変動レポート：ベースラインおよび前回のチェックからの順位変動。下落幅が大きい順に並び、7 日間および 30 日間のトレンドをスパークラインで表示します
• アラートの概要：対応が必要なキーワードを、重大度（重大、大、中）別に分類して表示します。具体的な順位変動、影響を受けた URL、推奨される調査手順も含みます
• SERP 機能マトリックス（--features）：クエリごとに、表示された機能、所有者（ブランド、競合他社、その他）、前回のスナップショットからの変化を示すグリッド。AI Overview の表示有無とブランドの引用状況も含みます
• 機能獲得の機会一覧（--features）：ブランドが現実的に狙える、未獲得の機能を順位付けし、具体的なコンテンツ／スキーマの推奨事項を示します
• 競合比較：追跡対象の競合ドメインについて、相対順位（および機能の所有状況）の変化を表示します。獲得した競合と失った競合、キーワードごとの直接比較、競争上のギャップの経時的な傾向を確認できます

ヒントと注意点

• GSC には AI Overview の引用データをエクスポートする機能がありません。 --features の AI Overview 指標は観測に基づくものです（AIO が表示されたか、ブランドが引用されているか）。実際の AI インプレッションは /digital-marketing-pro:gsc-ai-performance で照合し、スコア化された AI の可視性は /digital-marketing-pro:geo-monitor で確認してください。
• 順位の変動幅はクリック数／インプレッション数の変動幅よりノイズが大きくなります。 キーワードの順位が 8 位と 12 位の間で変動すると、意味の薄い大きな割合変動が生じます。原因を調べる際は、インプレッション数やクリック数の変化をより重視してください。
• GSC のデータには約 3 日の遅延があります。 「現在」のデータを取得する場合は、3 日前を期間の終了日に設定してください。
• 追跡対象を増やしすぎないでください。 価値の高い 50～150 個のキーワードを適切に追跡するほうが、2,000 個をノイズとして追跡するより効果的です。

使用するエージェント

• seo-specialist — キーワードランキングと SERP 機能の分析、機能の所有者の判定、ランキング変動の原因の診断（アルゴリズムの更新、技術的な問題、競合による順位の奪取、コンテンツの劣化）、ベースラインの設定とトレンドの算出、重大度別の推奨アクション
• performance-monitor-agent — 重大度の分類を伴うアラートの生成、監視スケジュールの管理、ローリング期間の比較によるしきい値超過の検出、7 日間および 30 日間の方向分析によるトレンド追跡、通知のフォーマット

関連項目

• /digital-marketing-pro:geo-monitor — 6 つの標準的な AI サーフェスにおけるスコア化された AI 可視性（AI 可視性のスコアリング標準）
• /digital-marketing-pro:gsc-ai-performance — GSC における実際の AI Overview / AI Mode のインプレッション
• /digital-marketing-pro:seo-drift — 2 つのランキングスナップショットを比較し、上位の変動項目を表示