seo-audit

/digital-marketing-pro:seo-audit

脚本位置。 如果你的宿主未设置 ${CLAUDE_PLUGIN_ROOT}，脚本位于此插件的 scripts/ 文件夹中，与 skills/ 同级。请使用 Python 3.10 或更高版本运行：使用 python；如果找不到 python，则使用 python3（macOS 和许多 Linux 系统）。

用途

执行全面的 SEO 审计，评估网站在所有主要排名维度上的表现。为每项建议提供预估影响和所需投入，并生成按优先级排序的行动计划。

算法更新背景（分析波动前请阅读）

截至 2026-10-04 的状态（有时效限制——约在 2026-12 后重新核查）：根据 Google Search Status Dashboard，最近一次核心更新于 2026 年 5 月 21 日开始（约 12 天后完成）。此后 Google 仅进行了垃圾内容更新：2026 年 8 月垃圾内容更新（8 月 18–21 日）和2026 年 9 月垃圾内容更新（于 9 月 24 日开始，截至 2026-10-04 尚未标记为完成）。2026 年 9 月没有核心更新——一些 SEO 博客报道了核心更新，但信息面板中并未列出。仅将变化归因于信息面板列出的更新。另外，自 2026 年 8 月 30 日起，Google 的网站声誉滥用政策在 EEA 边界两侧有所不同：EEA 以外，手动处置会降低受影响版块的排名；EEA 以内，该版块会被分离并独立参与排名（Search Central）——针对第三方／“寄生”版块的审计发现，应注明适用地区。

如果审计期间处于已列出更新的推出窗口（或其后的 4 周内），且品牌排名出现波动：

• 不要在更新推出期间做出应激性调整。 等待信息面板标记更新完成，并再观察 7–14 天，之后再得出结论。
• 先判断变化方向，再确定影响范围。 全站下滑、单个版块下滑和单个模板下滑的根本原因大不相同。按页面组细分，对比推出前（开始日期前 21 天）、推出期间和推出后的展示次数与点击次数。
• 根据更新类型采取相应措施。 核心更新会重新调整现有质量信号的权重——应加强 E-E-A-T、提供独特价值，并清理内容单薄、重复或由 AI 垃圾内容构成的页面，而不是追逐未经证实的信号。垃圾内容更新针对违反政策的行为——在处理其他问题前，先根据 Google 的垃圾内容政策检查受影响页面（规模化内容滥用、网站声誉滥用、过期域名滥用）。
• 在执行摘要中注明排名变化是在已列出的更新之前就已出现（可能是网站自身问题），还是与更新同时发生——这将决定采取快速见效措施，还是启动跨多个季度的质量提升计划。

所需输入

用户必须提供（或将收到提示提供）：

• 网站 URL：要审计的域名或具体页面
• 目标关键词：网站希望获得排名的主要关键词（可选——也可以进行调研）
• 竞争对手：用于对比分析的 2–3 个竞争对手 URL（可选）
• 审计范围：全站或特定领域（技术、内容、本地、链接）
• 已知问题：用户了解的现有问题

流程

1. 加载品牌背景：读取 ~/.claude-marketing/brands/_active-brand.json 获取当前品牌 slug，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。应用品牌语气、目标市场的合规规则（skills/context-engine/compliance-rules.md）以及行业背景。同时检查指南：查看 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json；若存在，则加载限制说明和相关类别文件。检查 ~/.claude-marketing/brands/{slug}/templates/ 中的自定义模板。检查 ~/.claude-marketing/sops/ 中的代理机构 SOP。若没有品牌，请询问：“先设置品牌（/digital-marketing-pro:brand-setup）？”——或者使用默认设置继续。
2. 技术审计：可爬取性、索引情况、Core Web Vitals、移动设备可用性、结构化数据、HTTPS、XML 网站地图、robots.txt、规范标签、重定向链
3. 页面审计：标题标签、元描述、标题层级、关键词使用、图片 alt 文本、内部链接结构、URL 结构
4. 内容审计：内容单薄、重复内容、内容空白、新鲜度、E-E-A-T 信号（作者页面、引文、资质、第一手经验）
5. 本地 SEO（如适用）：Google Business Profile、NAP 一致性、本地 schema、评论、本地链接档案
6. 链接档案：域名权威度、反向链接质量、有害链接、锚文本分布、链接增长速度、竞争对手链接差距。使用分析器为自有域名档案评分（为 05-link-profile.md 提供数据）：

   python "${CLAUDE_PLUGIN_ROOT}/scripts/link-profile-analyzer.py" \
       --file "${CLAUDE_PLUGIN_DATA}/{brand}/seo/seo-audit/{date}/links-export.json" \
       --brand-domain {brand-domain}
   

   （--file 接收链接对象的 JSON 数组 [{"url","anchor_text","domain","da","follow"}]，也可通过 --links '<json>' 内联传入；--brand-domain 会排除内部链接。）如需发掘竞争对手的链接差距，请交由 /digital-marketing-pro:backlink-gap 处理。
7. 按 1–10 分制为每个维度评分
8. 按影响（高/中/低）和工作量（快速见效/中等/大型项目）排列发现事项的优先级
9. 生成包含可执行建议的审计报告

如需了解各维度的检查清单（包括关键词研究）、发现事项和行动计划表格的布局、审计后的后续操作菜单，以及并行分派规则（独立维度可并行；行动计划按顺序执行），请阅读此文件旁的 dimension-checklists.md。

输出

结构化的 SEO 审计报告，包含：

• 执行摘要及整体健康评分
• 技术 SEO 评分表，列出具体问题和修复方法
• 按页面/模板整理的页面优化发现事项
• 内容质量评估及差距分析
• E-E-A-T 评估和改进建议
• 本地 SEO 评估（如适用）
• 链接档案分析及机会
• 按影响与工作量之比排序的优先行动计划

编号输出约定

所有审计输出均保存到 ${CLAUDE_PLUGIN_DATA}/{brand}/seo/seo-audit/{YYYY-MM-DD}/：

00-input.md                    target URL, audit scope, brand context, Core Update window flag
01-crawl-inventory.md          discovered URLs, status codes, redirect chains
02-technical-scorecard.md      Core Web Vitals, crawlability, schema validity (1-10 per dimension)
03-onpage-findings.md          per-template issues with affected URL list
04-content-quality.md          E-E-A-T, thin/duplicate, topical coverage
05-link-profile.md             own backlink health (hand off to backlink-gap for prospect work)
06-eeat-evaluation.md          author signals, expertise indicators, trust elements
07-local-seo.md                only if business profile.target_markets has local intent
08-quality-scorecard.md        the gates below — must pass for status: ready
09-prioritised-actions.md      impact × effort matrix, top 20 actions
PLAN.md                        single-page deliverable

下游技能（seo-implement、seo-plan、content-engine）会读取 PLAN.md 和相关编号文件，而不是重新查询。

质量评分表

门槛	检查内容
crawl_coverage	≥ 90% 的网站地图 URL 已成功爬取（否则输入数据不完整）
dimension_completeness	6 个必需维度（技术、页面、内容、E-E-A-T、链接，以及适用时的本地 SEO）均已填写评分
finding_actionability	每项“高影响”发现事项都有明确负责人和工作量估算（否则不具备可执行性）
core_update_flag_set	如果审计在 Core Update 窗口期内运行，00-input.md 会标记此情况，且 PLAN.md 会包含“等待 7-14 天后再进行应急更改”的提示

status: ready 要求全部四道门槛均通过。

链式交接

• 上游： 品牌资料 +（可选）此前的 tech-seo-audit、aeo-audit 输出
• 下游：
  • /digital-marketing-pro:seo-implement — 将优先级最高的 N 项发现应用到 CMS / 开发待办事项
  • /digital-marketing-pro:seo-plan — 通过调度器支柱评分机制使用这些内容
  • /digital-marketing-pro:backlink-gap — 用于链接潜在客户分析；05-link-profile.md 仅从自有域名角度进行分析
  • /digital-marketing-pro:seo-drift — 下一季度对比两份审计快照

提示与注意事项

• 在核心更新期间运行？ 在 00-input.md 中醒目标注，不要建议采取应急调整。审计发现仍然有效，但采取行动的时机并非如此。
• 页面超过 10k 的网站不要按 URL 逐个审计。 按模板抽样（按模板分组，每种模板审计一个代表性 URL，然后推广结论）。
• E-E-A-T 评分属于判断，而非测量。 两位资深 SEO 人员对同一网站的各项评分可能相差约 1 分。应结合品牌所在行业进行校准：对于 SaaS，作者信号 7/10 已属优秀；但对于 YMYL 健康类出版商，这只是最低可行水平。
• 本地 SEO 维度仅适用于品牌资料中的 business_model: local，或 target_markets 包含提供实体服务的特定地理区域。否则请跳过。
• 此处的链接档案维度关注自有域名健康状况（失效链接、重定向链、入站链接的锚文本分布）。如需分析竞争对手的链接差距，请交接给 /digital-marketing-pro:backlink-gap，不要在此次审计中兼做两项分析。

使用的 Agent

• seo-specialist — 负责所有审计维度、评分、优先级排序和建议