seo-google

seo-google 技能總覽

seo-google 能做什麼

seo-google 技能讓你直接存取 Google SEO APIs，不必靠泛用提示詞或第三方估算去猜。它是為了需要 Search Console、PageSpeed Insights、CrUX、Indexing API 與 GA4 自然流量這些真實欄位資料，而且希望在同一個工作流程內完成的人而設計的。

最適合的使用者與工作

如果你需要驗證索引狀態、檢查 URL、比較曝光與點擊、用真實使用者資料稽核 Core Web Vitals，或從 GA4 抓出自然流量趨勢，就很適合用 seo-google 技能。它特別適合 SEO 操作人員、技術 SEO、內容團隊，以及在提出建議前需要 Google 原生證據的代理式工作流程。

它為什麼不一樣

seo-google 的核心價值不是廣泛的 SEO 理論，而是來源可信的資料。它把爬取式分析和 Google 自家 APIs 接起來，讓你能從「這個頁面看起來沒問題」進一步走到「Search Console 顯示 CTR 偏低」或「CrUX 顯示行動裝置 INP 表現不佳」。因此，和一般自由發揮的提示詞相比，它更適合拿來做決策。

什麼情況下 seo-google 最合適

當任務仰賴真實的 Google 資料、帳號設定，或 API 驅動的診斷時，就該選 seo-google。若你只是想做內容發想、沒有 Google Ads 存取權的關鍵字靈感整理，或只需要一次性的 SEO 解釋、而不需要即時資料，那它就沒那麼合適。

如何使用 seo-google 技能

安裝並檢查前置需求

在執行 seo-google install 這一步時，先透過你的 skills 工作流程把技能加入，接著在開始分析前確認憑證是否可用。這個 repo 期待已經有 Google API 驗證，且技能最先要能正常運作的實務前提，是 ~/.config/claude-seo/google-api.json 內有可用的設定。

先用正確的輸入格式開始

seo-google usage 的模式，最適合搭配明確的 URL、property 或目標。好的輸入像是：「稽核 https://example.com/pricing 的索引狀態與 CWV」、「比較 sc-domain:example.com 過去 28 天的 GSC 查詢」、「檢查部落格區段的 GA4 自然流量登陸頁面」。避免像「改善我的 SEO」這種太模糊的請求，因為這些 APIs 需要明確目標和日期範圍。

先讀這些檔案

若要可靠地使用 seo-google，請先檢視 SKILL.md，再看 references/auth-setup.md、references/search-console-api.md、references/pagespeed-crux-api.md 與 references/ga4-data-api.md。如果你的任務涉及通知或 submit/inspect 流程，也要一併閱讀 references/indexing-api.md；如果是做關鍵字研究，則使用 references/keyword-planner-api.md。

這樣的工作流程結果最好

實用的流程是：先確認 auth，再辨識資料來源，接著定義 property 或 URL，選好日期區間，最後只要求你需要的指標。例如：「使用 seo-google，檢查 sc-domain:example.com 過去 28 天的 GSC Search Analytics，找出曝光高但 CTR 低的頁面，並說明可能需要改寫的標題。」這比直接要求一份泛泛的 SEO 檢查更好，因為它清楚告訴技能要抓什麼資料，以及輸出應該如何聚焦。

seo-google 技能 FAQ

seo-google 只適用於 Search Console 嗎？

不是。Search Console 當然是核心，但 seo-google 技能也涵蓋 PageSpeed Insights、CrUX、Indexing API 與 GA4 自然流量資料。如果你想用一個技能同時處理索引、效能和流量診斷，而不是拆成好幾個不同提示詞，這點就很重要。

我需要 API key 和 service account 都有嗎？

通常完整功能都要。API key 就足以存取 PageSpeed Insights 和 CrUX；Search Console、Indexing API 與 GA4 則需要 service account。若兩者都設定好，這個技能的實用性最高。

我可以用 seo-google 做 Keyword Research 嗎？

可以，但有範圍限制：seo-google 做 Keyword Research 會依賴 Google Ads / Keyword Planner 的存取權，設定比其他 APIs 更複雜。它最適合你需要 Google 來源的搜尋量或預測資料時；如果只是想快速找主題靈感，這就不是最理想的用途。

什麼時候不該用這個技能？

如果你沒有憑證、沒有已驗證的 property，或只是需要一份通用的 SEO 檢查清單，就不要用 seo-google。它也不是純內容生成的最佳選擇，因為它的強項是 API 驗證過的證據，不是文案起草。

如何改進 seo-google 技能

提供能直接做決策的上下文

要最快提升結果，最有效的方法是把 property 類型、URL 規則、日期範圍、裝置重點和成功指標一起講清楚。像是：「/blog/ 頁面的行動版 CWV」、「GSC 中曝光 > 1,000 且 CTR < 2% 的頁面」、「排除品牌登陸頁後，過去 90 天的 GA4 自然流量」。這樣 seo-google 回傳的就會是可操作的切片，而不是空泛總結。

一次只問一條分析線

當你把索引狀態、排名、Core Web Vitals 和流量分開成不同任務時，這個技能的表現會更好。像「先查 URL Inspection，再查 GSC，然後查 GA4」這種要求，常常會讓輸出變得雜亂；比較好的做法是先問一條分析線，根據結果再迭代。

注意常見失敗模式

最常見的阻礙是缺少 auth、property 格式錯誤，以及要求技能去推斷它無法直接抓取的資料。另一個常見問題是關鍵字請求過於寬泛，卻沒有足夠的 seed terms，或根本沒有 Google Ads 憑證。如果你想讓 seo-google 幫忙做 Keyword Research，請先說明你要的是靈感、歷史搜尋量，還是預測資料。

依據證據迭代，而不是靠直覺

第一次輸出之後，請用你實際看到的異常來縮小範圍，例如：「曝光高但點擊低的頁面」、「只有行動裝置 INP 表現差的 URL」、「近期發布頁面的索引失敗」。這會把 seo-google 變成一個診斷迴圈，第二輪結果通常會比一次性的泛用稽核實用得多。