網站分析技能
此技能允許代理從 Google 和 Bing 拉取並分析流量數據，以提供深入的 SEO 洞察。
環境準備
必要的腳本位於此 SKILL.md 檔案相對路徑的 scripts/ 目錄中。
請確認已安裝以下依賴項：
python3 -m pip install -r scripts/gsc-requirements.txt
所需憑證及取得方式
在執行此技能之前，請確保環境已配置完畢。如果使用者缺少所需憑證，代理應按照以下步驟引導使用者取得：
1. Google OAuth 用戶端密碼 (client_secret.json)
代理需要一個桌面 OAuth 2.0 用戶端 ID 才能存取 Google API。 給使用者的指示：
- 前往 Google Cloud Console。
- 建立新專案或選取現有專案。
- 前往 API 和服務 > 程式庫，啟用 Google Search Console API 與 Google Analytics Data API。
- 前往 API 和服務 > OAuth 同意畫面 進行設定（可將使用者類型設為「外部」，並將自己的電子郵件加入測試使用者）。
- 前往 API 和服務 > 憑證。點選 建立憑證 > OAuth 用戶端 ID。
- 選取 桌面應用程式 作為應用程式類型。
- 點選「建立」，然後下載 JSON 檔案。將其重新命名為
client_secret.json，並放置於此技能的scripts/目錄中。
2. Google OAuth 權杖 (token.json、google_analytics_token.json)
這些權杖會由腳本自動產生。
- 代理指示： 如果腳本輸出顯示「
Opening browser for authorization」，請告知使用者檢查電腦上是否有新開啟的瀏覽器視窗，並完成 Google OAuth 登入。登入成功後，腳本會自動在本機儲存權杖。
3. Bing API 金鑰
給使用者的指示：
- 前往 Bing 網站管理員工具。
- 選取已驗證的網站。
- 點擊右上角的 設定 齒輪圖示。
- 進入 API 存取 -> API 金鑰。
- 點選 產生 API 金鑰（或複製現有的金鑰）。
- 將其貼入
.env檔案中，格式為BING_API_KEY=你的金鑰。
執行步驟
1. 收集 Google Search Console (GSC) 資料
執行 GSC 分析腳本，取得點擊次數、曝光次數、點擊率與平均排名：
cd scripts && python3 analyze_gsc.py
2. 收集 Google Analytics 4 (GA4) 資料
執行 GA4 腳本，分析使用者工作階段、流量來源與頁面瀏覽次數：
cd scripts && python3 ga4_both.py
3. 收集 Bing 網站管理員工具資料
執行 Bing 腳本，比較 Bing 搜尋成效與 Google 的差異：
export BING_API_KEY=$(grep BING_API_KEY ../../.env | cut -d '=' -f2)
cd scripts && python3 bing_webmaster.py
4. 綜合分析洞察
分析合併後的輸出，並回報以下內容：
- 趨勢分析：根據 14 天視圖，整體流量是成長還是下降？
- 平台佔比：Bing 流量相較於 Google 的比例為何？
- 關鍵字與頁面機會：找出曝光次數高但點擊率低的關鍵字，或在 Bing 上表現良好但在 Google 上表現不佳的頁面。
使用整潔的 Markdown 格式向使用者提供最終摘要。