【免费下载链接】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 仓库中的 seo-audit 技能定义系统讲解该开源项目如何把一次全站 SEO 审计拆解为渲染首页 → 业务类型识别 → 最多 500 页爬取 → 15 个专家子代理并行审查 → 聚合健康评分 → 落盘审计产物 → 生成优先级行动方案与 PDF 报告的完整流水线。读完本文你将掌握 seo-audit 的调用入口、子代理编排规则、爬虫配置、audit-data.json数据结构、评分权重与优先级定义并能结合仓库源码理解render_page.py、google_report.py等底层脚本的真实行为。一、技能定位seo-audit 在 claude-seo 生态中的角色claude-seo 是一个面向 Claude Code 的通用 SEO 技能集包含 25 个子技能与 18 个子代理。在skills/seo/SKILL.md的快速参考表中/seo audit url被定义为使用并行子代理委托执行的全站审计而 seo-audit 正是承载这条命令的核心实现。从skills/seo-audit/SKILL.md的 frontmatter 可以看到该技能的触发语义name: seo-audit description: Full website SEO audit with parallel subagent delegation. Crawls up to 500 pages, detects business type, delegates to up to 15 specialists (8 always 7 conditional), generates health score. Use when user says audit, full SEO check, analyze my site, or website health check. user-invocable: true argument-hint: [url] license: MIT metadata: author: AgriciDaniel version: 2.2.0 category: seo四个关键事实值得注意可被用户直接调用user-invocable: true参数为一个 URL触发词覆盖自然语言意图audit、full SEO check、analyze my site、website health check都会路由到该技能委托上限为 15 个专家子代理其中 8 个始终参与7 个按条件触发详见下文子代理编排输出一个 0-100 的健康评分作为审计的量化结论。在skills/seo/SKILL.md的编排逻辑中/seo audit完成后还会要求按 PERCEIVE → ANALYZE → VALIDATE → ACT 的四阶段思维框架对发现进行综合参考 thinking-framework再按 Critical / High / Medium / Low 分桶最后向用户提议生成 PDF 报告。也就是说seo-audit 是数据采集与发现层而合成方法论与报告层由 orchestrator 与 google_report.py 承接。二、审计主流程七步流水线skills/seo-audit/SKILL.md的 Process 章节定义了完整的七步流程渲染首页执行python3 scripts/render_page.py url --mode auto --json捕获原始 HTML、渲染后 HTML、抽取文本、SPA 状态与可访问性数据检测业务类型依据首页信号判断站点属于 SaaS、本地服务、电商、出版/媒体、代理商或其他类型爬取站点沿内部链接爬取最多 500 页遵守 robots.txt委托给子代理可用则并行否则按顺序内联执行seo-technical、seo-content、seo-schema、seo-sitemap、seo-performance、seo-visual、seo-geo 为固定项另按条件追加 seo-local、seo-maps、seo-google、seo-backlinks、seo-cluster、seo-sxo、seo-drift、seo-ecommerce评分聚合为 SEO Health Score0-100持久化审计产物所有输出写入{domain}-audit/目录报告生成优先级行动方案并可选用 PDF/HTML 报告交付。源码级佐证第一步为什么必须用 render_page.py仓库测试 test_audit_instructions.py 以静态断言锁定了这条契约def test_seo_audit_starts_with_render_page_auto() - None: process text[text.index(## Process):text.index(## Crawl Configuration)] assert scripts/render_page.py in process assert --mode auto in process assert scripts/fetch_page.py to retrieve HTML not in process即审计流程必须以render_page.py --mode auto开头且禁止退回旧的fetch_page.py裸抓取方式。原因在 render_page.py 的模块文档中写得很清楚——v2.0.0 之前只有 seo-visual 使用 Playwright其余代理直接抓取原始 HTML导致对 SPA 站点产生系统性漏报空的div idroot、源码中无 schema、无正文内容。render_page.py提供三种模式模式行为适用场景auto默认先做原始抓取仅当检测到 SPA 外壳时才启动 Playwright 渲染成本最低且行为正确的默认选择always始终用 Playwright 渲染即使页面是静态 HTML需要执行 JS 的深度分析never仅返回原始 HTML等价于旧版 fetch_page.py纯静态页面的快速抓取SPA 检测逻辑位于_is_spa()识别_SPA_SHELL_PATTERNS中的 Reactdiv idroot、Next.jsdiv id__next、Vue/Nuxtdiv id__nuxt、Sveltedata-svelte-h、Astroastro-island等水合外壳特征并在body文本少于 100 字符时也判定为 SPA阈值刻意保守以降低误判。渲染模式下返回的 JSON 包含is_spa、extracted_text经 trafilatura 去除样板后抽取正文、publication_date经 htmldate 识别、console_errors、render_ms等字段。此外render_page.py内置了 SSRF 纵深防御URL 先经 url_safety.py 的validate_url_strict校验Playwright 内再通过route()拦截所有子资源请求、中止解析到非公网 IP 的域名防止 Chromium 解析器内发生 DNS rebinding。业务类型检测按skills/seo/SKILL.md的行业检测规则从首页信号推断业务类型类型典型首页信号SaaSpricing 页、/features、/integrations、/docs、free trial、sign up本地服务电话、地址、服务区域、serving [city]、Google Maps 嵌入电商/products、/collections、/cart、add to cart、产品 schema出版/媒体/blog、/articles、/topics、文章 schema、作者页、发布日期代理商/case-studies、/portfolio、/industries、our work、客户 Logo若检测到本地服务会自动建议用户执行/seo local做更深层分析若检测结果模糊orchestrator 会列出置信度最高的两个类型并请用户确认再继续行业特定的建议。三、子代理编排8 个固定 7 个条件触发seo-audit 的核心价值在于把一次审计按专业领域切片并并行执行。固定参与的 8 个代理对应agents/目录中的同名文件及分工如下子代理职责seo-technicalrobots.txt、sitemap、canonical、Core Web Vitals、安全头seo-contentE-E-A-T、可读性、内容稀薄度、AI 引用就绪度seo-schemaschema 检测、校验、生成建议seo-sitemap结构分析、质量门槛、缺失页面seo-performanceLCP、INP、CLS 测量seo-visual截图、移动端测试、首屏分析seo-geoAI 爬虫访问、llms.txt、可引用性、品牌提及信号seo-sxo搜索体验分析页面类型错配、用户故事、人物角色评分条件触发的 7 个代理及其触发条件如下表子代理触发条件seo-local检测到本地服务行业实体店、SAB、混合型seo-maps检测到本地服务且DataForSEO MCP 可用seo-googlepython3 scripts/google_auth.py --check检测到 Google API 凭据seo-backlinkspython3 scripts/backlinks_auth.py --check检测到 Moz 或 Bing 凭据Common Crawl 域级指标始终包含seo-cluster检测到内容策略信号博客、支柱页、话题集群seo-driftpython3 scripts/drift_history.py url显示该 URL 存在漂移基线seo-ecommerce检测到电商行业条件判断的源码实现凭据检测脚本均是真实可执行文件google_auth.py 支持--check检查全部凭据、--check gsc检查单项、--setup展示配置指引、--tier显示检测到的凭据等级与--auth --creds client_secret.jsonOAuth 浏览器流程。配置读取顺序为~/.config/claude-seo/google-api.json→ 环境变量回退覆盖 PageSpeed Insights、CrUX、GSC、Indexing API、GA4 五类服务。backlinks_auth.py 管理 Moz Link Explorer、Bing Webmaster Tools 与 Common Crawl Web Graph 三类数据源其中 Common Crawl 无需 API Keycommoncrawl: none这也是 seo-backlinks始终包含 Common Crawl 域级指标的原因。它还从 url_safety 强制导入 SSRF 校验缺少该模块时直接拒绝运行。drift_history.py 从 SQLite 数据库drift_baseline模块中的DB_PATH查询指定 URL 的基线记录返回baselines与comparisons数组若数据库不存在则返回提示先运行 drift baseline。仓库测试 test_audit_instructions.py 同时校验了所有 15 个代理的agents/*.md文件都必须声明output_dir与findings/输出契约保证审计产物能被统一收集。四、爬虫配置边界与礼貌参数原文档给出的爬取配置是默认执行的硬性边界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 second解读这些参数的实际意义500 页上限配合并发 5 请求与 1 秒间隔是覆盖足够样本与不触发目标站点限流之间的平衡点最多 3 跳重定向用于捕获 canonical 指向跳转页这类问题同时避免跟随过深的跳转链遵守 robots.txt是硬性要求——若目标站点的 robots.txt 阻断爬取审计不得绕过只能记录被阻断的路径并如实汇报遇到 429 限流时策略是退避并降低并发然后在报告中注明哪些板块未能完成。五、输出文件契约与审计数据信封审计完成后所有产物写入{domain}-audit/目录。原文档定义的输出结构为文件内容{domain}-audit/FULL-AUDIT-REPORT.md综合发现报告{domain}-audit/ACTION-PLAN.md按 Critical High Medium Low 排序的优先建议{domain}-audit/audit-data.json用于报告生成的结构化审计信封{domain}-audit/findings/*.md各分类专家发现technical.md、content.md、schema.md、performance.md、visual.md等{domain}-audit/screenshots/桌面 移动端截图需 Playwright 可用测试 test_audit_instructions.py 中的test_seo_audit_requires_persistent_artifacts断言了FULL-AUDIT-REPORT.md、ACTION-PLAN.md、audit-data.json、findings/、screenshots/与{domain}-audit目录约定全部出现在 SKILL.md 中说明这是一条被测试锁定的持久化契约而不是可选项。audit-data.json可离线驱动的报告信封audit-data.json被设计为即使 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/ } }四个顶层字段各有用途summary承载健康分与业务类型、categories以分类为单位的评分与发现明细、action_plan的四阶段实施路线含时间框、artifacts告诉报告生成器去哪找附加产物。测试 test_google_report_full_audit.py 展示了该信封的真实消费方式——它构造了包含health_score: 82、分类发现如 Canonical mismatch 的 Critical 问题与四阶段 action_plan 的数据调用google_report.generate_report(full, data, example.com, tmp_path, output_formathtml)并断言 HTML 中包含了 summary、categories 与 roadmap 区块。六、SEO 健康评分权重与优先级语义评分权重七个分类按权重聚合为 0-100 的健康分分类权重Technical SEO22%Content Quality23%On-Page SEO20%Schema / Structured Data10%Performance (CWV)10%AI Search Readiness10%Images5%值得注意的是 Content Quality23%与 Technical SEO22%合计近半且AI Search Readiness作为一个独立分类存在——这与 claude-seo 面向 AI 搜索GEO/AEO的整体定位一致。优先级定义优先级定义修复时限Critical阻断索引或导致处罚立即修复High显著影响排名1 周内Medium优化机会1 个月内Low锦上添花放入待办在 orchestrator 的合成方法论中这四个优先级桶是 VALIDATE 阶段的输出而非替代品每条建议都应携带其依赖的首因观察THINK、与其他建议的依赖/解锁关系CONNECT-system、可证伪的验收检查ACCEPT以及无需重跑审计即可监测的前瞻指标GROW。与 CWV 指标版本相关的质量门槛skills/seo/SKILL.md的质量门槛部分与 seo-audit 的 performance 分类直接相关所有 Core Web Vitals 引用一律使用INP绝不使用 FIDINP 于 2024-03-12 取代 FIDFID 已于 2024-09-09 从 Chrome 各工具中完全移除seo-technical 代理 中的阈值表即以此为基准LCP Good 2.5s、INP Good 200ms、CLS Good 0.1不建议推荐 HowTo schema2023 年 9 月废弃FAQPage 在 2026-05-07 后不再获得 Google 富结果展示仅按其 AI/LLM 引用价值以 Info 级别标记不推荐移除也不推荐为新页面新增。七、报告结构从执行摘要到分项明细FULL-AUDIT-REPORT.md的报告骨架完整继承自原文档包含以下板块Executive Summary总体 SEO 健康分0-100检测到的业务类型Top 5 关键问题Top 5 快速制胜点Technical SEO可抓取性问题可索引性问题安全关注点Core Web Vitals 状态Content QualityE-E-A-T 评估内容稀薄页面重复内容问题可读性评分On-Page SEO标题标签问题Meta 描述问题标题结构内链缺口Schema Structured Data现有实现校验错误缺失的机会PerformanceLCP、INP、CLS 得分资源优化需求第三方脚本影响Images缺失 alt 文本超大图片格式建议AI Search Readiness可引用性评分结构性改进权威信号八、PDF 报告一条命令完成企业级交付审计完成后seo-audit 强烈建议生成 PDF 报告。生成命令继承自原文档python3 scripts/google_report.py --type full --data {domain}-audit/audit-data.json --domain domain --output-dir {domain}-audit/该命令读取审计信封产出一份白色封面的 A4 企业级报告包含目录、执行摘要、图表Lighthouse 仪表盘、查询条形图、索引环形图、指标卡片、阈值表、带工作量估算的优先级建议以及实施路线图。从 google_report.py 源码可以看到该命令的实现细节模块文档给出了四种报告类型cwv-audit、gsc-performance、indexation与full其中full即全站审计模式报告依赖matplotlibAgg 后端绘图与weasyprintHTML → PDF 渲染缺失依赖时脚本会明确提示安装命令图表着色遵循 Lighthouse 风格阈值分数 ≥90 绿色、50-89 琥珀、50 红色_score_color渲染流程在generate_report()中按类型组装章节full类型会调用_build_executive_summary生成执行摘要并从action_plan.phases或兼容的roadmap字段展开roadmap-phase区块。测试 test_google_report_full_audit.py 验证了即使数据完全来自 seo-audit 而非 Google APIfull audit report generation from non-Google audit dataHTML 输出仍包含 summary、categories 与 roadmap这正是 audit-data.json 信封设计的价值。九、可选增强DataForSEO 与 Google API 集成DataForSEO 集成可选若 DataForSEO MCP 工具可用seo-audit 会额外启动 seo-dataforseo 代理为审计注入真实 SERP 排名、含垃圾评分的反链画像、on-page 分析Lighthouse、商家列表与 AI 可见性检查ChatGPT 抓取、LLM 提及。其成本分级可参考 cost-tiers。Google API 集成可选若python3 scripts/google_auth.py --check检测到凭据则启动 seo-google 代理把实验室估算替换为真实字段数据CrUX Core Web Vitals替代仅实验室估算GSC URL 索引状态搜索表现点击、展示、CTRGA4 自然流量趋势。其中 PerformanceCWV分类的评分受益最大因为 CrUX 字段数据反映了真实用户在真实网络环境下的体验分布而非单机 Lighthouse 快照。十、错误处理矩阵原文档定义的四类故障场景及处置方式是审计执行时的兜底策略场景处置URL 不可达DNS 失败、连接拒绝明确报告错误不臆测站点内容建议用户核对 URL 后重试robots.txt 阻断爬取报告被阻断的路径仅分析可访问页面并在报告中注明限制限流429 响应退避并降低并发报告部分结果并注明哪些板块未能完成大站超时500 页在超时限制内截断爬取报告已抓取页面的发现并估算站点总规模orchestrator 层面还有两条补充规则子技能在审计中失败时报告其他子技能的成功结果并明确指出失败项及原因建议单独重跑失败子技能业务类型检测模糊时列出置信度最高的两个类型并请求用户确认后再继续。十一、落地实践建议结合仓库内容给出几条可直接操作的实践指引先确认环境render_page.py的 rendered 模式需要pip install -r requirements.txt playwright install chromiumgoogle_report.py需要 matplotlib 与 weasyprint从审计信封驱动报告即使没有配置任何付费 API只要按第六节结构产出audit-data.json--type full报告就能完整生成——这是{domain}-audit/目录的核心价值按需开启条件代理在本地服务站点上配置 DataForSEO MCP 可同时解锁 seo-maps 的网格排名追踪与地理竞对半径映射在拥有 Google 凭据的站点上CrUX 字段数据会显著提升 Performance 分类的评分可信度用测试锁定契约仓库中 test_audit_instructions.py 展示了如何用静态断言守护流程必须以 render_page.py 开头、产物必须持久化、代理必须声明输出目录等不变量防止技能文档在演进中退化。seo-audit 的完整技能定义位于 skills/seo-audit/SKILL.md其编排入口与合成方法论见 skills/seo/SKILL.md底层渲染与报告实现分别位于 scripts/render_page.py 与 scripts/google_report.py测试证据集中在 tests/test_audit_instructions.py 与 tests/test_google_report_full_audit.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-seo 电商 SEO 实战指南Google Shopping 市场情报、产品 Schema 校验与 UCP 代理交易审计claude seo 电商 SEO 实战指南Google Shopping 市场情报、产品 Schema 校验与 UCP 代理交易审计 claude seoclaude-seo 的 SEO 图片分析 Agent基于 banana 扩展的 OG 图审计与生成计划实战指南claude seo 的 SEO 图片分析 Agent基于 banana 扩展的 OG 图审计与生成计划实战指南 本指南以 claude seo 仓库中 ba用 OpenSEO 的 seo-audit 技能生成「一页可行动」的 SEO 审计报告SKILL.md 完整实操指南用 OpenSEO 的 seo audit 技能生成「一页可行动」的 SEO 审计报告SKILL.md 完整实操指南 导读 本文基于 OpenSEO 仓库中的后端前端MCP 服务AI 应用人工智能数据分析上一篇Clean Code JavaScript 最佳实践从混乱到优雅的代码重构指南下一篇Tab Session Manager 开源项目安装与使用指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/26 9:46:55 · 阅读 1.2k claude-seo 全站 SEO 审计实战指南：并行子代理编排、健康评分与 PDF 报告生成
【免费下载链接】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 仓库中的 seo-audit 技能定义系统讲解该开源项目如何把一次全站 SEO 审计拆解为渲染首页 → 业务类型识别 → 最多 500 页爬取 → 15 个专家子代理并行审查 → 聚合健康评分 → 落盘审计产物 → 生成优先级行动方案与 PDF 报告的完整流水线。读完本文你将掌握 seo-audit 的调用入口、子代理编排规则、爬虫配置、audit-data.json数据结构、评分权重与优先级定义并能结合仓库源码理解render_page.py、google_report.py等底层脚本的真实行为。一、技能定位seo-audit 在 claude-seo 生态中的角色claude-seo 是一个面向 Claude Code 的通用 SEO 技能集包含 25 个子技能与 18 个子代理。在skills/seo/SKILL.md的快速参考表中/seo audit url被定义为使用并行子代理委托执行的全站审计而 seo-audit 正是承载这条命令的核心实现。从skills/seo-audit/SKILL.md的 frontmatter 可以看到该技能的触发语义name: seo-audit description: Full website SEO audit with parallel subagent delegation. Crawls up to 500 pages, detects business type, delegates to up to 15 specialists (8 always 7 conditional), generates health score. Use when user says audit, full SEO check, analyze my site, or website health check. user-invocable: true argument-hint: [url] license: MIT metadata: author: AgriciDaniel version: 2.2.0 category: seo四个关键事实值得注意可被用户直接调用user-invocable: true参数为一个 URL触发词覆盖自然语言意图audit、full SEO check、analyze my site、website health check都会路由到该技能委托上限为 15 个专家子代理其中 8 个始终参与7 个按条件触发详见下文子代理编排输出一个 0-100 的健康评分作为审计的量化结论。在skills/seo/SKILL.md的编排逻辑中/seo audit完成后还会要求按 PERCEIVE → ANALYZE → VALIDATE → ACT 的四阶段思维框架对发现进行综合参考 thinking-framework再按 Critical / High / Medium / Low 分桶最后向用户提议生成 PDF 报告。也就是说seo-audit 是数据采集与发现层而合成方法论与报告层由 orchestrator 与 google_report.py 承接。二、审计主流程七步流水线skills/seo-audit/SKILL.md的 Process 章节定义了完整的七步流程渲染首页执行python3 scripts/render_page.py url --mode auto --json捕获原始 HTML、渲染后 HTML、抽取文本、SPA 状态与可访问性数据检测业务类型依据首页信号判断站点属于 SaaS、本地服务、电商、出版/媒体、代理商或其他类型爬取站点沿内部链接爬取最多 500 页遵守 robots.txt委托给子代理可用则并行否则按顺序内联执行seo-technical、seo-content、seo-schema、seo-sitemap、seo-performance、seo-visual、seo-geo 为固定项另按条件追加 seo-local、seo-maps、seo-google、seo-backlinks、seo-cluster、seo-sxo、seo-drift、seo-ecommerce评分聚合为 SEO Health Score0-100持久化审计产物所有输出写入{domain}-audit/目录报告生成优先级行动方案并可选用 PDF/HTML 报告交付。源码级佐证第一步为什么必须用 render_page.py仓库测试 test_audit_instructions.py 以静态断言锁定了这条契约def test_seo_audit_starts_with_render_page_auto() - None: process text[text.index(## Process):text.index(## Crawl Configuration)] assert scripts/render_page.py in process assert --mode auto in process assert scripts/fetch_page.py to retrieve HTML not in process即审计流程必须以render_page.py --mode auto开头且禁止退回旧的fetch_page.py裸抓取方式。原因在 render_page.py 的模块文档中写得很清楚——v2.0.0 之前只有 seo-visual 使用 Playwright其余代理直接抓取原始 HTML导致对 SPA 站点产生系统性漏报空的div idroot、源码中无 schema、无正文内容。render_page.py提供三种模式模式行为适用场景auto默认先做原始抓取仅当检测到 SPA 外壳时才启动 Playwright 渲染成本最低且行为正确的默认选择always始终用 Playwright 渲染即使页面是静态 HTML需要执行 JS 的深度分析never仅返回原始 HTML等价于旧版 fetch_page.py纯静态页面的快速抓取SPA 检测逻辑位于_is_spa()识别_SPA_SHELL_PATTERNS中的 Reactdiv idroot、Next.jsdiv id__next、Vue/Nuxtdiv id__nuxt、Sveltedata-svelte-h、Astroastro-island等水合外壳特征并在body文本少于 100 字符时也判定为 SPA阈值刻意保守以降低误判。渲染模式下返回的 JSON 包含is_spa、extracted_text经 trafilatura 去除样板后抽取正文、publication_date经 htmldate 识别、console_errors、render_ms等字段。此外render_page.py内置了 SSRF 纵深防御URL 先经 url_safety.py 的validate_url_strict校验Playwright 内再通过route()拦截所有子资源请求、中止解析到非公网 IP 的域名防止 Chromium 解析器内发生 DNS rebinding。业务类型检测按skills/seo/SKILL.md的行业检测规则从首页信号推断业务类型类型典型首页信号SaaSpricing 页、/features、/integrations、/docs、free trial、sign up本地服务电话、地址、服务区域、serving [city]、Google Maps 嵌入电商/products、/collections、/cart、add to cart、产品 schema出版/媒体/blog、/articles、/topics、文章 schema、作者页、发布日期代理商/case-studies、/portfolio、/industries、our work、客户 Logo若检测到本地服务会自动建议用户执行/seo local做更深层分析若检测结果模糊orchestrator 会列出置信度最高的两个类型并请用户确认再继续行业特定的建议。三、子代理编排8 个固定 7 个条件触发seo-audit 的核心价值在于把一次审计按专业领域切片并并行执行。固定参与的 8 个代理对应agents/目录中的同名文件及分工如下子代理职责seo-technicalrobots.txt、sitemap、canonical、Core Web Vitals、安全头seo-contentE-E-A-T、可读性、内容稀薄度、AI 引用就绪度seo-schemaschema 检测、校验、生成建议seo-sitemap结构分析、质量门槛、缺失页面seo-performanceLCP、INP、CLS 测量seo-visual截图、移动端测试、首屏分析seo-geoAI 爬虫访问、llms.txt、可引用性、品牌提及信号seo-sxo搜索体验分析页面类型错配、用户故事、人物角色评分条件触发的 7 个代理及其触发条件如下表子代理触发条件seo-local检测到本地服务行业实体店、SAB、混合型seo-maps检测到本地服务且DataForSEO MCP 可用seo-googlepython3 scripts/google_auth.py --check检测到 Google API 凭据seo-backlinkspython3 scripts/backlinks_auth.py --check检测到 Moz 或 Bing 凭据Common Crawl 域级指标始终包含seo-cluster检测到内容策略信号博客、支柱页、话题集群seo-driftpython3 scripts/drift_history.py url显示该 URL 存在漂移基线seo-ecommerce检测到电商行业条件判断的源码实现凭据检测脚本均是真实可执行文件google_auth.py 支持--check检查全部凭据、--check gsc检查单项、--setup展示配置指引、--tier显示检测到的凭据等级与--auth --creds client_secret.jsonOAuth 浏览器流程。配置读取顺序为~/.config/claude-seo/google-api.json→ 环境变量回退覆盖 PageSpeed Insights、CrUX、GSC、Indexing API、GA4 五类服务。backlinks_auth.py 管理 Moz Link Explorer、Bing Webmaster Tools 与 Common Crawl Web Graph 三类数据源其中 Common Crawl 无需 API Keycommoncrawl: none这也是 seo-backlinks始终包含 Common Crawl 域级指标的原因。它还从 url_safety 强制导入 SSRF 校验缺少该模块时直接拒绝运行。drift_history.py 从 SQLite 数据库drift_baseline模块中的DB_PATH查询指定 URL 的基线记录返回baselines与comparisons数组若数据库不存在则返回提示先运行 drift baseline。仓库测试 test_audit_instructions.py 同时校验了所有 15 个代理的agents/*.md文件都必须声明output_dir与findings/输出契约保证审计产物能被统一收集。四、爬虫配置边界与礼貌参数原文档给出的爬取配置是默认执行的硬性边界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 second解读这些参数的实际意义500 页上限配合并发 5 请求与 1 秒间隔是覆盖足够样本与不触发目标站点限流之间的平衡点最多 3 跳重定向用于捕获 canonical 指向跳转页这类问题同时避免跟随过深的跳转链遵守 robots.txt是硬性要求——若目标站点的 robots.txt 阻断爬取审计不得绕过只能记录被阻断的路径并如实汇报遇到 429 限流时策略是退避并降低并发然后在报告中注明哪些板块未能完成。五、输出文件契约与审计数据信封审计完成后所有产物写入{domain}-audit/目录。原文档定义的输出结构为文件内容{domain}-audit/FULL-AUDIT-REPORT.md综合发现报告{domain}-audit/ACTION-PLAN.md按 Critical High Medium Low 排序的优先建议{domain}-audit/audit-data.json用于报告生成的结构化审计信封{domain}-audit/findings/*.md各分类专家发现technical.md、content.md、schema.md、performance.md、visual.md等{domain}-audit/screenshots/桌面 移动端截图需 Playwright 可用测试 test_audit_instructions.py 中的test_seo_audit_requires_persistent_artifacts断言了FULL-AUDIT-REPORT.md、ACTION-PLAN.md、audit-data.json、findings/、screenshots/与{domain}-audit目录约定全部出现在 SKILL.md 中说明这是一条被测试锁定的持久化契约而不是可选项。audit-data.json可离线驱动的报告信封audit-data.json被设计为即使 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/ } }四个顶层字段各有用途summary承载健康分与业务类型、categories以分类为单位的评分与发现明细、action_plan的四阶段实施路线含时间框、artifacts告诉报告生成器去哪找附加产物。测试 test_google_report_full_audit.py 展示了该信封的真实消费方式——它构造了包含health_score: 82、分类发现如 Canonical mismatch 的 Critical 问题与四阶段 action_plan 的数据调用google_report.generate_report(full, data, example.com, tmp_path, output_formathtml)并断言 HTML 中包含了 summary、categories 与 roadmap 区块。六、SEO 健康评分权重与优先级语义评分权重七个分类按权重聚合为 0-100 的健康分分类权重Technical SEO22%Content Quality23%On-Page SEO20%Schema / Structured Data10%Performance (CWV)10%AI Search Readiness10%Images5%值得注意的是 Content Quality23%与 Technical SEO22%合计近半且AI Search Readiness作为一个独立分类存在——这与 claude-seo 面向 AI 搜索GEO/AEO的整体定位一致。优先级定义优先级定义修复时限Critical阻断索引或导致处罚立即修复High显著影响排名1 周内Medium优化机会1 个月内Low锦上添花放入待办在 orchestrator 的合成方法论中这四个优先级桶是 VALIDATE 阶段的输出而非替代品每条建议都应携带其依赖的首因观察THINK、与其他建议的依赖/解锁关系CONNECT-system、可证伪的验收检查ACCEPT以及无需重跑审计即可监测的前瞻指标GROW。与 CWV 指标版本相关的质量门槛skills/seo/SKILL.md的质量门槛部分与 seo-audit 的 performance 分类直接相关所有 Core Web Vitals 引用一律使用INP绝不使用 FIDINP 于 2024-03-12 取代 FIDFID 已于 2024-09-09 从 Chrome 各工具中完全移除seo-technical 代理 中的阈值表即以此为基准LCP Good 2.5s、INP Good 200ms、CLS Good 0.1不建议推荐 HowTo schema2023 年 9 月废弃FAQPage 在 2026-05-07 后不再获得 Google 富结果展示仅按其 AI/LLM 引用价值以 Info 级别标记不推荐移除也不推荐为新页面新增。七、报告结构从执行摘要到分项明细FULL-AUDIT-REPORT.md的报告骨架完整继承自原文档包含以下板块Executive Summary总体 SEO 健康分0-100检测到的业务类型Top 5 关键问题Top 5 快速制胜点Technical SEO可抓取性问题可索引性问题安全关注点Core Web Vitals 状态Content QualityE-E-A-T 评估内容稀薄页面重复内容问题可读性评分On-Page SEO标题标签问题Meta 描述问题标题结构内链缺口Schema Structured Data现有实现校验错误缺失的机会PerformanceLCP、INP、CLS 得分资源优化需求第三方脚本影响Images缺失 alt 文本超大图片格式建议AI Search Readiness可引用性评分结构性改进权威信号八、PDF 报告一条命令完成企业级交付审计完成后seo-audit 强烈建议生成 PDF 报告。生成命令继承自原文档python3 scripts/google_report.py --type full --data {domain}-audit/audit-data.json --domain domain --output-dir {domain}-audit/该命令读取审计信封产出一份白色封面的 A4 企业级报告包含目录、执行摘要、图表Lighthouse 仪表盘、查询条形图、索引环形图、指标卡片、阈值表、带工作量估算的优先级建议以及实施路线图。从 google_report.py 源码可以看到该命令的实现细节模块文档给出了四种报告类型cwv-audit、gsc-performance、indexation与full其中full即全站审计模式报告依赖matplotlibAgg 后端绘图与weasyprintHTML → PDF 渲染缺失依赖时脚本会明确提示安装命令图表着色遵循 Lighthouse 风格阈值分数 ≥90 绿色、50-89 琥珀、50 红色_score_color渲染流程在generate_report()中按类型组装章节full类型会调用_build_executive_summary生成执行摘要并从action_plan.phases或兼容的roadmap字段展开roadmap-phase区块。测试 test_google_report_full_audit.py 验证了即使数据完全来自 seo-audit 而非 Google APIfull audit report generation from non-Google audit dataHTML 输出仍包含 summary、categories 与 roadmap这正是 audit-data.json 信封设计的价值。九、可选增强DataForSEO 与 Google API 集成DataForSEO 集成可选若 DataForSEO MCP 工具可用seo-audit 会额外启动 seo-dataforseo 代理为审计注入真实 SERP 排名、含垃圾评分的反链画像、on-page 分析Lighthouse、商家列表与 AI 可见性检查ChatGPT 抓取、LLM 提及。其成本分级可参考 cost-tiers。Google API 集成可选若python3 scripts/google_auth.py --check检测到凭据则启动 seo-google 代理把实验室估算替换为真实字段数据CrUX Core Web Vitals替代仅实验室估算GSC URL 索引状态搜索表现点击、展示、CTRGA4 自然流量趋势。其中 PerformanceCWV分类的评分受益最大因为 CrUX 字段数据反映了真实用户在真实网络环境下的体验分布而非单机 Lighthouse 快照。十、错误处理矩阵原文档定义的四类故障场景及处置方式是审计执行时的兜底策略场景处置URL 不可达DNS 失败、连接拒绝明确报告错误不臆测站点内容建议用户核对 URL 后重试robots.txt 阻断爬取报告被阻断的路径仅分析可访问页面并在报告中注明限制限流429 响应退避并降低并发报告部分结果并注明哪些板块未能完成大站超时500 页在超时限制内截断爬取报告已抓取页面的发现并估算站点总规模orchestrator 层面还有两条补充规则子技能在审计中失败时报告其他子技能的成功结果并明确指出失败项及原因建议单独重跑失败子技能业务类型检测模糊时列出置信度最高的两个类型并请求用户确认后再继续。十一、落地实践建议结合仓库内容给出几条可直接操作的实践指引先确认环境render_page.py的 rendered 模式需要pip install -r requirements.txt playwright install chromiumgoogle_report.py需要 matplotlib 与 weasyprint从审计信封驱动报告即使没有配置任何付费 API只要按第六节结构产出audit-data.json--type full报告就能完整生成——这是{domain}-audit/目录的核心价值按需开启条件代理在本地服务站点上配置 DataForSEO MCP 可同时解锁 seo-maps 的网格排名追踪与地理竞对半径映射在拥有 Google 凭据的站点上CrUX 字段数据会显著提升 Performance 分类的评分可信度用测试锁定契约仓库中 test_audit_instructions.py 展示了如何用静态断言守护流程必须以 render_page.py 开头、产物必须持久化、代理必须声明输出目录等不变量防止技能文档在演进中退化。seo-audit 的完整技能定义位于 skills/seo-audit/SKILL.md其编排入口与合成方法论见 skills/seo/SKILL.md底层渲染与报告实现分别位于 scripts/render_page.py 与 scripts/google_report.py测试证据集中在 tests/test_audit_instructions.py 与 tests/test_google_report_full_audit.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-seo 电商 SEO 实战指南Google Shopping 市场情报、产品 Schema 校验与 UCP 代理交易审计claude seo 电商 SEO 实战指南Google Shopping 市场情报、产品 Schema 校验与 UCP 代理交易审计 claude seoclaude-seo 的 SEO 图片分析 Agent基于 banana 扩展的 OG 图审计与生成计划实战指南claude seo 的 SEO 图片分析 Agent基于 banana 扩展的 OG 图审计与生成计划实战指南 本指南以 claude seo 仓库中 ba用 OpenSEO 的 seo-audit 技能生成「一页可行动」的 SEO 审计报告SKILL.md 完整实操指南用 OpenSEO 的 seo audit 技能生成「一页可行动」的 SEO 审计报告SKILL.md 完整实操指南 导读 本文基于 OpenSEO 仓库中的后端前端MCP 服务AI 应用人工智能数据分析上一篇Clean Code JavaScript 最佳实践从混乱到优雅的代码重构指南下一篇Tab Session Manager 开源项目安装与使用指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考