Claude SEO：面向 Claude Code 的並行稽核外掛
Claude Code 的通用 SEO 技能。 25 個子技能 + 18 個子代理，涵蓋技術 SEO、E-E-A-T、模式、GEO/AEO、反向連結、本地 SEO、地圖智慧、語義聚類、電子商務 SEO、國際 SEO、Google API 和 PDF/Excel 報告。可選的 DataForSEO、Firecrawl 和 Banana 擴充。
秒懂
- 它是什麼？
- 一個開源的 Claude Code SEO 分析外掛，執行 25 個子技能和 18 個代理，產生優先排序且可證偽的行動計畫。 本文聚焦其核心介面、部署邊界、版本訊號與實際核驗方式。
- 適合誰用？
- Claude SEO 是一個 MIT 授權的外掛，預設無需第三方 API 即可運作，支援可選的 Google API 層級和 MCP 擴充，並記錄了其在 SPA 水合和本地資料方面的限制。 適合已能提供相容執行環境、願意依 AgriciDaniel/claude-seo README 逐項核對的人；不適合把文件摘要當成生產承諾的團隊。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 4 天前。
- 用什麼語言寫的？
- 主要是 Python（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月15日）與我們的分析，不構成法律意見。
開源專案深度解析
技能範圍：25 個子技能和 18 個代理
根據 README，Claude SEO 是一個面向 Claude Code 的開源 SEO 分析外掛。它並行執行 25 個子技能和 18 個專業代理，涵蓋技術 SEO、內容品質（E-E-A-T）、Schema.org 標記、AI 搜尋最佳化（GEO）、本地 SEO、電商和國際 SEO。每次稽核都會產生一個優先排序的行動計畫，其中每條建議都包含其所依據的第一性原理觀察、依賴關係、明確的「我們如何知道它失敗了？」檢查以及一個領先指標。該儲存庫提供兩個版本：一個 MIT 授權的公開版本，以及一個需要會員資格的 AI Marketing Hub Pro 社群私有鏡像。README 並未列出確切的 25 個子技能或 18 個代理清單；該清單位於原始碼樹中。
claude-seo 第 1 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 claude-seo、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 AgriciDaniel/claude-seo 第 1 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 AgriciDaniel/claude-seo 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agricidaniel-claude-seo-deep-analysis 第 1 節的具體核對點是 技能範圍：25 個子技能和 18 個代理。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
安裝路徑與設定命令
安裝遵循兩種文件化路徑之一。對於 Claude Code 1.0.33 及更高版本，外掛市集路徑為一次性 `/plugin marketplace add AgriciDaniel/claude-seo`，然後 `/plugin install claude-seo@agricidaniel-claude-seo`，最後執行 `/seo setup`。設定步驟會在 Claude 的持久化外掛資料中建立隔離的 Python 環境並安裝 Playwright Chromium；`/seo doctor` 在不變更系統的情況下檢查就緒狀態。Unix 上的手動安裝使用 `git clone --depth 1` 和 `bash claude-seo/install.sh`；Windows 使用 PowerShell 指令碼。README 解釋為何優先使用 git clone 而非管道遠端指令碼，因為 Claude Code 的安全防護會將 `irm ... | iex` 標記為供應鏈風險。安裝指令碼也會提供安裝 Chromium 的選項，除非需要 SPA 渲染，否則這是可選的。
claude-seo 第 2 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 claude-seo、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 AgriciDaniel/claude-seo 第 2 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 AgriciDaniel/claude-seo 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agricidaniel-claude-seo-deep-analysis 第 2 節的具體核對點是 安裝路徑與設定命令。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
命令集及其輸出格式
根據 README，該外掛在編排器、子技能和八個 MCP 擴充中暴露了 32 個使用者可呼叫的 `/seo` 命令。命令表列出了例如 `/seo audit <url>` 用於帶有並行子代理委派的完整站點稽核，`/seo page <url>` 用於深度單頁分析，`/seo schema <url>` 用於 Schema.org 偵測和驗證，`/seo geo <url>` 用於 AI 搜尋最佳化，以及 `/seo sitemap generate` 用於產生站點地圖。輸出是真實的 Markdown 報告；README 展示了一次 schema 稽核的前 50 行，其中包括包含 JSON-LD 塊數量、總體評分和逐屬性驗證說明的摘要表。完整站點稽核還可以透過 WeasyPrint 和 matplotlib 產生 PDF，大約 32 個 A4 頁面。
claude-seo 第 3 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 claude-seo、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 AgriciDaniel/claude-seo 第 3 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 AgriciDaniel/claude-seo 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agricidaniel-claude-seo-deep-analysis 第 3 節的具體核對點是 命令集及其輸出格式。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
方法論：十項原則與失敗檢查
README 的方法論部分描述了一個由四個階段組成的 10 項原則框架：PERCEIVE（觀察和傾聽）、ANALYZE（思考和連接）、VALIDATE（感受和接受）以及 ACT（創造和成長）。每條發出的建議都包含四個欄位：其所依據的第一性原理觀察、與其他建議的依賴關係、一個「我們如何知道它失敗了？」檢查以及一個用於監控的領先指標。這種結構就是 README 所稱的「可證偽，而非宣傳」。完整方法論記錄在參考檔案中，但 README 沒有復現完整的思維框架。
claude-seo 第 4 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 claude-seo、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 AgriciDaniel/claude-seo 第 4 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 AgriciDaniel/claude-seo 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agricidaniel-claude-seo-deep-analysis 第 4 節的具體核對點是 方法論：十項原則與失敗檢查。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
架構與無頭渲染
在架構上，Claude SEO 遵循 Agent Skills 標準，採用三層設計：指令、編排和執行。技能和代理從 `skills/seo-*/` 和 `agents/seo-*.md` 自動發現。編排器 `skills/seo/SKILL.md` 負責行業偵測（SaaS、本地、電商、出版者、代理機構）、並行子代理排程（最多同時 15 個），以及透過 10 項原則框架進行綜合。版本 2 新增了一個使用 Playwright Chromium、trafilatura 和 htmldate 的共享無頭渲染器，並提供了對 SPA 的自動偵測模式。README 指出一個已知限制：具有捲動繫結水合或互動後內容取得的頁面可能會產生噪音發現，並建議針對這些邊緣情況手動比較 Playwright 快照與原始 HTML 子代理的結果。
claude-seo 第 5 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 claude-seo、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 AgriciDaniel/claude-seo 第 5 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 AgriciDaniel/claude-seo 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agricidaniel-claude-seo-deep-analysis 第 5 節的具體核對點是 架構與無頭渲染。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
Google API 層級、擴充與已知限制
Claude SEO 無需任何 API 金鑰即可運作。文件記錄了一個四層憑證系統：第 0 層使用 API 金鑰取得 PageSpeed Insights、CrUX 和 CrUX 歷史資料；第 1 層透過 OAuth 或服務帳戶新增 Search Console 和 Indexing API；第 2 層新增 GA4 自然流量資料；第 3 層新增 Ads Keyword Planner。憑證儲存在 `~/.config/claude-seo/` 下，權限為 `0o600`。README 指出，如果沒有這些憑證，Core Web Vitals 僅為實驗室估算，索引狀態則從頁面級訊號推斷。可選的 MCP 擴充包括 DataForSEO、Firecrawl、用於影像產生的 Banana、Ahrefs、SE Ranking、Profound、Bing Webmaster 和 Unlighthouse。限制部分還提到，免費層級預設不進行任何第三方 API 呼叫，並且該外掛採用 MIT 授權且無遙測。
claude-seo 第 6 章的這個邊界需要在實際專案中單獨檢查。先以 README 明列的 claude-seo、main 分支與目前素材記錄的版本訊號建立測試目錄，逐項對照輸入、輸出和錯誤處理。這樣能分辨文件承諾、範例行為與自己加入的整合程式，不會把倉庫統計或描述文字誤當成測試結果。
對 AgriciDaniel/claude-seo 第 6 章而言，最有價值的觀察是功能是否在既有依賴與目標平台上保持可追蹤。請保留實際命令的終端輸出、涉及的檔案路徑和失敗步驟；若 README 沒有說明某個預設值，就標記為未說明，回到 AgriciDaniel/claude-seo 的原始碼、Release 與 issue 查證，而不是自行補出保證。
agricidaniel-claude-seo-deep-analysis 第 6 節的具體核對點是 Google API 層級、擴充與已知限制。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
編輯結論
Claude SEO 是一個 MIT 授權的外掛，預設無需第三方 API 即可運作，支援可選的 Google API 層級和 MCP 擴充，並記錄了其在 SPA 水合和本地資料方面的限制。 適合已能提供相容執行環境、願意依 AgriciDaniel/claude-seo README 逐項核對的人；不適合把文件摘要當成生產承諾的團隊。先在隔離目錄依專案自己的入口跑最小案例，檢查 claude-seo 的實際輸出、錯誤訊息與設定檔，再決定是否接入正式流程。
社群筆記