GSC ポートフォリオ監査
「全体の調子はどうですか?」という質問に、Search Console アカウント上のすべてのプロパティを横断して答えます。これは、個別サイト用のツールでは数十回の手動エクスポートなしには答えられない問いです。
セットアップ
https://www.googleapis.com/auth/webmasters.readonly スコープを持つ OAuth リフレッシュトークンが必要です。
export GOOGLE_GSC_CLIENT_ID=... # または GOOGLE_CLIENT_ID
export GOOGLE_GSC_CLIENT_SECRET=... # または GOOGLE_CLIENT_SECRET
export GOOGLE_REFRESH_TOKEN=...
export GSC_EXCLUDE="olddomain.com" # オプション、カンマ区切り
pip install requests
最も一般的なセットアップ失敗は、トークン更新時の unauthorized_client です。 つまり、リフレッシュトークンが、あなたが設定した ID/シークレットのペアとは異なる OAuth クライアントに対して発行されています。長年にわたって Google 連携を追加してきたアカウントには通常、複数のクライアントが存在します。トークンを発行したペアと一致させてください。
実行
python3 scripts/audit_gsc.py # フル:ランキング + 上位12サイトのキーワード差分
python3 scripts/audit_gsc.py portfolio # ランキングテーブルのみ
python3 scripts/audit_gsc.py queries --site sc-domain:example.com
python3 scripts/audit_gsc.py --days 90 # 四半期比較
フラグ: --days(ウィンドウ、直前の同じ期間と比較)、--site(繰り返し可)、--top、--limit、--min-clicks。
セクションとその意味
| セクション | 読み方 |
|---|---|
| NEW | 前の期間にクリックがゼロだったクエリ。成長の源泉。 |
| RISING | 50%以上増加。ポジションも動いたか確認 — 動いていなければ、ランキングではなく需要が増加。 |
| DROPPING | 実績ベースから40%以上減少。ポジションが理由を教えてくれます: 順位が下がった = ランキング低下。順位は変わらずクリックが急減 = 上に表示されている何か(AI Overview、新しいSERP機能、クエリの変化)がクリックを奪っている。 |
| LOST | 以前はランクインしていたが、現在はデータなし。 |
| CTR GAP | インプレッション数1,500以上、トップ10、CTR 2%未満。タイトルと説明文の書き換えが最も効果的な改善策。 |
解釈
- クリックを最初に報告し、インプレッションはその次に。 1つの大きなプロパティがポートフォリオ全体のインプレッション数を大きく変動させ、他のすべてが成長している事実を隠してしまう可能性があります。
- ブランドクエリと非ブランドクエリを分離すること。 キーワードセット全体が自社名(または競合のスペルミス)だけのサイトは、クリック数がどんなに良くても、集客エンジンがありません。レポートで明確に指摘してください。
- サイト全体が自社ブランド名で崩壊するのは、通常 SEO の問題ではありません。 ランキングを診断する前に所有権を確認:
whois <domain> | grep -i "registrar\|updated date"に加えて、ドメインがまだ解決するか確認。期限切れ、移管、または紛争中のドメインは、教科書通りのランキング急降下を引き起こし、SEO 対策では修正できません。 - ポートフォリオテーブルの「新規」は、前のウィンドウでクリックがゼロだったことを意味します。 新しく立ち上げたサイトの場合、これはデータギャップではなく、ローンチです。
- 読めない言語のクエリをスキップしないでください。 多国語サイトでは、成長は通常、英語以外のロングテールキーワードで発生します。フィルタリングするのではなく、興味深いものを翻訳してください。
- 403 を返すプロパティは、掲載(listing)は確認済みでも、検索アナリティクス(search analytics)が許可されていません。スクリプトはそれを隠さずに報告します。
注意点
- GSC データは約3日の遅延があります。スクリプトはこれを自動的に調整します。
- 両方の期間がプロパティごとに並列取得されるため、40プロパティのアカウントでも数秒で完了します。
- クエリ行は期間あたり最大25,000件に制限されており、28日間のウィンドウで単一サイトが返す件数を十分に上回っています。