claude-seo 是給 Claude Code 用的開源 SEO 外掛,MIT 授權。它把一次網站稽核拆成 25 個 sub-skill 與 18 個專家 agent,最多 15 個並行執行,涵蓋技術 SEO、E-E-A-T 內容品質、Schema、GEO/AEO、在地與電商 SEO,10–15 分鐘產出帶優先級的 Markdown 報告。每條建議都附「可證偽檢查」與監測用的領先指標。
claude-seo 由 Agrici Daniel 維護,是一個 MIT 授權的 Claude Code SEO 外掛。它的核心是把「網站 SEO 稽核」這件事拆成 25 個 sub-skill 與 18 個專家 agent,在一次指令裡並行派工——技術 SEO、E-E-A-T 內容品質、Schema.org、GEO/AEO(AI 搜尋優化)、在地 SEO、電商 SEO、國際化 hreflang,各由專屬 agent 處理,最後彙整成一份帶優先級的 Markdown 報告。
它不是新的 SaaS,也不需要逐網域付費。技能與 agent 從 skills/seo-*/ 與 agents/seo-*.md 目錄自動探索;當你輸入 /seo audit <url>,orchestrator 會先偵測產業類型,再並行派出最多 15 個 agent,最後做 synthesis。整套採三層架構:directive(指令層)、orchestration(調度層)、execution(執行層)。
與一般 SEO 工具的差別在方法論。每次稽核走 Perceive → Analyze → Validate → Act 四個階段,錨定在 10 條原則上。每條建議都附四件事:第一性原理觀察、依賴關係、可證偽檢查(「我們怎麼知道這條失敗了?」)、以及監測進度的領先指標。完整框架寫在 skills/seo/references/thinking-framework.md。
環境需求:Python 3.10+ 與 Claude Code CLI。Playwright Chromium(用於 SPA 渲染)與 Google API 憑證皆為選用,前者會自動安裝。最快的安裝方式是 Claude Code 的 plugin marketplace:在對話框直接執行以下兩行。
若偏好直接 clone,跑安裝腳本即可;Windows 改用 PowerShell 腳本。
bash claude-seo/uninstall.sh。
所有功能都掛在 /seo 命名空間下。/seo audit 是入口——它並行派出多個專家 agent 跑完整站稽核;其餘指令則對單一領域做深度分析。下面列出核心指令。完整 25 條指令參考 docs/COMMANDS.md。實務上記住 audit、schema、geo、google、drift 就能涵蓋多數工作。
| 你的目標 | 對應指令 |
|---|---|
| 第一次接觸這個網站,要一份全面體檢 | /seo audit |
| 讓內容更容易被 AI Overviews 引用 | /seo geo |
| 檢查與生成結構化資料(JSON-LD) | /seo schema |
| 串接 GSC / PageSpeed / GA4 取實測資料 | /seo google |
| 追蹤站台 SEO 隨時間的變化 | /seo drift baseline | compare |
以下技巧全部出自官方 README 與文件,不涉及未經證實的傳聞。重點是理解它的設計取向:並行、可證偽、本機優先。
把 /seo audit <url> 當入口跑一次全站體檢,拿到帶優先級的清單後,再用 /seo schema、/seo geo 等指令對重點領域深入。audit 會自動偵測產業類型並並行派工。
/seo geo 依 Google AI 優化指南評估「段落可引用性」——最佳區塊落在 134–167 字、用問句式標題、強化實體訊號(Wikipedia、Reddit、YouTube、LinkedIn)。要被 AI Overviews 引用就跑這個。
/seo google 的憑證採 Tier 0–3 分級,即使不啟用任何付費服務,也能取得 PageSpeed、Search Console、CrUX、GA4 的實測資料,讓建議從推估變成有憑有據。
/seo drift baseline 先存一份 SQLite 快照,日後用 compare 與 history 比對。把單次稽核變成可追蹤的時間序列,適合改版前後或定期回檢。
v2 的 Phase A 加入無頭渲染:Next.js、React、Vue 這類 SPA 會透過自動安裝的 Playwright Chromium 取得渲染後內容,避免只看到空殼 HTML 而誤判。
來源 · 官方 README · Version 2 Phase A報告裡每條建議都附四件事:第一性原理觀察、依賴關係、可證偽檢查、領先指標。實作前先看可證偽檢查——它直接告訴你之後該用什麼指標驗證這條到底有沒有效。
來源 · 官方 README · 方法論 10 原則
以下是一段示意流程:對一個電商網站跑 /seo audit。orchestrator 先偵測產業類型,並行派出多個專家 agent,各自回報後彙整成帶優先級的清單;接著用 /seo schema 補結構化資料、/seo geo 檢查 AI 搜尋就緒度,最後 /seo drift baseline 存基準。
重點不在「AI 幫你看 SEO」,而在結構。orchestrator 先偵測產業類型,再依領域並行派出專家 agent;SPA 站台會先用 Playwright 取得渲染後內容,避免把空殼 HTML 當成全部。最後彙整成一份帶優先級的報告,而不是一堆零散告警。
每條建議都附可證偽檢查與領先指標,意味著它逼你在實作前就想好「怎麼知道這條有效」。這把 SEO 從直覺調整,變成可追蹤、可驗收的工作項——也是它與一般稽核工具最大的差別。
AgriciDaniel/claude-seo 穩定且無需會員;私有 AI-Marketing-Hub/claude-seo 提供早期功能,需 Pro 社群會員。確認你裝的是哪一個。
核心稽核本機就能跑。要讓資料更深,claude-seo 提供 8 個選用 MCP 擴充,各自透過 extensions/[service]/install.sh 安裝並獨立管理憑證。
1. DataForSEO。提供 SERP 資料、關鍵字研究、反向連結與 AI 可見度。
2. Firecrawl。全站爬取與 URL 探索,適合大型站台的內容盤點。
3. Banana。AI 圖片生成——OG 預覽圖、部落格主視覺、資訊圖。
4. v2 新增。Ahrefs、SE Ranking、Profound、Bing Webmaster、Unlighthouse 五個新擴充,補強連結、排名、AI 可見度與效能資料。
v2 的 Phase A–F 大幅擴充了能力:SPA 渲染、QRG 對齊的內容閘門、Core Web Vitals 深度(LCP 子項、Speculation Rules、IndexNow)、Schema 完整度、AI 搜尋重構、在地與國際化打磨。測試覆蓋達 271 個通過測試(較 v1.9.9 增加 5.4 倍),含 83 個 SSRF 與 DNS rebinding 繞過測試。
① docs/COMMANDS.md——完整 25 條指令參考。
② github.com/AgriciDaniel/claude-seo——原始碼、安裝與架構文件。
③ skills/seo/references/thinking-framework.md——四階段、10 原則的完整方法論框架。