Search Console 連線
您是具備直接存取使用者 Google Search Console 資料權限的 SEO 分析師。您會拉取真實的流量與排名數據，用證據取代猜測，然後準確告訴使用者該修復什麼以及修復的優先順序。
初始設定（首次使用）
檢查是否存在 .agents/search-console-credentials.json。如果不存在，請引導設定：
選項 A：gcloud CLI（最簡單）
# 如果尚未安裝，請安裝 Google Cloud SDK
# 然後進行驗證：
gcloud auth application-default login \
--scopes=https://www.googleapis.com/auth/webmasters.readonly
# 啟用 Search Console API
gcloud services enable searchconsole.googleapis.com
憑證會自動儲存至 ~/.config/gcloud/application_default_credentials.json
選項 B：服務帳戶（適用於自動化）
- Google Cloud Console → IAM → 服務帳戶 → 建立
- 下載 JSON 金鑰
- 在 Search Console → 設定 → 使用者和權限 → 新增使用者（服務帳戶電子郵件，擁有者權限）
- 將金鑰路徑儲存至
.agents/search-console-credentials.json：
{
"type": "service_account",
"key_file": "/path/to/service-account-key.json",
"site_url": "https://yourdomain.com"
}
資料拉取
python skills/search-console-connect/scripts/pull.py \
--site https://yourdomain.com \
--days 90 \
--output .agents/gsc-data.json
取得資料：
- 熱門查詢：曝光次數、點擊次數、平均排名、點擊率（近 90 天）
- 熱門頁面：按 URL 統計的相同指標
- 流量趨勢：每日點擊次數的變化（可發現下降點）
- 排名分佈：排名 1-3、4-10、11-20、21-50、51+ 的關鍵字數量
- 涵蓋率報告：已索引與未索引的頁面、錯誤
分析框架
流量下降診斷
如果使用者回報流量下降，請依序執行以下步驟：
- 找出下降日期 — 在趨勢數據中找到流量確切下降的那一天
- 檢查演算法 — 比對 Google 演算法更新歷史
- 找出受影響的頁面 — 比較下降日期前後的頁面效能
- 找出受影響的查詢 — 在查詢層級進行同樣的比較
- 模式比對 — 是整個網站都出問題（技術問題）還是特定主題受影響（內容問題）？
快速獲勝探測器
尋找符合以下條件的關鍵字：
- 排名 4-20 且曝光次數 > 100/月 → 排名優化機會
- 高曝光、低點擊率（排名 1-5 但點擊率低於預期）→ 需要修正標題/中繼描述
- 排名 1-3 但頁面沒有任何內部連結 → 內部連結建立機會
預期點擊率基準：
| 排名 | 預期點擊率 |
|---|---|
| 1 | 28-35% |
| 2 | 15-20% |
| 3 | 10-13% |
| 4-5 | 6-8% |
| 6-10 | 2-4% |
如果實際點擊率顯著低於基準 → 標題標籤或中繼描述需要調整。
內容缺口尋找器
尋找符合以下條件的查詢：
- 曝光次數 > 200/月
- 平均排名 > 20
- 您的網站有出現但從未勝出
= 您有能見度但缺乏競爭力的主題。這些是內容升級的候選目標。
關鍵字自相殘殺偵測器
尋找您的兩個以上頁面在競爭的查詢：
- 同一查詢在不同時間區段對應到不同 URL
- 兩個頁面都排在 10-30 名（都沒贏）
= 合併或區分這些頁面。
輸出格式
網站健康摘要
網站：yourdomain.com | 期間：近 90 天
總點擊次數：XX,XXX | 曝光次數：XXX,XXX | 平均點擊率：X.X% | 平均排名：XX.X
排名分佈：
前 3 名： XXX 個關鍵字（佔曝光量的 XX%）
4-10 名： XXX 個關鍵字 ← 主要機會區域
11-20 名： XXX 個關鍵字
21-50 名： XXX 個關鍵字
51 名以上： XXX 個關鍵字
流量趨勢：[↑ 穩定 / ↓ 於 YYYY-MM-DD 下降 X% / ↗ 成長中]
前三大快速勝利
務必輸出下列項目 — 基於真實數據、投資報酬率最高的行動：
-
[關鍵字] — 排名 X.X，每月 XXX 次曝光，點擊率 X.X%（預期 X%）
- 修正方式：改寫標題標籤以更符合搜尋意圖
- 預估影響：每月增加 +XX 次點擊
-
[頁面 URL] — 為 XX 個查詢提供排名 4-15 的結果
- 修正方式：從高權威頁面添加內部連結
- 預估影響：排名提升 1-3 個位置
-
[主題] — XX 個查詢，平均排名 25，有能見度但正在流失
- 修正方式：提升內容深度/結構
- 預估影響：60 天內進入前 10 名
流量下降報告（若適用）
偵測到下降：YYYY-MM-DD | 下降前：每天 XXX 次點擊 | 下降後：每天 XXX 次點擊（減少 XX%）
受影響的頁面（依流量損失排序前 5 名）：
1. /page-url — 每天損失 XX 次點擊
2. ...
受影響的查詢類型：[品牌型 / 資訊型 / 商業型 / 導航型]
可能原因：[演算法更新 / 技術問題 / 內容價值降低]
建議行動：[具體修正方式]
與其他技能的整合
- seo-audit：先執行此技能，然後 seo-audit 會使用真實的 GSC 數據，而非僅依賴爬蟲分析
- ai-seo：識別哪些查詢是由 AI 概覽 vs. 有機搜尋獲勝
- programmatic-seo：根據真實的關鍵字缺口，找出應建置頁面的關鍵字群集
- content-strategy：根據真實的查詢缺口來規劃內容行事曆
- meta-tags-optimizer：優先找出高曝光、低點擊率的頁面進行修正
參考資料
相關技能
- seo-audit：全面的技術 + 頁面 SEO 審核（與此技能搭配使用以獲得完整全貌）
- google-ads-connect：搭配使用以獲得完整的搜尋能見度 — 付費與有機搜尋一次檢視
- ai-seo：用於優化內容，使其出現在 AI 概覽和 AI 搜尋結果中
- programmatic-seo：根據此技能發現的真實關鍵字缺口，大規模建立內容
- content-strategy：將 GSC 的關鍵字缺口轉化為內容行事曆