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