seo-audit 适合搜索表现下降、网站改版后排查，或上线前检查关键页面。它不会凭一个首页就知道全站健康状况；你提供的 URL、Search Console 导出和访问能力决定它能检查到哪一层。
安装与调用
在项目目录的终端运行下面的命令，只安装这个 Skill 到 Claude Code：
npx skills add coreyhaines31/marketingskills --skill seo-audit -a claude-code
需要 Node.js 和可用的 npx。若使用 Codex，把 -a claude-code 换成 -a codex；在对话里明确要求使用 seo-audit 并附上材料，不把终端安装命令当成任务提示。其他客户端应使用自身的技能选择入口。
先说明哪里发生了变化
准备一个小而清楚的范围：网站地址、最重要的五到十个 URL、异常开始时间，以及这之前做过的迁移、模板或内容更新。能导出 Search Console 的网页与查询数据时一并提供，不能访问后台的部分应写明未知。可以这样输入：
使用 seo-audit 检查 example.com 的这十个页面，清单见 urls.csv。
改版后自然点击下降，变更记录在 migration.md，GSC 导出在 search.csv。
先排查抓取、索引和 canonical，再检查页面内容。每个问题给 URL、观察证据、影响和验证方法。
无法访问的数据不要推断为正常或异常。
先看重要页面是否被 robots、noindex、错误 canonical 或重定向阻断，再检查站点地图是否指向正确、可索引的地址。一个无法进入索引的关键页面，通常比几个描述标签的小问题更值得先处理。参数 URL、重复地址和软 404 要结合真实响应与页面内容判断。
让结论能被复核
要求把“发现了什么”和“建议怎么改”分开。速度、移动端和内容检查应给出对应页面、测试条件与影响，而不是只列通用最佳实践。页面标题、正文和搜索意图是否一致，重要内容能否通过内链找到，也应从实际页面举例。
特别注意结构化数据：纯文本抓取器可能移除 JSON-LD，客户端脚本也可能在浏览器中才生成内容。不能因为一次 Markdown 提取没看到代码，就断言网站没有 schema；需要查看渲染后的页面或专门测试工具。Google 的政策还要求标记与用户可见内容一致，测试通过也不保证富结果出现。
最后让 Agent 只选最先处理的三到五项，写清修改位置与复查方式。修复后重新检查同一组 URL，并观察后续索引与搜索数据，不要拿当天波动作为成功证明。如果材料只有首页，交付物应称为首页或抽样审核，不能包装成全站结论。
按影响范围追到具体页面
先挑一个已经观察到的问题，而不是让 Skill 把所有 SEO 项目列一遍。例如一组英文页面上线后没有被索引，输入应包括代表 URL、站点地图、robots.txt、canonical、语言互链和 Search Console 状态。让 Agent 从“能否抓取、是否可索引、被哪个 URL 取代”开始排查；如果页面根本没被收录，先改文案细节通常不是第一步。
检查结果应做成“问题—证据 URL 或工具截图—影响页面数—修复办法—复查办法”的表。对双语站，中文与英文页面要分别核对 canonical 指向自身还是其他 URL，hreflang 是否互相指向，站点地图是否列出实际可访问的地址。一个模板的错误可能影响几十页；一篇文章标题不好则只影响局部，因此优先级不能只按清单顺序排。
修复后重新查看真实页面、HTTP 响应和索引报告，并记下日期。注意结构化数据可能由客户端或服务端生成，单一抓取方式看不到不等于它必然缺失；确认渲染后的输出。把“建议”“已修改”“搜索引擎已重新处理”分为不同状态，避免把完成代码修改误写成排名已经改善。
示例：排查一组英文页面被中文页取代
双语站新增英文指南后，Search Console 显示部分英文 URL 被归到另一篇规范页。准备两对受影响 URL、页面源码、sitemap 与部署前后记录，输入：“使用 seo-audit 先查 HTTP 状态、canonical、hreflang、内部链接和正文语言。把每项结果连到具体 URL，按模板级与单页级分组；证据不足时写待检查，不推断为 Google 出错。”
验收时修复建议必须能指向一个可重现的差异：例如英文页 canonical 误指中文页，或站内链接始终指向中文版本。若 Agent 一上来建议增加关键词密度，要求它先解释为何索引信号会错。修改模板后抽查更多 URL，确认互链和站点地图都使用线上绝对地址；再等待搜索引擎重新抓取，不把本地构建通过写成已经恢复收录。
用问题清单推动修复，再看结果
用户 Matt Minor 公开记录：他运行 Corey 的 seo-audit 得到问题清单，随后借 Directus MCP 修改标题、描述、页面内容及部分 JSON-LD；发帖时他明确说排名影响尚待观察。照这个流程操作时，先给每项发现附具体 URL 与可复查的症状，再把“已修复”“已部署”“搜索表现变化”放在不同列。这样不会把完成一次审计误认为已经带来流量。