一個跑在 Claude Code 內的SEO 稽核外掛。
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。
Perceive
Analyze
Validate
Act
每條建議都附一個可證偽檢查—— 明確寫出「我們怎麼知道這條失敗了」的測試。
兩行 plugin 指令, 或一次 clone。
環境需求:Python 3.10+ 與 Claude Code CLI。Playwright Chromium(用於 SPA 渲染)與 Google API 憑證皆為選用,前者會自動安裝。最快的安裝方式是 Claude Code 的 plugin marketplace:在對話框直接執行以下兩行。
# 在 Claude Code 內執行
/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo手動安裝(Unix / macOS / Linux)
若偏好直接 clone,跑安裝腳本即可;Windows 改用 PowerShell 腳本。
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.shgit clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1每個 /seo 指令對應一個稽核領域。
所有功能都掛在 /seo 命名空間下。/seo audit 是入口——它並行派出多個專家 agent 跑完整站稽核;其餘指令則對單一領域做深度分析。下面列出核心指令。完整 25 條指令參考 docs/COMMANDS.md。實務上記住 audit、schema、geo、google、drift 就能涵蓋多數工作。
入口 · 01
/seo audit <url>
完整站台稽核
並行派出多個 sub-agent 跑全站稽核,偵測產業類型後彙整成帶優先級的行動清單。
頁面 · 02
/seo page <url>
單頁深度分析
針對單一 URL 做深入檢查,適合稽核後對重點頁面進一步診斷。
技術 · 03
/seo technical <url>
技術 SEO 九類
橫跨 9 大類別的技術 SEO 稽核:索引、可爬性、Core Web Vitals 等。
內容 · 04
/seo content <url>
E-E-A-T 內容品質
對照 2025 年 9 月品質評分指南評 E-E-A-T,含填充內容偵測與 AI 痕跡人性化。
結構化 · 05
/seo schema <url>
Schema 偵測與生成
偵測、驗證並生成 JSON-LD,涵蓋 Organization、Article、Product 等 15+ 種類型,並標出已淘汰 schema。
AI 搜尋 · 06
/seo geo <url>
GEO / AI Overviews
依 Google AI 優化指南評段落可引用性(最佳 134–167 字)、問句式標題與實體訊號。
在地 · 07
/seo local <url>
在地 SEO / GBP
稽核 Google Business Profile 訊號、各引用源 NAP 一致性與評論情緒,含 GBP 淘汰欄位偵測。
連結 · 08
/seo backlinks <url>
反向連結剖析
分析連結檔案輪廓,評估反向連結的來源與結構。
國際 · 09
/seo hreflang <url>
國際 SEO / i18n
國際化與 hreflang 稽核,含機器翻譯品質檢查與 DMA 同意模式診斷。
電商 · 10
/seo ecommerce <url>
電商 SEO 稽核
電商 SEO 與市集情報,含商品結構化資料驗證。
API · 11
/seo google [cmd]
Google API 整合
串接 GSC、PageSpeed、CrUX、GA4、Indexing API,Tier 0–3 憑證分級,免付費也能用。
監測 · 12
/seo drift <url>
變動監測
baseline / compare / history 三種子指令,用 SQLite 快照追蹤站台 SEO 隨時間的變化。
產出 · 13
/seo sitemap generate
Sitemap 生成
依稽核結果生成 sitemap,供提交與索引使用。
該用哪個指令?依目標選
| 你的目標 | 對應指令 |
|---|---|
| 第一次接觸這個網站,要一份全面體檢 | /seo audit |
| 讓內容更容易被 AI Overviews 引用 | /seo geo |
| 檢查與生成結構化資料(JSON-LD) | /seo schema |
| 串接 GSC / PageSpeed / GA4 取實測資料 | /seo google |
| 追蹤站台 SEO 隨時間的變化 | /seo drift baseline | compare |
讓稽核更準確的幾個做法。
以下技巧全部出自官方 README 與文件,不涉及未經證實的傳聞。重點是理解它的設計取向:並行、可證偽、本機優先。
先 audit,再分領域深挖
把 /seo audit <url> 當入口跑一次全站體檢,拿到帶優先級的清單後,再用 /seo schema、/seo geo 等指令對重點領域深入。audit 會自動偵測產業類型並並行派工。
來源 · 官方 README · Quick Start
用 GEO 模式對齊 AI 搜尋
/seo geo 依 Google AI 優化指南評估「段落可引用性」——最佳區塊落在 134–167 字、用問句式標題、強化實體訊號(Wikipedia、Reddit、YouTube、LinkedIn)。要被 AI Overviews 引用就跑這個。
來源 · 官方 README · AI-Search Alignment
接 Google API 換真實數據
/seo google 的憑證採 Tier 0–3 分級,即使不啟用任何付費服務,也能取得 PageSpeed、Search Console、CrUX、GA4 的實測資料,讓建議從推估變成有憑有據。
來源 · 官方 README · Google API Integration
用 drift 監測站台變化
/seo drift baseline 先存一份 SQLite 快照,日後用 compare 與 history 比對。把單次稽核變成可追蹤的時間序列,適合改版前後或定期回檢。
來源 · 官方 README · 核心指令
SPA 站台會自動用 Playwright 渲染
v2 的 Phase A 加入無頭渲染:Next.js、React、Vue 這類 SPA 會透過自動安裝的 Playwright Chromium 取得渲染後內容,避免只看到空殼 HTML 而誤判。
來源 · 官方 README · Version 2 Phase A
每條建議都讀「可證偽檢查」
報告裡每條建議都附四件事:第一性原理觀察、依賴關係、可證偽檢查、領先指標。實作前先看可證偽檢查——它直接告訴你之後該用什麼指標驗證這條到底有沒有效。
來源 · 官方 README · 方法論 10 原則
看 /seo audit 怎麼跑完一次全站稽核。
以下是一段示意流程:對一個電商網站跑 /seo audit。orchestrator 先偵測產業類型,並行派出多個專家 agent,各自回報後彙整成帶優先級的清單;接著用 /seo schema 補結構化資料、/seo geo 檢查 AI 搜尋就緒度,最後 /seo drift baseline 存基準。
$ You › /seo audit https://acme-shop.com
claude: claude-seo ›
Perceive → Analyze → Validate → Act
render: SPA 偵測為 Next.js → 用 Playwright Chromium 取渲染後內容
hl: 優先處理(P0)
1. Product schema 缺 offers.priceValidUntil → 多數商品頁
2. LCP p75 = 4.1s(CrUX)→ hero 圖未上 priority
3. 分類頁標題非問句式 → AI Overviews 引用率低
「修正後,Rich Results Test 對 Product 應回報 0 錯誤;
GSC 的『商品』增強報告兩週內有效項目應上升。」
ok: [wrote ./reports/acme-shop/audit-2026-06-16.md]
ok: 25 sub-skill · 18 agent · 完成於 12 分鐘]
$ You › /seo schema https://acme-shop.com/p/widget-x
claude: 已生成完整 Product JSON-LD(含 offers、aggregateRating);
$ You › /seo drift baseline https://acme-shop.com
ok: [SQLite 快照已存 · 下次用 /seo drift compare 比對變化]
並行派出 15 個 agent、12 分鐘完成, 每條建議都附一個之後可驗證的 可證偽檢查與領先指標。
這段流程為什麼值得拆解
重點不在「AI 幫你看 SEO」,而在結構。orchestrator 先偵測產業類型,再依領域並行派出專家 agent;SPA 站台會先用 Playwright 取得渲染後內容,避免把空殼 HTML 當成全部。最後彙整成一份帶優先級的報告,而不是一堆零散告警。
每條建議都附可證偽檢查與領先指標,意味著它逼你在實作前就想好「怎麼知道這條有效」。這把 SEO 從直覺調整,變成可追蹤、可驗收的工作項——也是它與一般稽核工具最大的差別。
知道它的邊界再上路。
用 MCP 擴充接上實時資料。
核心稽核本機就能跑。要讓資料更深,claude-seo 提供 8 個選用 MCP 擴充,各自透過 extensions/[service]/install.sh 安裝並獨立管理憑證。
選用 MCP 擴充
**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 原則的完整方法論框架。
每次稽核走 Perceive → Analyze → Validate → Act, 錨定在 10 條原則上;每條建議都能被驗收。