seo-google

Google SEO APIs

直接存取 Google 自己的 SEO 資料。填補爬蟲分析（現有 claude-seo 技能）與 Google 即時現場資料之間的差距：實際 Chrome 使用者指標、真實索引狀態、搜尋成效與自然流量。

所有 API 皆免費。設定需要一個 Google Cloud 專案，包含 API 金鑰及/或服務帳戶——執行 /seo google setup 取得逐步說明。

前置需求

執行任何指令前，請檢查憑證：

claude-seo run google_auth.py --check --json

設定檔：~/.config/claude-seo/google-api.json

{
  "service_account_path": "/path/to/service_account.json",
  "api_key": "<GOOGLE_API_KEY>",
  "default_property": "sc-domain:example.com",
  "ga4_property_id": "properties/123456789"
}

若缺少，請閱讀 references/auth-setup.md 並引導使用者完成設定。

憑證層級

層級	偵測條件	可用指令
0 (API 金鑰)	存在 `api_key`	`pagespeed`, `crux`, `crux-history`, `youtube`, `nlp`
1 (OAuth/服務帳戶)	+ OAuth token 或服務帳戶	層級 0 + `gsc`, `inspect`, `sitemaps`, `index`
2 (完整)	+ 已設定 `ga4_property_id`	層級 1 + `ga4`, `ga4-pages`
3 (廣告)	+ 存在 `ads_developer_token` + `ads_customer_id`	層級 2 + `keywords`, `volume`

執行指令前務必告知偵測到的層級。

快速參考

指令	功能	層級
`/seo google setup`	檢查/設定 API 憑證	--
`/seo google pagespeed <url>`	PSI Lighthouse + CrUX 現場資料	0
`/seo google crux <url>`	僅 CrUX 現場資料（p75 指標）	0
`/seo google crux-history <url>`	25 週 CWV 趨勢分析	0
`/seo google gsc <property>`	Search Console：點擊數、曝光數、點擊率、排名	1
`/seo google inspect <url>`	網址檢查：索引狀態、標準網址、爬取資訊	1
`/seo google inspect-batch <file>`	從檔案批次檢查網址	1
`/seo google sitemaps <property>`	GSC Sitemap 狀態	1
`/seo google index <url>`	提交網址至 Indexing API	1
`/seo google index-batch <file>`	批次提交最多 200 個網址	1
`/seo google ga4 [property-id]`	GA4 自然流量報表	2
`/seo google ga4-pages [property-id]`	熱門自然流量到達頁面	2
`/seo google youtube <query>`	YouTube 影片搜尋（觀看數、讚數、長度）	0
`/seo google youtube-video <id>`	YouTube 影片詳細資料 + 熱門留言	0
`/seo google nlp <url-or-text>`	NLP 實體擷取 + 情感分析 + 分類	0
`/seo google entities <url-or-text>`	僅實體分析（適用於 E-E-A-T）	0
`/seo google keywords <seed>`	從 Google Ads 關鍵字規劃工具取得關鍵字建議	3
`/seo google volume <keywords>`	從關鍵字規劃工具查詢搜尋量	3
`/seo google entity <query>`	Knowledge Graph 實體查詢	0
`/seo google safety <url>`	Web Risk 網址安全檢查	0
`/seo google quotas`	顯示所有 API 的速率限制	--

PageSpeed + CrUX

`/seo google pagespeed <url>`

合併 Lighthouse 實驗室資料與 CrUX 現場資料。

腳本： claude-seo run pagespeed_check.py <url> --json
參考： references/pagespeed-crux-api.md
預設： 同時包含行動版與桌面版策略，所有 Lighthouse 類別。

輸出合併實驗室分數（單次 Lighthouse）與現場資料（28 天 Chrome 使用者指標）。CrUX 優先嘗試網址層級，若無則回退至來源層級。

`/seo google crux <url>`

僅 CrUX 現場資料（不執行 Lighthouse）。速度更快。

腳本： claude-seo run pagespeed_check.py <url> --crux-only --json

`/seo google crux-history <url>`

25 週 CrUX 歷史趨勢。顯示 CWV 指標是改善、穩定或惡化。

腳本： claude-seo run crux_history.py <url> --json
參考： references/pagespeed-crux-api.md

輸出包含各指標的趨勢方向、百分比變化及每週 p75 數值。

Search Console

`/seo google gsc <property>`

搜尋分析：過去 28 天的點擊數、曝光數、點擊率、排名。

腳本： claude-seo run gsc_query.py --property <property> --json
參考： references/search-console-api.md
預設： 28 天，維度=查詢、頁面，類型=網頁，限制=1000。

包含快速勝利偵測：排名 4-10 且曝光數高的查詢。totals 區塊來自獨立的無維度彙總查詢，因為查詢層級的資料列可能會省略匿名化的低流量資料。僅在 totals_complete 為 true 時，將總計視為全站資料。--limit 限制回傳的維度資料列總數，而非每個分頁請求的大小。

GSC 中的 AI 曝光（2026 年）：

生成式 AI 成效報表（2026-06-03 推出），專門檢視 AI Overviews + AI Mode 的可見度。僅曝光數（無點擊數/點擊率/排名/查詢）；維度：頁面/國家/裝置/日期（太平洋時間）；限制 1,000 列；最新資料為初步資料；另有獨立的 Discover 生成式 AI 報表。逐步推廣至部分資源。

AI Mode 已納入標準成效總計（網頁搜尋類型），AI Mode 中的點擊數（外部連結點擊）與曝光數已計入一般報表，因此無法從總計中乾淨區分「傳統」與「AI」流量。請使用生成式 AI 報表取得僅曝光數的 AI 可見度。

資料可靠性注意事項： GSC 記錄錯誤導致 2025-05-13 至 2026-04-27 期間的曝光數、點擊率與平均排名不可靠（點擊數不受影響；僅向前修正，無回溯補償）。處理涵蓋該區間的曝光數/點擊率/排名趨勢時請謹慎；修正後曝光數可能出現明顯下降。

`/seo google inspect <url>`

網址檢查：來自 Google 的真實索引狀態。

腳本： claude-seo run gsc_inspect.py <url> --json

回傳：判定（PASS/FAIL）、覆蓋狀態、robots.txt 狀態、索引狀態、頁面擷取狀態、標準網址選擇、行動裝置可用性、豐富結果。

`/seo google inspect-batch <file>`

從檔案批次檢查（每行一個網址）。每個網站每日限制 2,000 次。

腳本： claude-seo run gsc_inspect.py --batch <file> --json

`/seo google sitemaps <property>`

列出已提交的 Sitemap，包含狀態、錯誤、警告。Sitemap 內容僅回報提交數量；特定網址是否被索引，請以 URL Inspection API 為準。

腳本： claude-seo run gsc_query.py sitemaps --property <property> --json

Indexing API

`/seo google index <url>`

通知 Google 網址已更新。

腳本： claude-seo run indexing_notify.py <url> --json
參考： references/indexing-api.md

Indexing API 正式僅適用於 JobPosting 與 BroadcastEvent/VideoObject 頁面。務必告知使用者此限制。每日配額：200 次發布請求。

`/seo google index-batch <file>`

從檔案批次提交網址。追蹤配額使用量。

腳本： claude-seo run indexing_notify.py --batch <file> --json

GA4 流量

`/seo google ga4 [property-id]`

自然流量報表：每日工作階段、使用者數、瀏覽量、跳出率、參與度。

腳本： claude-seo run ga4_report.py --property <id> --json
參考： references/ga4-data-api.md
預設： 28 天，篩選至自然搜尋管道群組。

GA4「AI 助手」管道（約 2026-05-13 上線）： GA4 新增了原生的 AI 助手 預設管道群組。由已識別的 AI 助手引導的工作階段會獲得 medium=ai-assistant。Google 已識別的來源包括 ChatGPT、Gemini、Claude、Deepseek、Copilot、Grok，且此管道排除 Google AI Overviews / AI Mode。如有需要請另外驗證 Perplexity；不支援的來源可能仍歸類為推薦流量，且大多數 AI 工作階段無來源參照，會落入直接流量，因此此管道會低估 AI 流量。僅向前修正，無回溯補償。

`/seo google ga4-pages [property-id]`

依工作階段數排序的熱門自然流量到達頁面。

腳本： claude-seo run ga4_report.py --property <id> --report top-pages --json

YouTube（影片 SEO）

部分第三方研究報告指出 YouTube 提及次數與 AI 可見度之間有 0.737 的相關性。請將其視為方法論相關的訊號。免費，僅需 API 金鑰。

`/seo google youtube <query>`

在 YouTube 搜尋影片。回傳標題、頻道、觀看數、讚數、長度。

腳本： claude-seo run youtube_search.py search "<query>" --json
參考： references/youtube-api.md
配額： 每次搜尋 100 單位（每日免費 10,000 單位）。

`/seo google youtube-video <video_id>`

詳細影片資訊 + 標籤 + 前 10 則留言。

腳本： claude-seo run youtube_search.py video <video_id> --json
配額： 2 單位（影片詳細資料 + 留言）。

NLP 內容分析

Google NLP 實體/情感輸出，用於內部內容品質檢查。請勿將其視為 Google E-E-A-T 評分。

`/seo google nlp <url-or-text>`

完整 NLP 分析：實體、情感、內容分類。

腳本： claude-seo run nlp_analyze.py --url <url> --json 或 --text "..."
參考： references/nlp-api.md
免費方案： 每月 5,000 單位。需要在 GCP 專案中啟用計費。

`/seo google entities <url-or-text>`

僅實體擷取（更快，配額用量較少）。

腳本： claude-seo run nlp_analyze.py --url <url> --features entities --json

關鍵字研究（Google Ads）

黃金標準的關鍵字搜尋量資料。需要 Google Ads 帳戶。

`/seo google keywords <seed>`

從種子詞產生關鍵字建議。

腳本： claude-seo run keyword_planner.py ideas "<seed>" --json
參考： references/keyword-planner-api.md
需要： 設定檔中的 Ads 開發人員權杖與客戶 ID（層級 3）。

`/seo google volume <keywords>`

查詢特定關鍵字的搜尋量（逗號分隔）。

腳本： claude-seo run keyword_planner.py volume "<kw1>,<kw2>" --json

補充功能

`/seo google entity <query>`

Knowledge Graph 實體查詢。驗證品牌曝光度。

參考： references/supplementary-apis.md
使用 Knowledge Graph Search API，需 API 金鑰。

`/seo google safety <url>`

Web Risk API 檢查，偵測惡意軟體或社交工程標記。

參考： references/supplementary-apis.md

`/seo google quotas`

顯示速率限制表格。請閱讀 references/rate-limits-quotas.md。

報表

執行任何分析指令後，可提供產生 PDF/HTML 報表的選項。

`/seo google report <type>`

產生專業的 PDF 報表，包含圖表與分析。

腳本： claude-seo run google_report.py --type <type> --data <json> --domain <domain> --format pdf

類型	輸入	輸出
`cwv-audit`	PSI + CrUX + CrUX 歷史資料	Core Web Vitals 稽核，包含儀表、時間軸、分佈圖
`gsc-performance`	GSC 查詢資料	Search Console 報表，包含查詢表格、快速勝利
`indexation`	批次檢查資料	索引狀態，包含覆蓋率甜甜圈圖
`full`	所有資料合併	完整的 Google SEO 報表（所有章節）

工作流程：

執行資料收集指令（pagespeed、gsc、inspect-batch 等）
將 JSON 輸出儲存至檔案：claude-seo run pagespeed_check.py <url> --json > data.json
產生報表：claude-seo run google_report.py --type cwv-audit --data data.json --domain <domain>

慣例： 完成分析後，建議：「要產生報表嗎？請使用 /seo google report <type>」

速率限制

API	每分鐘	每日	驗證方式
PSI v5	240 QPM	25,000 QPD	API 金鑰
CrUX + 歷史	150 QPM（共用）	無限制	API 金鑰
GSC 搜尋分析	1,200 QPM/網站	30M QPD	服務帳戶
GSC 網址檢查	600 QPM	2,000 QPD/網站	服務帳戶
Indexing API	380 RPM	200 次發布/日	服務帳戶
GA4 Data API	10 個並行	~25K tokens/日	服務帳戶

跨技能整合

seo-audit：啟動 seo-google 代理程式以取得即時 CWV + 索引資料（條件式）
seo-technical：使用 pagespeed_check.py 取得真實 CWV 現場資料
seo-performance：CrUX 現場資料補充 Lighthouse 實驗室資料
seo-sitemap：GSC Sitemap 狀態顯示提交數量、錯誤與警告；使用 URL Inspection 取得索引真實狀態
seo-content：GSC 查詢資料提供關鍵字目標設定參考
seo-geo：使用 GSC 生成式 AI 成效報表，以及 AI Overviews/AI Mode/Discover 生成式 AI 的納入/排除控制（如可用）

輸出格式

CWV 指標：紅綠燈評級（良好 / 需改善 / 不佳）
成效報表：可排序欄位的表格
務必包含資料新鮮度備註
將報表儲存為 GOOGLE-API-REPORT-{domain}.md
Markdown/LLM 範本位於 assets/templates/：cwv-audit-report.md、gsc-performance-report.md、indexation-status-report.md；與 google_report.py 的 PDF 管線不同

技術備註

INP 已於 2024 年 3 月 12 日取代 FID。請勿再參考 FID。
CrUX 的 CLS 數值為字串編碼（例如 "0.05"）。腳本會處理解析。
CrUX 回傳 404 表示流量不足，非驗證錯誤。
搜尋分析資料有 2-3 天的延遲。
round_trip_time 已於 2025 年 2 月取代 CrUX 中的 effectiveConnectionType。
Custom Search JSON API 已對新客戶關閉（2025 年）。

錯誤處理

情境	處理方式
未設定憑證	執行 `/seo google setup`。列出僅需 API 金鑰即可使用的層級 0 指令。
服務帳戶缺少 GSC 存取權	回報錯誤。指示：將 `client_email` 新增至 GSC > 設定 > 使用者 > 新增。
CrUX 資料不可用（404）	回報 Chrome 流量不足。建議使用 PSI 實驗室資料作為備援。
GA4 資源未找到	回報錯誤。顯示如何在 GA4 管理 > 資源詳細資料中找到資源 ID。
Indexing API 配額超標	回報每日 200 次限制。建議優先處理最重要的網址。
速率限制（429）	等待並以指數退避方式重試。回報哪個 API 達到限制。

您可能也喜歡

copilotkit-self-update

37Kagent-workflows

Use when the user wants to update, refresh, or reinstall the CopilotKit agent SKILLS (the SKILL.md files that teach this agent about CopilotKit). NOT for updating the CopilotKit codebase or project — this is specifically about refreshing the skills/knowledge this agent has loaded. Triggers on "update copilotkit skills", "update skills", "refresh skills", "skills are stale", "skills are outdated", "get latest skills", "my copilotkit knowledge is wrong", "copilotkit APIs changed", "skills seem old", "wrong API names", "reinstall skills", "skills not working right", "update your copilotkit knowledge".

copilotkit

獲取

herdr

24Kagent-workflows

控制 Herdr，这是一个专门给 coding agent 使用的终端机复用工具（terminal multiplexer）。仅在使用者明确提及 Herdr，或是要求使用 Herdr 来检查或控制 pane、tab、workspace、指令或另一个 agent 时才使用。切勿单纯因为任务可能需要背景终端机、任务委派或平行作业就自动使用。需在 HERDR_ENV=1 的环境下运作。

herdrdev

獲取

skill-creator

385Kagent-workflows

建立、編輯、審核、整理、驗證或重構 AgentSkills 與 SKILL.md 檔案。

steipete

獲取

繼續探索

瀏覽 agent-workflows 熱門 Skills 最近更新

seo-google

相關技能

Google SEO APIs

前置需求

憑證層級

快速參考

PageSpeed + CrUX

/seo google pagespeed <url>

/seo google crux <url>

/seo google crux-history <url>

Search Console

/seo google gsc <property>

/seo google inspect <url>

/seo google inspect-batch <file>

/seo google sitemaps <property>