SEO 最怕的不是慢，而是沒節奏。很多站點的真實情況是：數據一直在變化，但因爲覆盤成本太高，大家就只能在流量明顯掉的時候纔回頭看。等你發現掉了，往往已經錯過了最容易修復的窗口。Search Console API 自動週報的意義，就是把覆盤這件事變成固定動作：每週自動產出一份“該看什麼、該做什麼”的清單。

你不需要把它想得很複雜。自動週報不是要做一個龐大的 BI 系統，而是把你每週手動做的幾件事（導出、篩選、對比、標記）交給腳本去做，讓你把時間花在判斷與行動上。你越早把這個節奏建立起來，越不容易被“感覺”帶着跑。

Search Console API 能拿到什麼（以及拿不到什麼）

最常用的是 Search Analytics 數據：查詢詞、頁面、國家、設備、曝光、點擊、CTR、平均排名等。這些數據足以支撐絕大部分內容與排名覆盤。你要注意的是：它不是實時數據，會有延遲；另外它不會告訴你站內行爲（那是分析工具的工作）。它的價值在於：搜索結果裏發生了什麼變化。

一份能指導動作的週報，至少包含 4 張表

  1. 機會詞表：曝光高、CTR 低的查詢/頁面（優先改標題與摘要）。
  2. 排名波動表：本週 vs 上週，排名/點擊變化最大的查詢與頁面（優先排查是否被內耗/是否被替代）。
  3. 新增長表：新出現的查詢、新進入前 10 的頁面（優先加內鏈、加信任證據，放大勝利）。
  4. 異常頁面表：點擊暴跌的頁面、曝光暴跌的目錄（優先查技術問題與索引問題）。

真正有用的週報並不需要 20 個圖表，反而需要幾張能直接派發任務的表。

實現方式：最簡單的兩條路

  • Apps Script：適合把結果寫進表格並用於協作；實現快、維護也相對簡單。
  • Python：適合輸出 CSV/JSON 再接自己的報表或郵件系統；可擴展性更強。

無論哪條路，你都要做三件事：拿到授權（OAuth）、調用 Search Analytics 接口拉數據、把數據按週報邏輯做對比並輸出。

最小實現思路（僞代碼）：先跑通，再優化

1) 拉取 last_7_days 與 prev_7_days 的 query/page 指標
2) 以 query+page 或 page 爲鍵做 join
3) 計算 delta：clicks_diff / ctr_diff / position_diff
4) 過濾出三類清單：機會詞、波動、增長
5) 輸出 CSV 或寫入表格

驗收清單：你怎麼知道週報真的可用？

  • 每週固定時間能自動生成，不依賴人工導出。
  • 週報裏每張表都有明確動作：改標題、加內鏈、排查技術、更新內容。
  • 你能把週報結果和內容更新計劃連起來（否則週報只是看完就結束）。

如果你還在用 Search Console Insights 手動覆盤，可以先把思路跑順：Search Console Insights 新版怎麼用。API 是把手動覆盤變成自動覆盤的下一步。

延伸閱讀

參考資料