ChaoticSurfer/seo-suite

競爭者：誰真正贏得 SERP，以及為什麼

找出針對您的目標查詢進行排名的網域與頁面，衡量它們與您頁面的差異，並將這些差異轉化為具體的修正方案，無需虛構流量或權威數據。

使用時機 / 不使用時機

適用於：

• SERP 競爭者識別。
• 頁面對頁面比較。
• SERP 功能與意圖分析。
• 內容 / 關鍵字缺口。
• 反向連結缺口（付費）。
• 流量估算（付費，已標註）。
• 變更監控。

不適用於：

• 從種子關鍵字產生關鍵字清單 → 使用 seo-keywords。
• 執行推廣聯繫 → 使用 seo-links。
• 分析您的 Google Search Console 成效 → 使用 seo-analytics。

需要收集的輸入

• 您的網域，以及目標關鍵字集合（10–100 個）。可從 seo-keywords 的輸出或 GSC 的 striking-distance 清單中提取，或直接詢問。
• 市場： 國家 + 語言（搜尋的 --gl/--hl 對應項）、裝置焦點。
• 使用者已知的商業競爭對手。 有幫助，但需透過 SERP 驗證。
• 可選： 付費工具存取權限（Semrush/Ahrefs/Similarweb）及任何可用額度。

工作流程

1. 平行收集 SERP。

   • 將關鍵字集合分成每組約 10 個的批次，並為每個批次平行啟動一個 seo-serp-researcher 代理。
   • 每個代理針對每個關鍵字回傳：前 10 名自然結果 URL、頁面類型（指南 / 分類 / 產品 / 工具 / 論壇 / 影片 / 在地商家包）、SERP 功能（AI 概述、精選摘要、PAA、影片、圖片、購物、在地商家包、論壇 /「討論」）以及主要意圖。
   • WebSearch 結果近似於 SERP；並非個人化、精確位置的 Google SERP。將其標記為 [measured: WebSearch sample]。

2. 識別 SERP 競爭者。

   • 計算所有關鍵字中的網域出現次數。在前 10 名位置中佔比最高的前 5–10 個網域即是您的真正競爭者。
   • 區分：
     • 直接商業競爭者。
     • 內容發布者 / 聚合者。
     • 市集 / UGC（Reddit、YouTube、Wikipedia）。
   • 您與發布者競爭點擊次數，但不競爭客戶。策略不同：超越排名 vs. 爭取被列出 / 被提及。

3. 意圖與格式檢查。 如果前 10 名中有 7 個以上是與您不同的頁面類型（例如，清單頁面 vs 您的產品頁面），那麼修正方案應是格式，而非優化（啟發式判斷）。請優先報告此項。

4. 頁面層級比較。 針對每個優先關鍵字：

   mkdir -p seo-work
   python3 "${CLAUDE_PLUGIN_ROOT}/scripts/compare_pages.py" https://you.com/page https://rival1.com/a https://rival2.com/b https://rival3.com/c \
     --keyword "target keyword" > seo-work/compare-<slug>.json
   

   讀取：

   • 字數 vs median_competitor_words（僅供參考：長度並非排名因素；google-rules §4）。
   • 標題與提問式標題。
   • 清單 / 表格。
   • Schema 類型。
   • 信任訊號（作者、日期、引用）。
   • 關鍵字放置位置。
   • content_gap_phrases（2 個以上競爭者涵蓋但您未涵蓋的子主題）。

   針對不同關鍵字平行執行比較。

5. 技術 / 體驗缺口（可選）：

   • 對您的 URL 及前 2 名競爭者執行 psi.py：欄位 CWV [measured: CrUX]。
   • 對競爭者執行 page_audit.py 以查看其 schema 與可索引性設定。

6. 內容 / 關鍵字缺口。

   • 免費： 對競爭者的主要主題 + SERP 批次執行 keyword_ideas.py。若競爭者排名前 10 而您未出現的任何關鍵字，即為缺口 [measured: WebSearch sample]。
   • 付費： 請參閱下一節。

7. 反向連結缺口（僅付費）。連結到 2 個以上競爭者但未連結到您的參照網域 → 提供給 seo-links。

8. 變更監控。 當競爭者突然超越您的排名時：

   • 擷取 Wayback Machine CDX API：https://web.archive.org/cdx/search/cdx?url=rival.com/page&output=json&limit=20&from=2025&fl=timestamp,statuscode,digest。
   • 變更的 digest 值表示頁面內容何時變更。
   • 擷取 https://web.archive.org/web/<timestamp>/rival.com/page 以比對新舊版本（標題、標題、新增的章節）。
   • 報告：「排名提升與 <日期> 的頁面更新同時發生」。

9. 綜合分析。

   • 針對每個關鍵字：他們勝出的原因（格式、深度、新鮮度、權威性、使用者體驗、SERP 功能），並附上證據標籤。
   • 一份簡短的行動清單，分配至 seo-content / seo-onpage / seo-schema / seo-links / seo-technical。

檢查清單

檢查項目	規則	資料來源
意圖 / 格式與 SERP 多數相符	≥7/10 相同類型 → 比照辦理	啟發式判斷
長度	無偏好字數；涵蓋搜尋者所需內容	google-rules §4 [Google doc]
相對於彙整競爭者的原創價值	「超出其他內容的附加價值」是符合實用內容的問題	google-rules §4 [Google doc]
您可以爭取的 SERP 功能	精選摘要 / PAA：優先回答段落；影片：觀看頁面；圖片	google-rules §3, §8 [Google doc]
AI 概述是否存在	資格 = 已索引 + 可取得精選摘要；無特殊標記	google-rules §10 [Google doc]
競爭者的豐富結果	僅限有效的支援類型（FAQ/HowTo 已不再顯示）	google-rules §5 [Google doc]
抓取 / 複製競爭者內容	違反抓取與規模化內容政策	google-rules §4 [Google doc]

數據：免費 vs 付費

免費：

• WebSearch SERP 樣本。
• compare_pages.py、keyword_ideas.py、page_audit.py、psi.py（競爭者 URL/來源的 CrUX 欄位數據）。
• Wayback CDX。
• Google Trends 用於需求比較。
• 競爭者的公開 Sitemap（sitemap_check.py https://rival.com --sample 0 --urls-out rival-urls.txt 可從 lastmod 取得其庫存與發布頻率）。

付費（${CLAUDE_PLUGIN_ROOT}/references/tools.md）：

• Semrush（## Semrush）。
  • 有機研究：競爭者的排名關鍵字與估計流量 [vendor data]。
  • 關鍵字缺口（最多 5 個網域）：遺漏 / 弱勢 / 未開發的關鍵字。
  • 更新日期前後的位置歷史紀錄。
  • 合理使用時機：當您需要他們完整的關鍵字清單而非樣本時。
  • 節省成本策略：每季一次 Keyword Gap 匯出，在匯出前篩選至位置 1–20 及您的主題；僅使用正確的國家資料庫。
• Ahrefs（## Ahrefs）。
  • Site Explorer（有機關鍵字、熱門頁面）。
  • 內容缺口、連結交集。
  • 合理使用時機：需要同時分析內容與反向連結缺口時。
  • 節省成本策略：Top pages by traffic + Content Gap，限制在競爭者的前 50 頁。避免重複完整匯出。
• Similarweb（## Other paid tools）。總流量與管道組合估算（有機 vs 付費 vs 推薦）用於市場規模分析。
• DataForSEO SERP API（## DataForSEO）。精確、特定位置的 SERP 與功能解析，按呼叫次數計費且具規模化能力。當 WebSearch 樣本不夠精確時（本地、多城市、每日）使用。

切勿將供應商提供的流量或關鍵字數字呈現為實際測量值。它們是 [vendor data]/[estimate]，且可能相差數倍，尤其是對小型網站而言。

輸出

1. 競爭者地圖： 網域、類型（商業 / 發布者 / UGC）、在整個關鍵字集合中佔據前 10 名位置的比率、重疊最多的關鍵字。
2. 每個關鍵字的 SERP 表格： 意圖、主要格式、存在的功能、我們能否贏得（是 / 否 / 如何）。
3. 每個優先關鍵字的頁面比較摘要： 您的指標 vs 競爭者中位數、值得涵蓋的缺口詞組、遺漏的 schema/信任訊號、分配的行動。
4. 缺口清單： 競爭者排名而您未排名的關鍵字（免費樣本或付費匯出），進行分群後交給 seo-keywords/seo-strategy。
5. 排名躍進競爭者的變更記錄（Wayback 證據）。

陷阱與迷思

• 您的商業競爭者不一定是您的 SERP 競爭者。 請以 SERP 為準。
• 「他們排名高是因為頁面較長。」 這是相關性，而非因果關係。應符合意圖並添加新內容，而非填充字數。
• 逐字複製競爭者的標題會產出大眾化內容。應以更好的方式涵蓋缺口主題（第一手數據、工具、範例）。
• 供應商的 DR/DA/流量都是模型。一個「DA 較低」的網站排名比您高是正常的。
• WebSearch ≠ 使用者的即時 Google SERP（位置、個人化、AI 概述會有所不同）。若決策依賴於此，請在瀏覽器中重新檢查關鍵 SERP。
• 請勿積極抓取競爭者。 僅擷取少數頁面，遵守 robots.txt，並在遇到 CAPTCHA 時停止。

記錄工作

附加至 SEO-WORKLOG.md（${CLAUDE_PLUGIN_ROOT}/references/worklog.md）：

• 關鍵字集合與市場。
• 競爭者清單。
• 比較檔案。
• 缺口決策。
• 使用的付費工具單位 / 額度。
• 何時重新執行（每季一次，或在下一次核心更新之後）。