【免费下载链接】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点击查看免费下载导读本篇技术指南基于 claude-seo 仓库的 docs/ARCHITECTURE.md 展开完整剖析该插件的模块化架构25 个子技能21 核心 1 编排器 1 框架集成 2 扩展镜像、18 个子 Agent15 核心 1 框架集成 2 扩展镜像如何组织、如何被编排器并行调度、质量门禁如何生效以及扩展DataForSEO / Banana / Firecrawl如何通过 MCP 以可选安装、供应链锁定版本的方式接入。读完本文你将掌握这套 Claude Code 插件体系的目录约定、组件格式SKILL.md / Agent frontmatter、完整审计编排流程、扩展机制与二次开发路径并能在自己的项目中复用它。一、总体架构遵循 Anthropic 官方 Skill 规范的模块化设计claude-seo 的核心设计原则是遵循 Anthropic 官方 Claude Code Skill 规范采用编排器 专用子技能 并行子 Agent的三层模块化架构。架构文档开篇即阐明其定位见 docs/ARCHITECTURE.md不是一个大而全的单一技能而是一个可组合、可裁剪的技能集群。这种设计带来三个直接收益关注点分离技术 SEO、内容质量、Schema、Sitemap、图片、GEO、本地 SEO 等各自独立成技能互不耦合按需加载主编排器 SKILL.md 保持精简参考资料references/按需加载避免把整个插件的说明塞进上下文并行执行审计时多个子 Agent 并发运行互不阻塞最后统一聚合。从 skills/seo/SKILL.md 的 frontmatter 可以看到该技能的元信息name: seo、user-invocable: true、argument-hint: [command] [url]、版本2.2.0并声明其编排范围——24 个子技能21 核心 1 框架集成 2 扩展镜像与 18 个子 Agent另外 Firecrawl 作为独立可选扩展存在。二、目录结构技能、Agent 与参考文件的物理布局架构文档给出了插件在用户机器上的标准安装布局。安装后插件位于~/.claude/plugins/.../claude-seo/或传统安装路径~/.claude/skills/seo/结构如下~/.claude/plugins/.../claude-seo/ ├── skills/ │ ├── seo/ # Main orchestrator │ │ ├── SKILL.md │ │ └── references/ # On-demand reference files (12 files) │ │ │ ├── seo-audit/ # Full site audit (parallel subagents) │ ├── seo-page/ # Single page analysis │ ├── seo-technical/ # Technical SEO (9 categories) │ ├── seo-content/ # E-E-A-T and content quality │ ├── seo-content-brief/ # Competitive content brief generation │ ├── seo-schema/ # Schema markup detection and generation │ ├── seo-sitemap/ # XML sitemap analysis and generation │ ├── seo-images/ # Image optimization analysis │ ├── seo-geo/ # AI search optimization (GEO) │ ├── seo-local/ # Local SEO (GBP, citations, reviews) │ ├── seo-maps/ # Maps intelligence (geo-grid, GBP audit) │ ├── seo-backlinks/ # Backlink profile analysis │ ├── seo-cluster/ # Semantic topic clustering (SERP-based) │ ├── seo-sxo/ # Search Experience Optimization │ ├── seo-drift/ # SEO drift monitoring (baselines) │ ├── seo-ecommerce/ # E-commerce SEO (product schema, marketplaces) │ ├── seo-hreflang/ # International SEO and hreflang │ ├── seo-plan/ # Strategic SEO planning (industry templates) │ ├── seo-programmatic/ # Programmatic SEO at scale │ ├── seo-competitor-pages/ # Competitor comparison page generation │ ├── seo-google/ # Google SEO APIs (GSC, PSI, CrUX, GA4) │ ├── seo-flow/ # FLOW framework integration (CC BY 4.0) │ ├── seo-dataforseo/ # DataForSEO MCP mirror (extension surface) │ └── seo-image-gen/ # Banana MCP mirror (extension surface) │ └── agents/ ├── seo-technical.md # Crawlability, indexability, security ├── seo-content.md # E-E-A-T, readability, thin content ├── seo-schema.md # Structured data validation ├── seo-sitemap.md # Sitemap quality gates ├── seo-performance.md # Core Web Vitals ├── seo-visual.md # Screenshots, mobile rendering ├── seo-geo.md # AI crawler access, citability ├── seo-local.md # GBP signals, NAP, reviews ├── seo-maps.md # Geo-grid, competitor radius mapping ├── seo-backlinks.md # Moz, Bing Webmaster, Common Crawl ├── seo-cluster.md # Semantic clustering analysis ├── seo-sxo.md # Page-type, user stories, personas ├── seo-drift.md # Baseline comparison, regression detection ├── seo-ecommerce.md # Product schema, marketplace intelligence ├── seo-google.md # GSC, PSI, CrUX, GA4 analyst ├── seo-flow.md # FLOW framework prompt selection ├── seo-dataforseo.md # DataForSEO MCP mirror └── seo-image-gen.md # Banana MCP mirror在仓库中skills/目录直接对应上表中的核心技能agents/目录存放 18 个 Agent 文件extensions/目录存放三个可选扩展dataforseo / banana / firecrawl它们各自独立携带 install / uninstall 脚本与文档。架构文档强调所有seo-{name}.mdAgent 文件是扁平存放的而技能则按seo-{name}/SKILL.md目录组织这一约定贯穿全插件。三、组件类型三种基础构件的标准格式3.1 Skills技能技能是带有 YAML frontmatter 的 Markdown 文件frontmatter 声明能力与触发条件正文承载指令与文档。架构文档给出的标准格式为--- name: skill-name description: When to use this skill. Include activation keywords and concrete use cases. --- # Skill Title Instructions and documentation...仓库中的真实实现与之一致。以 skills/seo/SKILL.md 为例其 frontmatter 额外扩展了user-invocable、argument-hint、license、metadata作者、版本2.2.0、分类description字段写得尤为精细——它列举了SEO、audit、schema、Core Web Vitals、sitemap、E-E-A-T、AI Overviews、GEO、technical SEO、content quality、page speed、structured data等激活关键词这是 Claude Code 技能路由模型自动选择技能的关键输入。因此编写新技能时description 应同时包含适用场景 激活关键词 具体用例这直接决定模型能否在正确时机调用它。3.2 Subagents子 Agent子 Agent 是拥有独立上下文与工具集的专职工作者可被编排器委派任务。架构文档给出的格式为--- name: agent-name description: What this agent does. tools: Read, Bash, Write, Glob, Grep --- Instructions for the agent...仓库实现更进一步。以 agents/seo-technical.md 为例它声明了model: sonnet指定模型档位与maxTurns: 20限制最大轮数并在注释中说明Write工具是审计报告/数据文件输出所必需的--- name: seo-technical description: Technical SEO specialist. Analyzes crawlability, indexability, security, URL structure, mobile optimization, Core Web Vitals, and JavaScript rendering. model: sonnet maxTurns: 20 tools: Read, Bash, Write, Glob, Grep # Write needed for report/data file output ---正文部分则定义该 Agent 的 7 步工作流抓取页面 → 检查 robots.txt 与 sitemap → 分析 meta/canonical/安全头 → 评估 URL 结构与重定向链 → 移动端友好性 → CWV 潜在问题 → JS 渲染要求并给出结构化输出契约按类别的 pass/fail、0-100 技术分、Critical → High → Medium → Low 的优先级问题清单。3.3 Reference Files参考文件参考文件存放静态知识在需要时按需加载避免撑爆主技能。典型例子skills/seo/references/下有 12 个文件如cwv-thresholds.md、schema-types.md、eeat-framework.md、quality-gates.md、local-seo-signals.md等skills/seo/SKILL.md明确要求按需加载不要在启动时全部加载见 skills/seo/SKILL.md。四、编排流程从用户请求到审计报告的完整链路4.1 完整审计/seo audit架构文档绘制了完整的编排链路图。简化并保留核心语义如下User request │ ▼ ┌──────────────────┐ │ seo │ Main orchestrator (skills/seo/SKILL.md) └────────┬─────────┘ │ Detects business type and signals │ Spawns subagents in parallel │ ┌────┴────┬────────┬────────┬────────┬────────┬────────┐ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ │tech │ │content│ │schema │ │sitemap│ │perf │ │visual │ │geo │ └───┬───┘ └───┬───┘ └───┬───┘ └───┬───┘ └───┬───┘ └───┬───┘ └───┬───┘ │ │ │ │ │ │ │ └─────────┴─────────┴────┬────┴─────────┴─────────┴─────────┘ │ │ Conditional spawns: │ - seo-google (Google API creds detected) │ - seo-local (local business detected) │ - seo-maps (local DataForSEO MCP) │ - seo-backlinks (Moz/Bing/CC available) │ - seo-cluster (content strategy signals) │ - seo-sxo (always in full audits) │ - seo-drift (baseline exists for URL) │ - seo-ecommerce (e-commerce detected) ▼ ┌────────────────┐ │ Aggregate │ │ Results │ └────────┬───────┘ │ ▼ ┌────────────────┐ │ Generate │ │ Health Score │ │ Action Plan │ └────────────────┘从源码看这套流程被落实为 skills/seo/SKILL.md 的 15 步编排逻辑核心步骤为检测业务类型SaaS / 本地服务 / 电商 / 出版 / 代理 / 其他并行 spawn 常驻子 Agentseo-technical、seo-content、seo-schema、seo-sitemap、seo-performance、seo-visual、seo-geo条件 spawn每一条都有明确的可检测触发条件Google API 凭据存在python3 scripts/google_auth.py --check→ spawnseo-google检测到本地业务 → spawnseo-local本地业务且DataForSEO MCP 可用 → spawnseo-maps外链 API 已配置python3 scripts/backlinks_auth.py --check→ spawnseo-backlinksFirecrawl MCP 可用 → 先用firecrawl_map发现全站 URL检测到内容策略信号博客、支柱页、话题簇→ spawnseo-cluster检测到电商 → spawnseo-ecommerce该 URL 已有漂移基线python3 scripts/drift_history.py url→ spawnseo-driftseo-sxo始终参与完整审计聚合所有结果生成统一报告并计算 SEO Health Score0-100通过10 原则思考框架做综合PERCEIVE → ANALYZE → VALIDATE → ACT详见 skills/seo/references/thinking-framework.md把发现归入 Critical / High / Medium / Low 四个优先级桶生成带依赖排序与可证伪性falsifiability的优先行动清单最后提供 PDF 报告入口/seo google report full。值得注意的是编排器对每条产出建议都要求附带四类元信息见 skills/seo/SKILL.md它所依赖的第一性观察THINK、与其他建议的依赖/解锁关系CONNECT-system、显式的如何判断它失效检验ACCEPT、以及无需重跑审计即可监控的前瞻指标GROW。4.2 审计执行细节seo-audit子技能skills/seo-audit/SKILL.md 定义了完整审计的执行过程它补充了架构文档未展开的运行参数渲染首页python3 scripts/render_page.py url --mode auto --json获取原始 HTML、渲染后 HTML、提取文本、SPA 状态与可访问性数据业务类型检测依据编排器的首页信号规则爬站跟随内链最多500 页遵守 robots.txt委派按编排器规则并行 spawn 子 Agent不可用则串行内联执行评分聚合为 SEO Health Score0-100持久化全部产物写入{domain}-audit/报告生成优先行动清单与可选 PDF/HTML 报告。其爬取配置见 skills/seo-audit/SKILL.md为Max pages: 500 Respect robots.txt: Yes Follow redirects: Yes (max 3 hops) Timeout per page: 30 seconds Concurrent requests: 5 Delay between requests: 1 second4.3 审计产物与结构化数据信封seo-audit将全部输出持久化到{domain}-audit/目录见 skills/seo-audit/SKILL.mdFULL-AUDIT-REPORT.md综合发现ACTION-PLAN.md按 Critical High Medium Low 排序的建议audit-data.json结构化审计信封供报告生成使用findings/*.md各专业领域的细分发现technical.md、content.md、schema.md、performance.md、visual.md等screenshots/桌面 移动端截图若 Playwright 可用PDF 报告python3 scripts/google_report.py --type full --data {domain}-audit/audit-data.json --domain domain --output-dir {domain}-audit/产出带白色封面的 A4 企业级报告目录、执行摘要、Lighthouse 仪表盘图表、指标卡片、阈值表、带工作量估算的优先建议与实施路线图。audit-data.json的结构化信封 schema见 skills/seo-audit/SKILL.md设计目标是即使 Google API 数据不可用也能生成报告{ summary: { health_score: 0, business_type: detected type, top_findings: [], quick_wins: [] }, categories: [ { name: Technical SEO, score: 0, what_works: [], findings: [ { title: Finding title, severity: Critical|High|Medium|Low|Info, description: Evidence-backed detail, recommendation: Specific fix } ] } ], action_plan: { phases: [ {name: Phase 1: Critical Fixes, timeframe: Week 1, items: []}, {name: Phase 2: High-Impact Improvements, timeframe: Weeks 2-3, items: []}, {name: Phase 3: Content Authority, timeframe: Month 2, items: []}, {name: Phase 4: Monitoring Iteration, timeframe: Ongoing, items: []} ] }, artifacts: { findings_dir: findings/, screenshots_dir: screenshots/ } }4.4 单命令路由/seo page等与完整审计不同单命令走的是直连子技能路径见 docs/ARCHITECTURE.mdUser Request (e.g., /seo page) │ ▼ ┌─────────────────┐ │ seo │ ← Routes to sub-skill └────────┬────────┘ │ ▼ ┌─────────────────┐ │ seo-page │ ← Sub-skill handles directly │ (SKILL.md) │ └─────────────────┘编排器只做路由转发不额外 spawn 子 Agent避免小任务被过度放大。/seo的完整命令表见 skills/seo/SKILL.md涵盖audit、page、sitemap、schema、images、technical、content、content-brief、geo、plan、programmatic、competitor-pages、local、maps、hreflang、google、backlinks、cluster、sxo、driftbaseline/compare/history、ecommerce、firecrawl、dataforseo、image-gen、flow等 25 个命令。五、设计原则四条架构级约束架构文档提炼了四条贯穿全插件的设计原则5.1 渐进式披露Progressive Disclosure主skills/seo/SKILL.md保持精简少于 200 行参考文件按需加载详细指令下沉到各子技能。这样做的直接效果是启动一个会话时模型上下文不被插件文档占满只有进入特定分析阶段才加载对应参考文件。这与 skills/seo/SKILL.md 中按需加载不要在启动时全部加载的指令互为印证。5.2 并行处理Parallel Processing审计期间子 Agent 并发运行相互独立的分析互不阻塞全部完成后统一聚合结果。5.3 质量门禁Quality Gates架构文档列举了四条内置阈值防止生成有害建议Location 页面数量上限30 警告强制 60% 唯一内容50 硬性停止要求用户给出理由Schema 废弃感知绝不推荐 HowTo schema2023 年 9 月已废弃FAQ schema 策略Google 已于 2026 年 5 月 7 日对所有站点停用 FAQ 富结果现有 FAQPage 仅以 Info 级别标记因其 AI/LLM 引用价值不推荐删除、也不为 SERP 收益新建 FAQPage真实用户问答场景改用 QAPageINP 强制替换 FID所有 Core Web Vitals 引用一律使用 INP绝不使用 FID。详细阈值见 skills/seo/references/quality-gates.mdseo-technical子 Agent 还明确注明了时间线INP 于 2024 年 3 月 12 日取代 FIDFID 已于 2024 年 9 月 9 日从全部 Chrome 工具CrUX API、PageSpeed Insights、Lighthouse中移除见 agents/seo-technical.md。LCP/INP/CLS 的 2026 年阈值详见 skills/seo-technical/SKILL.md。5.4 行业感知Industry Awareness为不同业务类型提供专属模板见 skills/seo-plan/assets/ 下的 agency / ecommerce / generic / local-service / publisher / saas 六类模板依据首页信号自动检测行业按行业定制建议。行业检测信号在 skills/seo/SKILL.md 有明确定义SaaS 看 pricing 页与/features、/integrations、/docs、free trial等本地服务看电话、地址、服务区域、serving [city]、Google Maps 嵌入电商看/products、/collections、/cart、add to cart与产品 schema出版看/blog、/articles、文章 schema 与作者页代理看/case-studies、/portfolio、客户 Logo 等。六、文件命名约定架构文档给出贯穿全插件的命名规范表TypePatternExampleSkillseo-{name}/SKILL.mdseo-audit/SKILL.mdAgentseo-{name}.mdseo-technical.mdReference{topic}.mdcwv-thresholds.mdScript{action}_{target}.pyfetch_page.pyTemplate{industry}.mdsaas.md这套约定在仓库中高度自洽skills/下全部为seo-*/SKILL.mdagents/下全部为seo-*.mdscripts/下全部为{action}_{target}.py如 scripts/fetch_page.py、scripts/render_page.py、scripts/drift_compare.py、scripts/google_report.pyskills/seo-plan/assets/下为行业模板。七、扩展点如何在保持架构一致性的前提下添加新组件架构文档明确定义了三种添加新组件的路径全部以拷贝现有模式为原则避免破坏既有约定7.1 添加新子技能创建skills/seo-newskill/SKILL.md添加包含 name 与 description 的 YAML frontmatter编写技能指令更新主 skills/seo/SKILL.md将其加入路由表与子技能清单。7.2 添加新子 Agent创建agents/seo-newagent.md添加 name、description、tools 的 frontmatter可参考 agents/seo-technical.md 补充model与maxTurns编写 Agent 指令从相关技能中引用它在编排逻辑的条件 spawn 列表中登记触发条件。7.3 添加新参考文件在合适的references/目录下创建文件在技能中通过按需加载指令引用它例如 skills/seo/SKILL.md 对cwv-thresholds.md、schema-types.md等的引用方式。八、扩展体系通过 MCP 接入外部数据源的即插即用机制扩展Extensions是架构文档的重要组成部分它们是可选安装的附加组件通过 MCP 服务器接入外部数据源统一存放在extensions/name/并各自携带 install / uninstall 脚本。完整目录布局见 docs/ARCHITECTURE.mdextensions/ ├── dataforseo/ # DataForSEO MCP integration │ ├── README.md │ ├── install.sh │ ├── install.ps1 │ ├── uninstall.sh │ ├── uninstall.ps1 │ ├── field-config.json │ ├── skills/seo-dataforseo/SKILL.md │ ├── agents/seo-dataforseo.md │ └── docs/DATAFORSEO-SETUP.md │ ├── banana/ # AI image generation via Gemini │ ├── README.md │ ├── install.sh │ ├── uninstall.sh │ ├── skills/seo-image-gen/SKILL.md │ ├── agents/seo-image-gen.md │ ├── scripts/ # Python fallback scripts (stdlib only) │ ├── references/ # 7 reference files (prompt engineering, models, presets) │ └── docs/BANANA-SETUP.md │ └── firecrawl/ # Firecrawl MCP for full-site crawling ├── README.md ├── install.sh ├── install.ps1 ├── uninstall.sh ├── uninstall.ps1 └── skills/seo-firecrawl/SKILL.md8.1 可用扩展一览架构文档以表格形式锁定了各扩展的 MCP 包版本ExtensionPackage (pinned)What it addsDataForSEOdataforseo-mcp-server2.8.10Live SERP data, keyword research, backlinks, on-page analysis, business listings, AI visibility, LLM mention trackingBanana Image Genycse/nanobanana-mcp1.1.1AI image generation for SEO assets via Gemini (OG images, hero images, product photos, infographics, batch)Firecrawlfirecrawl-mcp3.11.0Full-site crawling and URL discovery for audits注意包名后的version这是供应链稳定性设计——MCP 服务器版本被显式锁定防止上游发布破坏性更新导致插件失效。8.2 扩展安装约定Extension Convention架构文档列出七条约定我们从 extensions/dataforseo/install.sh 和 extensions/firecrawl/install.sh 的源码可以得到逐条印证自包含全部文件位于extensions/name/自带 install.sh / install.ps1复制文件并配置 MCP自带 uninstall.sh / uninstall.ps1逆向撤销安装安装子技能镜像到插件技能目录cp .../skills/seo-dataforseo/SKILL.md ${HOME}/.claude/skills/seo-dataforseo/SKILL.md安装子 Agent 镜像到插件 Agent 目录cp .../agents/seo-dataforseo.md ${HOME}/.claude/agents/seo-dataforseo.md非破坏性合并 MCP 配置到~/.claude/settings.jsonMCP 版本锁定version。源码中还有几个值得注意的工程细节原子写入installer 用 Python 内联脚本将 MCP 配置合并进 settings.json——先用tempfile.mkstemp创建临时文件、os.chmod(tmp, 0o600)设置 0600 权限、最后os.replace原子替换避免配置文件写入中途损坏同时保证 API 凭据文件权限收紧凭据不经字符串插值用户名/密码/API key 全部通过 argv 传给 Python 脚本而不是拼接进 JSON 源字符串降低注入风险预下载npx --yes --packagedataforseo-mcp-server2.8.10 -- node -e 在不启动 MCP 服务的前提下预取 npm 包让首次使用更流畅路径兼容安装脚本同时兼容传统安装~/.claude/skills/seo与插件市场安装~/.claude/plugins/cache/.../skills/seo两种布局通过BASH_SOURCE提前解析脚本目录。DataForSEO 的 MCP 环境变量配置见 extensions/dataforseo/install.sh也值得关注{ command: npx, args: [-y, dataforseo-mcp-server2.8.10], env: { DATAFORSEO_USERNAME: username, DATAFORSEO_PASSWORD: password, ENABLED_MODULES: SERP,KEYWORDS_DATA,ONPAGE,DATAFORSEO_LABS,BACKLINKS,DOMAIN_ANALYTICS,BUSINESS_DATA,CONTENT_ANALYSIS,AI_OPTIMIZATION, FIELD_CONFIG_PATH: field_config_path } }FIELD_CONFIG_PATH指向 extensions/dataforseo/field-config.json——这份文件是 DataForSEO 扩展的令牌压缩关键它按 9 个模块SERP、keywords_data、dataforseo_labs、backlinks、onpage、domain_analytics、business_data、content_analysis、ai_optimization白名单过滤返回字段据注释可减少约 75% 的令牌消耗只保留 SEO 相关的字段如 SERP 的featured_snippet、ai_overview、people_also_askbacklinks 的backlinks_spam_score、anchor、timeseriesonpage 的page_timing.largest_contentful_paint等。这对 MCP 服务器在 Claude 会话中的上下文成本控制至关重要。8.3 扩展的路由方式主技能对扩展的调用方式有两种见 skills/seo/SKILL.md通过/seo子命令可达firecrawl/seo firecrawl command、dataforseo/seo dataforseo [command]、image-gen/seo image-gen [use-case] description独立技能自动路由Ahrefs、Bing、Profound、SE Ranking、Unlighthouse 安装为独立技能由模型依据各自 description 自动路由触发而非通过/seo name。各扩展的完整配置说明分别见 extensions/dataforseo/docs/DATAFORSEO-SETUP.md、extensions/firecrawl/docs/FIRECRAWL-SETUP.md 与 extensions/banana/docs/BANANA-SETUP.md。九、与源码实现互相印证的架构细节9.1 Schema 校验挂钩hooks/目录中的 hooks/hooks.json 实现了对 Edit/Write 事件的 PostToolUse 挂钩每当模型写出或编辑文件时自动以node运行 hooks/run-python-hook.js 调用 hooks/validate-schema.py 校验 schema。这与架构文档Quality Gates原则一脉相承——把错误建议在产出阶段就拦截掉而不是事后补救。9.2 Agent 的安全与渲染约定agents/seo-technical.md 明确了页面获取的工程约定必须使用python3 scripts/render_page.py URL --mode auto --json——auto模式先做原始抓取仅在检测到 SPA 壳时启动 Playwright--mode always强制渲染、--mode never完全跳过 PlaywrightJSON 输出暴露is_spa、extracted_text经 trafilatura 去样板文本与publication_datehtmldate等摘要字段。同时强调 SSRF 与 DNS-rebinding 防护实现在 scripts/url_safety.py 中禁止对用户提供的 URL 直接调用requests.get——这体现了插件在安全边界上的设计考虑。9.3 FLOW 框架集成seo-flow是架构中的框架集成组件CC BY 4.0 许可它把 FLOW 知识库的 41 个 AI 提示词按 Find → Leverage → Optimize → Win 四阶段外加 Local 阶段组织进 skills/seo-flow/SKILL.md提示词文件存放于 skills/seo-flow/references/prompts/含 find / leverage / optimize / win / local 五组运行时按需加载对应阶段的提示词并支持/seo flow sync从上游拉取最新提示词。9.4 错误处理契约架构层面还定义了统一错误处理见 skills/seo/SKILL.md 与 skills/seo-audit/SKILL.md未知命令时列出命令表并推荐最接近的命令URL 不可达时不猜测站点内容而要求用户核验审计中子技能失败时报告其余成功的部分结果并注明失败原因业务类型检测歧义时呈现得分最高的两种类型并请用户确认robots.txt 屏蔽时仅分析可访问页面并在报告中注明限制429 限流时退避降并发。这些契约保证了插件的输出总是可解释、可追溯的。十、小结claude-seo 的架构本质是一套**精简编排器 并行子 Agent 按需参考文件 可选 MCP 扩展**的组合模式编排器保持轻量复杂度被逐层下沉到子技能审计通过并行子 Agent 获得吞吐通过质量门禁与 10 原则综合保证建议质量外部数据源则通过版本锁定的 MCP 扩展以非破坏性方式接入。这套设计既符合 Anthropic 官方 Claude Code Skill 规范也为二次扩展新增技能、Agent、参考文件、扩展提供了清晰可循的路径——所有约定都沉淀在 docs/ARCHITECTURE.md 与仓库各目录的结构之中可供其他 Claude Code 插件项目直接借鉴。若要深入某个子系统的实现建议按如下路径继续阅读编排逻辑与命令表skills/seo/SKILL.md完整审计流程与审计数据信封skills/seo-audit/SKILL.md技术 SEO 九大类别与 Agent 契约skills/seo-technical/SKILL.md、agents/seo-technical.md扩展安装器与字段过滤extensions/dataforseo/install.sh、extensions/dataforseo/field-config.json报告生成入口scripts/google_report.py赞分享【免费下载链接】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点击查看免费下载相关推荐Claude CodeClaude Opus 4.8系统提示词深度拆解主 Agent 指令、子代理、技能与 32 个工具契约全解析Claude CodeClaude Opus 4.8系统提示词深度拆解主 Agent 指令、子代理、技能与 32 个工具契约全解析 本文以开源仓库 sys大模型人工智能提示工程17个插件如何接入Claude Codemy-claude-code-mods钩子事件系统与插件架构全解析17个插件如何接入Claude Codemy claude code mods钩子事件系统与插件架构全解析 本文带你彻底看懂开源项目 my claude coOpenVoice 即时语音克隆完整教程如何用 10 秒参考音频让人声说多种语言OpenVoice 即时语音克隆完整教程如何用 10 秒参考音频让人声说多种语言 OpenVoice 是 MIT 与 MyShell 开源的即时语音克隆工具人工智能语音音频深度学习上一篇IntelliJ IDEA 最特殊快捷键 Alt EnterOption Enter完全指南光标位置决定一切下一篇Semantic-UI-React选项卡(Tab)组件内容切换优化创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考