mcpField
G
gsc-portfolio-audit

gsc-portfolio-audit

github.com/openclaudiaマーケティング・グロース722101 回インストール1 週間前に更新
リポジトリ

gsc-portfolio-audit について

GSC Portfolio Auditは、1つのSearch Consoleアカウントにある複数プロパティの実績をまとめて確認するスクリプトとワークフローです。プロパティの順位付けやクエリの変化、クリック率の課題を示し、マーケターやサイト運営者を支援します。

主な機能

  1. 01プロパティ横断の実績ランキング
  2. 02新規・上昇・下降・消失クエリの把握
  3. 03クリック率の課題の特定
  4. 04期間とプロパティの選択
  5. 05データの並列取得

活用シーン

  1. 01複数サイトの実績確認
  2. 02クリック数が大きく変化したクエリの発見
  3. 03タイトルと説明文の改善優先度付け
  4. 04四半期内の検索期間の比較

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/openclaudia/openclaudia-skills --skill gsc-portfolio-audit

インストール後、Claude Code で/gsc-portfolio-auditを入力して読み込まれたか確認します。

同梱ファイルscripts/audit_gsc.py

詳細

GSC ポートフォリオ監査

Search Console アカウント内のすべてのプロパティについて「全体の状況はどうか？」に答えます。サイトごとのツールでは、手作業で何十回もエクスポートしないと答えられない問いです。

セットアップ

https://www.googleapis.com/auth/webmasters.readonly の OAuth リフレッシュトークンが必要です。

export GOOGLE_GSC_CLIENT_ID=...      # or GOOGLE_CLIENT_ID
export GOOGLE_GSC_CLIENT_SECRET=...  # or GOOGLE_CLIENT_SECRET
export GOOGLE_REFRESH_TOKEN=...
export GSC_EXCLUDE="olddomain.com"   # optional, comma-separated
pip install requests

セットアップで最もよくある失敗は、トークン更新時の unauthorized_client です。 リフレッシュトークンを発行した OAuth クライアントと、組み合わせた ID／シークレットが異なることを意味します。Google 連携を長年にわたって追加してきたアカウントには、通常、複数のクライアントがあります。トークンを発行したクライアントの ID とシークレットを組み合わせてください。

実行方法

python3 scripts/audit_gsc.py            # full: ranking + keyword diff for the top 12
python3 scripts/audit_gsc.py portfolio  # just the ranked table
python3 scripts/audit_gsc.py queries --site sc-domain:example.com
python3 scripts/audit_gsc.py --days 90  # quarter over quarter

フラグ：--days（期間。直前の期間と比較します）、--site（繰り返し指定可能）、--top、--limit、--min-clicks。

セクションの意味

セクション見方
NEW前の期間のクリック数がゼロだったクエリです。実際に成長をもたらしている要因がわかります。
RISING50％以上増加しています。掲載順位も変化したか確認してください。変化していなければ、順位ではなく需要が伸びています。
DROPPING実績のあるベースから40％以上減少しています。掲載順位を見ると、どちらのタイプかがわかります。順位が下がっていれば順位の低下、順位を維持しているのにクリック数が急落していれば、上位で何かにクリックを奪われています（AI Overview、新しい SERP 機能、またはクエリの変化）。
LOST以前はランクインしていましたが、現在はデータがありません。
CTR GAPインプレッション数が1,500以上、トップ10以内、CTRが2％未満です。タイトルと説明文の書き換えは、最も低コストで効果を得られる施策です。

解釈

  • まずクリック数を報告し、次にインプレッション数を報告してください。 1つの大規模なプロパティによってポートフォリオ全体のインプレッション数が大きく変動し、ほかのすべてが成長していることが見えなくなる場合があります。
  • ブランド検索と非ブランド検索を分けてください。 キーワード全体が自社名（または競合他社名の誤記）で占められているサイトは、クリック数がどれほど良く見えても、新規獲得の仕組みがありません。レポートではそのことを明確に伝えてください。
  • サイト全体が主要キーワードで急落した場合、たいてい SEO の問題ではありません。 順位を診断する前に所有権を確認してください。whois <domain> | grep -i "registrar\|updated date" を実行し、引き続き名前解決できるかどうかも確認します。ドメインの期限切れ、移管、または紛争は、SEO にどれほど取り組んでも解決できない、典型的な順位の急落を引き起こします。
  • ポートフォリオ表の「new」は、前の期間のクリック数がゼロだったことを意味します。 最近公開されたサイトの場合、これはデータ欠損ではなく、公開されたばかりということです。
  • 読めない言語のクエリも省かないでください。 複数市場を対象とするサイトでは、成長の大半が英語以外のロングテールで生じることがよくあります。除外せず、注目すべきクエリを翻訳してください。
  • 403 を返すプロパティは、一覧に表示されることは確認済みですが、検索アナリティクスにはアクセスできません。スクリプトはそのプロパティを隠さず、エラーとして報告します。

注記

  • GSC のデータには約3日の遅延があり、スクリプトは自動的にその分を考慮します。
  • 2つの期間のデータは、プロパティごとに並行して取得されるため、40件のプロパティがあるアカウントでも数秒で完了します。
  • クエリ行数は期間ごとに25,000件までです。これは、28日間の期間で単一のサイトから返される件数を大きく上回ります。

コメント

Markdown 対応