tech-seo-audit

/digital-marketing-pro:tech-seo-audit

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

目的

开展全面的技术 SEO 审计，涵盖影响搜索引擎抓取、索引和排名的基础设施与代码层面因素。此审计侧重于技术基础，而非内容或反向链接。生成一份按优先级排序的报告，列出具体修复方案、预期影响和实施指南。

技术 SEO 与算法更新

截至 2026-10-04 的状态（限时信息——约在 2026-12 后重新核查）： 根据 Google 搜索状态信息中心，最近一次核心更新于 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）——请根据地区对第三方／“寄生”版块的审计结果措辞。

算法更新调整的是质量和政策权重，而非技术信号。如果品牌询问与已列出的更新同时发生的排名波动：

• 仍要运行此审计——权重重新调整时，相对质量会更加重要，因此更新会暴露已有的技术债务。低质量页面浪费抓取预算、规范链接链路断裂、软 404，以及孤立的 JS 渲染路由，都会放大损害。
• 不要轻信所谓可解决更新问题的爬虫／渲染“修复方案”。 如果没有解决根本问题，任何技术更改都无法消除质量或垃圾内容政策导致的影响。请将此审计与 /digital-marketing-pro:seo-audit（内容／E-E-A-T 部分）结合使用——两者缺一不可。
• Hreflang、结构化数据和 Core Web Vitals 仍保持其正常权重。 Google 文档更新日志中的两项结构化数据说明：VideoObject 新增了 creator 属性（2026 年 9 月 24 日）；评论摘要新增了反对虚假评论和未披露激励性评论的指南（2026 年 7 月 24 日）（参见 Search Central 更新）。

所需输入

用户必须提供（或系统会提示用户提供）：

• 网站 URL（必填）：要审计的域名或具体版块
• CMS／平台（有帮助）：WordPress、Shopify、Next.js、自定义平台等
• 已知问题（可选）：任何具体的技术问题
• 网站规模（有帮助）：页面的大致数量
• 国际业务情况（可选）：网站是否面向多个国家／地区或使用多种语言
• Google Search Console 数据访问权限（可选）：可使用实际数据而非估算数据

流程

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. 加载参考文件：阅读 skills/technical-seo/core-web-vitals.md、skills/technical-seo/crawlability.md、skills/technical-seo/site-architecture.md、skills/technical-seo/indexation.md 和 skills/technical-seo/international-seo.md，了解详细的技术 SEO 框架
3. 运行 tech-seo-auditor 脚本（如果有 Python）：python "${CLAUDE_PLUGIN_ROOT}/scripts/tech-seo-auditor.py" --url {url}，获取关于状态码、重定向、元标签和页面结构的自动化检查结果
4. 评估 Core Web Vitals：根据已知阈值评估 LCP、INP 和 CLS。如果已连接 GSC MCP，则获取实际 CrUX 数据。否则，根据 CMS/平台提供优化清单
5. 审计可抓取性：检查 robots.txt 配置、XML 站点地图的存在情况和结构、抓取预算考量因素，以及 JavaScript 渲染的影响
6. 检查索引情况：检查规范标签的使用、meta robots 指令、重复内容风险、索引膨胀可能性和分页处理
7. 分析网站架构：检查 URL 结构、内部链接模式、网站深度、导航效率和面包屑
8. 优化页面速度：检查图片优化、阻塞渲染的资源、压缩、缓存和 CDN 使用情况
9. 检查移动优先合规性：检查视口配置、响应式设计、移动端易用性和触控目标
10. 检查重定向状况：检测重定向链、HTTP/HTTPS 混用和尾部斜杠一致性
11. 检查结构化数据：检查 Schema 标记是否存在、是否通过验证、是否完整，并识别优化机会
12. 国际 SEO（如适用）：检查 Hreflang 实现、语言定位和 URL 结构
13. 安全检查：检查 HTTPS 强制使用、HSTS 和混合内容
14. 汇总并按优先级排序的报告：按严重程度（Critical / High / Medium / Low）归类发现的问题，并为每个问题提供具体修复说明、预估工作量和预期影响

输出

一份结构化的技术 SEO 审计报告，包含：

• 审计标题：品牌名称、URL、日期、CMS/平台、整体健康评分（0-100）
• 执行摘要：用 3-5 句话概述技术健康状况
• 严重问题（立即修复）：阻碍抓取或索引，或对排名造成显著影响的问题
• 高优先级（本周修复）：对排名或用户体验有可衡量影响的问题
• 中优先级（本月修复）：影响适中的优化机会
• 低优先级（待办事项）：细微改进和最佳实践对齐
• 每项发现均包含：描述、受影响的 URL/页面、具体修复方法及代码/配置示例、预估工作量（小时）、预期影响（流量/排名）
• Core Web Vitals 评分卡：LCP、INP、CLS 的当前估值和目标值
• 快速见效项列表：影响最大且所需工作量最少的 5 项修复
• 实施路线图：建议的发现问题处理时间表

提示与注意事项

• 合成测试（Lighthouse、PageSpeed Insights）得出的核心网页指标通常与现场数据（CrUX、GSC）不一致。 Google 排名依据的是现场数据。如果实验室数据为通过，但现场数据为未通过，请以现场数据为准。
• JavaScript 渲染是现代网站中导致未编入索引的头号隐患。 务必检查关键内容的渲染后 HTML（执行 JavaScript 后）是否与源 HTML 一致。使用 view-source: 与 DevTools 进行对比。
• 不要修复没有问题的地方。 核心网页指标达到第 95 百分位的网站无需重新设计——将精力用于内容更有价值。技术 SEO 是必要条件，但并非充分条件。
• robots.txt 与 meta robots 冲突很常见。如果两者都生效，Google 会遵循限制更严格的一方。务必交叉核对。
• **在核心算法更新期间，**仍需执行此审计——核心算法更新经常会暴露既有的技术债务，但相关修复属于基础工作，并非核心算法更新的补救措施。
• 链接档案相关工作不在本次技术审计的范围内。 本审计涵盖自有域名的技术健康状况（可抓取性、索引状态、重定向、规范链接、核心网页指标、结构化数据），不包括反向链接。有关自有域名的链接健康状况，请参阅 /digital-marketing-pro:seo-audit；有关竞争对手的链接差距分析，请转交给 /digital-marketing-pro:backlink-gap。

使用的 Agent

• seo-specialist — 从各个维度执行技术审计，生成结构化数据建议，提供针对特定 CMS 的修复指导，并按影响和工作量对发现的问题进行优先级排序