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 概述、新的 SERP 功能,或查詢型態改變)。 |
| 遺失 (LOST) | 之前有排名,現在無資料。 |
| 點擊率差距 (CTR GAP) | ≥1,500 次曝光,前 10 名,點擊率低於 2%。標題和描述重寫,這是最便宜的勝利。 |
解讀
- 首先報告點擊數,其次才是曝光數。 一個大型資源可能足以左右整個投資組合的曝光數,掩蓋其他所有網站都有成長的事實。
- 將品牌流量與非品牌流量分開。 一個網站整個關鍵字集都是自己的名稱(或競爭對手的拼寫錯誤),無論點擊數看起來多好,都沒有收購引擎。請在報告中直接說明。
- 整個網站在自身核心詞上的崩潰通常不是 SEO 問題。 在診斷排名之前,請先確認所有權:
whois <domain> | grep -i "registrar\|updated date",加上檢查它是否還能解析。到期、轉移或有爭議的網域會產生典型的排名懸崖,這是任何 SEO 工作都無法解決的。 - 投資組合表格中的「新增」表示上一個時間範圍內的點擊數為零,對於剛啟動的網站來說,這是上線,而不是資料缺口。
- 不要跳過您看不懂語言的查詢。 在多市場網站上,成長通常來自非英語的長尾關鍵字;請翻譯有趣的查詢,而不是過濾掉它們。
- 回傳 403 錯誤的資源表示已通過 listing 驗證,但未通過搜尋分析驗證。腳本會報告此錯誤,而不是隱藏它。
附註
- GSC 資料大約延遲 3 天;腳本會自動補償此延遲。
- 兩個時間範圍的資料會針對每個資源並行擷取,因此一個 40 個資源的帳戶只需幾秒鐘。
- 查詢列的上限為每個時間範圍 25,000 筆,遠高於任何單一網站在 28 天時間範圍內回傳的資料量。