AgriciDaniel/claude-seo

Claude SEO 是給 Claude Code 用的開源 SEO 稽核外掛,丟一個網址進去就會跑完整站檢查並產出依優先順序排好的行動清單。它由 26 個子技能與 19 個專責 agent 組成,最多 17 個 agent 同時分析技術 SEO、內容品質、Schema.org、AI 搜尋與本機、電商、多語系站台。跟一般 SEO 稽核軟體相比,它跑在使用者自己的機器上,報告以 Markdown、PDF、JSON 存在本機,並把 AI 搜尋(GEO)與 agent readiness 納入檢查項目。
AI 寫程式與 SkillsPython★ 23,146

專案簡介

以上內容由 AI 根據官方 README 整理,未經實測;指令以官方文件為準。

原始描述

Universal SEO skill for Claude Code. 26 sub-skills + 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.

AI 規格

支援的模型供應商Anthropic
本機執行不可以,需要雲端 API
費用外掛本體免費,需自備 Claude Code 方案;部分擴充需自備第三方 API 金鑰(如 DataForSEO、Ahrefs、Seranking、Profound、Firecrawl、Bing Webmaster)。
可搭配的工具Claude Code

主要功能

  • 26 個子技能與 19 個專責 agent,最多 17 個 agent 平行稽核同一站台
  • 技術 SEO 檢查涵蓋可爬取性、索引、sitemap、robots.txt、重新導向與 Core Web Vitals
  • Schema.org 標記的偵測、驗證與產生,並有 hook 在寫入時檢查
  • GEO 分析評估頁面被 AI Overviews、ChatGPT、Perplexity、Gemini 引用的機會
  • 本機、電商與多語系 SEO 檢查,含 GBP、評論、map pack 與 hreflang
  • 報告輸出為 Markdown,並可經 Google API 產生 PDF 報告

系統需求

  • Python 3.11 至 3.14,需有 pip
  • Git,用於複製倉庫
  • 已安裝並設定好的 Claude Code CLI
  • Playwright Chromium 為選用,只有 SPA 渲染與截圖需要

安裝方式

  1. 在 Claude Code 內加入外掛 marketplace

    /plugin marketplace add AgriciDaniel/claude-seo
  2. 安裝 claude-seo 外掛

    /plugin install claude-seo@agricidaniel-claude-seo
  3. 建立隔離的 Python venv 與 Chromium

    /seo setup
  4. 手動安裝時先淺層複製倉庫

    git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
  5. 在 macOS 或 Linux 執行安裝腳本

    bash claude-seo/install.sh
  6. 在 Windows PowerShell 執行安裝腳本

    powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1
  7. 驗證受管理的執行環境

    ~/.claude/skills/seo/scripts/claude-seo doctor

設定教學

外掛安裝後要跑一次 /seo setup 建立隔離的 Python venv 與 Chromium,之後用 /seo doctor 唯讀確認。手動安裝則由 install.sh 或 install.ps1 代為處理,不需要另外設定環境變數;Windows 若 Python 偵測有問題可設 CLAUDE_SEO_PYTHON 指定執行檔。

環境變數

變數用途必填範例/預設值
CLAUDE_SEO_PYTHON指定 Windows 安裝時要使用的 Python 執行檔路徑,需為 3.11 至 3.14。否—

主要設定檔

部署方式

外掛安裝(Claude Code 1.0.33+,建議路徑)

  1. 在 Claude Code 內加入 marketplace

    /plugin marketplace add AgriciDaniel/claude-seo
  2. 安裝 claude-seo 外掛

    /plugin install claude-seo@agricidaniel-claude-seo
  3. 一次性建立隔離的 Python venv 與 Chromium

    /seo setup
  4. 唯讀檢查執行環境是否就緒

    /seo doctor

手動安裝(macOS、Linux)

  1. 淺層複製倉庫

    git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
  2. 執行安裝腳本

    bash claude-seo/install.sh
  3. 驗證受管理的執行環境

    ~/.claude/skills/seo/scripts/claude-seo doctor

手動安裝(Windows PowerShell)

  1. 淺層複製倉庫

    git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
  2. 執行 PowerShell 安裝腳本

    powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1

設定內容整理自 repository 內的設定檔與文件,未經實測;變數名稱與指令以官方檔案為準。

適合用途

  • 想替每個客戶定期跑稽核、並在兩次稽核之間監控變化的 SEO 代理商
  • SaaS、出版或電商公司的 in-house SEO 團隊,想在每次審查前多一輪檢查
  • 想在第一次通話就拿出實際分數與修正清單的自由接案 SEO 顧問
  • 要檢查網站對 AI 搜尋與 AI agent 存取是否友善的開發者

常見問題

裝好之後要怎麼確認能用?

在 Claude Code 輸入 /seo 會列出所有指令;跑 /seo doctor 可唯讀檢查執行環境是否就緒。若指令不存在,先確認 ~/.claude/skills/seo/SKILL.md 存在,或重新安裝外掛。

執行需要哪些前置條件?

需要 Python 3.11 到 3.14 與 pip,以及 Git 和已設定好的 Claude Code CLI。Playwright Chromium 為選用,只有 SPA 渲染與截圖才需要,安裝失敗不會中斷核心功能。

Python 套件裝在哪裡?可以自己 pip install 嗎?

依賴會裝在 ~/.claude/skills/seo/.venv/ 這個隔離的虛擬環境,不會裝到全域或使用者層級。遇到 ModuleNotFoundError 時,外掛安裝請跑 /seo doctor 與 /seo setup,手動安裝則跑 ~/.claude/skills/seo/scripts/claude-seo setup。

要怎麼移除?

外掛安裝用 /plugin uninstall claude-seo@agricidaniel-claude-seo 與 /plugin marketplace remove AgriciDaniel/claude-seo。手動安裝則從新的 clone 執行 uninstall.sh,它會清掉子技能、子代理與 settings.json 裡的 MCP 項目。

為什麼完整稽核跑很久?

完整稽核最多爬 500 頁,大站會比較久;子代理會平行分析來加速。只想快速檢查時可改用 /seo page 針對單一 URL。

出現 Agent 'seo-technical' not found 怎麼辦?

外掛安裝的子代理是從外掛載入,不是放在 ~/.claude/agents/。出現 Agent not found 時先用 /plugin list 確認並重新安裝 claude-seo@agricidaniel-claude-seo。

公開標籤

aiai-seoclaude-codeclaude-code-skillmarketing-automationopen-sourceseo
Stars 等欄位只是 GitHub 快照,不保證品質、安全性或商用適用性。