
Claude SEO 安裝部署完全指南從插件市場到手動安裝、卸載升級與故障排查【免費下載鏈接】claude-seoUniversal 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.項目地址: https://gitcode.com/GitHub_Trending/cl/claude-seo本篇技術(shù)指南以docs/INSTALLATION.md為核心骨架結(jié)合倉庫內(nèi)的install.sh、install.ps1、uninstall.sh、hooks/hooks.json、requirements.txt與tests/test_manifest_consistency.py等源碼實現(xiàn)系統(tǒng)講解 Claude SEO面向 Claude Code 的通用 SEO 分析技能在 macOS / Linux / Windows 三種平臺上的全部安裝路徑、目錄布局、驗證方法、卸載與升級流程以及常見故障的排查手段。讀完本文你將能夠在本地完整部署這一由 25 個子技能與 18 個子 Agent 組成的 SEO 工作臺并理解安裝腳本背后的版本鎖定、依賴管理與安全機制。前置條件在開始安裝前請確認(rèn)你的環(huán)境滿足以下要求組件要求說明Python3.10含 pip安裝腳本會顯式校驗版本低于 3.10 會直接報錯退出Git任意可用版本用于克隆倉庫與拉取指定 release tagClaude Code CLI已安裝并完成配置安裝完成后在 CLI 內(nèi)通過/seo命令調(diào)用技能Playwright可選用于截圖能力用于 SPA 渲染與截圖分析缺失時視覺分析回退到 WebFetchPython 版本校驗邏輯直接體現(xiàn)在 install.sh 中腳本先檢查python3與git是否存在再通過python3 -c import sys; ...探測主次版本號只有sys.version_info (3, 10)才繼續(xù)執(zhí)行。Windows 側(cè)的 install.ps1 則依次嘗試py -3、python3、python三個候選解釋器并會主動識別并拒絕 Microsoft Store 的 App execution alias 偽 Python。推薦路徑插件安裝Claude Code 1.0.33插件安裝是官方推薦的路徑只需兩步命令即可將技能納入 Claude Code 的插件體系獲得 hook 強制加載等手動安裝無法完全獲得的能力。在 Claude Code 內(nèi)部依次執(zhí)行/plugin marketplace add AgriciDaniel/claude-seo /plugin install claude-seoagricidaniel-claude-seo第一條命令把倉庫注冊為插件市場marketplace第二條命令以claude-seoagricidaniel-claude-seo的插件標(biāo)識安裝并激活技能。從源碼角度看插件安裝的額外價值在于 hook 機制倉庫 hooks/hooks.json 定義了PostToolUse鉤子當(dāng) Agent 執(zhí)行Edit或Write操作時會自動調(diào)用 hooks/run-python-hook.js 與 hooks/validate-schema.py 對寫入的 Schema 文件進(jìn)行實時校驗。這正是 install.sh 中那句提示的由來——手動安裝只能盡力復(fù)制 hook 文件而 hook 的真正強制執(zhí)行依賴插件清單plugin manifest加載因此若需要 hook 校驗?zāi)芰?yīng)優(yōu)先選擇插件安裝。手動安裝macOS / LinuxUnix快速安裝克隆后直接運行安裝腳本git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git bash claude-seo/install.sh--depth 1只拉取最新提交可顯著減少下載量。Review-then-run 替代方案對先審閱再執(zhí)行有安全偏好的用戶可以先把安裝腳本下載到本地審閱確認(rèn)滿意后再運行curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh install.sh cat install.sh # review bash install.sh # run when satisfied rm install.sh這一流程與該倉庫的安全理念一致install.sh在腳本末尾同樣提醒用戶 Inspect remote scripts before piping them to bashinstall.sh。手動安裝WindowsPowerShellgit clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1Windows 路徑刻意采用git clone而非irm | iex遠(yuǎn)程管道執(zhí)行因為 Claude Code 自身的安全防護(hù)會對管道式遠(yuǎn)程腳本執(zhí)行發(fā)出攔截告警。運行前請先審閱 install.ps1 的內(nèi)容。分步手動安裝通用流程若你希望完全掌控安裝過程可以按以下步驟手動操作第 1 步克隆倉庫git clone https://github.com/AgriciDaniel/claude-seo.git cd claude-seo第 2 步運行安裝器./install.sh第 3 步安裝 Python 依賴若安裝器未自動完成安裝器默認(rèn)會在~/.claude/skills/seo/.venv/創(chuàng)建虛擬環(huán)境并安裝依賴。若該步驟失敗可手動補裝# Option A: Use the venv ~/.claude/skills/seo/.venv/bin/pip install -r ~/.claude/skills/seo/requirements.txt # Option B: User-level install pip install --user -r ~/.claude/skills/seo/requirements.txt從 install.sh 的源碼可以看到依賴安裝遵循venv 優(yōu)先、--user回退策略先嘗試python3 -m venv創(chuàng)建獨立虛擬環(huán)境venv 內(nèi) pip 安裝失敗時自動回退到pip install --user若兩者都失敗腳本會打印手工安裝提示并把requirements.txt復(fù)制到技能目錄install.sh方便日后隨時重試。依賴清單 requirements.txt 采用有界版本鎖定 安全底線策略值得關(guān)注解析類beautifulsoup44.12.0,5.0.0、lxml6.1.1,7.0.0含 libxml2 安全補丁、trafilatura2.0.0,3.0.0無樣板內(nèi)容提取SPA 安全、htmldate發(fā)布日提取與courlanURL 輔助網(wǎng)絡(luò)類requests2.32.4,3.0.0與urllib32.7.0,3.0.0明確標(biāo)注修復(fù)了 CVE-2024-47081、CVE-2024-35195 及多個 urllib3 高危公告視覺類playwright1.59.0,2.0.0修復(fù) CVE-2025-59288、Pillow12.2.0,13.0.0報告生成類matplotlib、weasyprintPDF 導(dǎo)出、openpyxlExcel 導(dǎo)出Google API 類google-api-python-client、google-auth、google-analytics-data等供 seo-google 技能調(diào)用 GSC / PageSpeed / GA4 接口。第 4 步安裝 Playwright 瀏覽器可選用于視覺分析pip install playwright playwright install chromiumPlaywright 是可選項。未安裝時視覺分析會回退到 WebFetch 方案功能不受阻斷。安裝器在 install.sh 中也會嘗試自動執(zhí)行playwright install chromium失敗時僅打印警告并繼續(xù)。安裝目錄布局安裝器會把文件復(fù)制到以下位置組件路徑主技能orchestrator~/.claude/skills/seo/子技能~/.claude/skills/seo-*/子 Agent~/.claude/agents/seo-*.md從 install.sh 的復(fù)制邏輯可以還原更完整的安裝產(chǎn)物skills/seo/主技能目錄額外獲得schema/Schema 模板來自倉庫 schema/templates.json、pdf/參考文檔、scripts/共享腳本、hooks/hook 文件含執(zhí)行權(quán)限等子目錄skills/下所有含SKILL.md的子目錄被逐個復(fù)制為~/.claude/skills/name/agents/下所有seo-*.mdAgent 定義被復(fù)制到~/.claude/agents/extensions/下的可選擴展如 DataForSEO、Banana、Firecrawl按技能/Agent/參考文檔/腳本分類復(fù)制其中參考文檔與腳本會歸入~/.claude/skills/seo/extensions/ext_name/下。驗證安裝安裝完成后按如下步驟驗證啟動 Claude Codeclaude確認(rèn)技能已加載/seo若安裝成功應(yīng)看到幫助信息或 URL 輸入提示。此時即可運行seo audit url、seo technical url、seo schema url、seo geo url等命令完整命令清單見 skills/seo/SKILL.md。/seo audit會按編排邏輯并行派發(fā) seo-technical、seo-content、seo-schema、seo-sitemap、seo-performance、seo-visual、seo-geo 等子 Agent并在檢測到 Google API 憑據(jù)、本地商戶信號、反向鏈接 API、內(nèi)容策略信號等條件時追加對應(yīng) Agentskills/seo/SKILL.md。卸載插件安裝用戶的卸載/plugin uninstall claude-seoagricidaniel-claude-seo /plugin marketplace remove AgriciDaniel/claude-seo手動安裝用戶的卸載從一份全新的克隆中運行卸載器git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git bash claude-seo/uninstall.sh關(guān)于卸載uninstall.sh 的實現(xiàn)值得注意它采用glob 枚舉而非硬編碼列表set -euo pipefailshopt -s nullglob自動清除~/.claude/skills/seo、所有seo-*子技能目錄與所有seo-*.mdAgent 文件uninstall.sh。這意味著未來新增的子技能會被自動清理無需隨版本發(fā)布新卸載器官方也明確告誡不要手工維護(hù)rm列表倉庫自帶的卸載器才是權(quán)威來源。若當(dāng)前環(huán)境中沒有任何相關(guān)目錄或文件卸載器會提示Nothing to remove并引導(dǎo)插件用戶改用/plugin uninstall。升級到最新版本升級時官方建議優(yōu)先采用先下載審閱、再執(zhí)行的方式避免直接管道執(zhí)行遠(yuǎn)程腳本# Uninstall current version curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/uninstall.sh | bash # Install new version curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh | bash注意curl ... | bash屬于管道直執(zhí)行形式安全性較低僅為便利選項更穩(wěn)妥的做法是分兩步先下載腳本審閱確認(rèn)無誤后再執(zhí)行。版本鎖定機制install.sh 通過環(huán)境變量鎖定默認(rèn)安裝版本REPO_TAG${CLAUDE_SEO_TAG:-v2.2.0}腳本默認(rèn)克隆v2.2.0release tag而不是隨時漂移的main分支避免靜默更新帶來的意外變更。如需安裝main最新版可覆蓋環(huán)境變量CLAUDE_SEO_TAGmain bash install.sh這一默認(rèn) tag 并非隨意寫死測試 tests/test_manifest_consistency.py 中的test_install_scripts_default_tag_matches_plugin_version專門校驗install.sh與install.ps1的默認(rèn) tag 必須等于 plugin manifest 中的版本號否則 CI 直接失敗。同樣的測試還覆蓋了 plugin.json、marketplace.json、CITATION.cff、pyproject.toml 之間的版本三角校驗以及文檔聲明的子技能/子 Agent 數(shù)量必須與磁盤實際數(shù)量一致的一致性保障tests/test_manifest_consistency.py——這些機制共同保證用戶拿到的安裝器永遠(yuǎn)與當(dāng)前版本配套。故障排查Skill not found 錯誤確認(rèn)技能安裝在了正確位置ls ~/.claude/skills/seo/SKILL.md若文件不存在重新運行安裝器。Python 依賴錯誤手動安裝依賴pip install beautifulsoup4 requests lxml playwright Pillow urllib3 validators注意這是排查用的最小依賴集。完整運行全部技能含 PDF/Excel 報告、Google API、SPA 提取建議安裝 requirements.txt 中的完整清單命令為pip install -r ~/.claude/skills/seo/requirements.txt。Playwright 截圖錯誤安裝 Chromium 瀏覽器內(nèi)核playwright install chromiumUnix 權(quán)限錯誤確保腳本具有執(zhí)行權(quán)限chmod x ~/.claude/skills/seo/scripts/*.py安裝后的安全與維護(hù)建議版本固定手動安裝默認(rèn)鎖定v2.2.0taginstall.sh升級前先審閱 CHANGELOG 與本倉庫的 CHANGELOG.md卸載走官方腳本不要自行編寫rm列表使用倉庫自帶的 uninstall.sh其 glob 枚舉機制能自動覆蓋未來新增的技能與 Agent可選擴展按需啟用DataForSEO、Firecrawl、Banana 等擴展需要各自的賬號或 MCP 服務(wù)插件核心在無擴展?fàn)顟B(tài)下即可完整工作README.md網(wǎng)絡(luò)與離線說明免費層級不調(diào)用任何外部 API完全本地分析只有配置 Google API 憑據(jù)或擴展 MCP 服務(wù)后才會產(chǎn)生外部數(shù)據(jù)請求README.md。參考文檔安裝指南本文核心文檔Unix 安裝腳本 與 Windows 安裝腳本Unix 卸載腳本Python 依賴清單 與 項目元數(shù)據(jù)安裝一致性測試主技能編排說明 與 Hook 配置架構(gòu)文檔、命令參考 與 故障排查文檔【免費下載鏈接】claude-seoUniversal 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.項目地址: https://gitcode.com/GitHub_Trending/cl/claude-seo創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考