会议室白板上还留着上次改版画的箭头，新问题就找上门了：“这个页面怎么没进 AI 搜索的答案里？”要是你已经装好了 geo-seo-claude，配置 GEO 审计根本不用找什么藏起来的后台开关——它的配置主要就四块：Claude Code 的 Skill 目录、目标 URL、可访问范围，还有输出文件。能查什么得先讲明白，不能验证的边界也得提前划清楚。

先确认 Claude Code 已识别 Skill

Claude Code 会自动从 Skill 目录里识别带 SKILL.md 的能力模块。geo-seo-claude 的 macOS/Linux 安装脚本，会把主入口放在 ~/.claude/skills/geo，各专项能力放在同层级的 geo-* 目录，分析用的 Agent 则放在 ~/.claude/agents。咱们先做个只读检查：

test -f ~/.claude/skills/geo/SKILL.md
test -d ~/.claude/skills/geo-audit
ls ~/.claude/agents/geo-*.md

要是这三项检查都有正常结果，再开一个新的 Claude Code 会话，试试运行 /geo quick https://example.com。如果能返回内联快照，就说明入口已经生效了。要是失败了，先排查路径、Python 环境和网络问题，别上来就改目标网站。毕竟 Skill 都没被识别的话，你调任何审计参数都没用。

完整审计只需要一个公开 URL，但范围得自己把好关

正式的审计命令是：

/geo audit https://example.com

运行后，项目会先读取首页、判断业务类型，再从 sitemap 或者内部链接里抽取待检查页面，最多处理 50 页；单页抓取超时设为 30 秒，请求之间有间隔，还会限制并发数。之后会有 5 个 Agent 分别负责 AI 可见性、平台适配、技术问题、内容质量和结构化数据这几块的检查，最后汇总生成 GEO-AUDIT-REPORT.md。

注意，这个工具没有官方文档支持的 --limit、--include 或者 --exclude 这类命令行参数，别凭过往经验瞎加。如果站点规模很大，可以先把要审计的产品、栏目、高价值页面用自然语言写成约束条件，等审计跑完后，再核对报告里实际列出的 URL 对不对。要是范围限制没生效，就改用单页专项命令分批处理。

哪些专项命令适合排错？

• /geo crawlers <url>：检查 robots.txt 配置和 AI 爬虫的访问情况。如果页面需要登录，它没法帮你获取访问权限。
• /geo citability <url>：检查页面段落的可抽取性和可引用性。就算分数高，也不代表平台一定会引用。
• /geo technical <url>：排查状态码、渲染、移动端适配这类基础技术问题。真实的 Core Web Vitals 数据，还是得去官方正式数据源复核。
• /geo schema <url>：识别并校验页面的结构化数据。工具生成的 JSON-LD，只有和页面可见的事实内容一致时才能部署。
• /geo platforms <url>：整理不同 AI 搜索平台的优化建议。平台规则是会变的，关键结论一定要和最新的官方文档交叉核对。

报告怎么配置成可执行任务

完整审计用的是项目自带的加权模型：可引用性和可见性占 25%，品牌信号和内容质量各占 20%，技术项占 15%，结构化数据和平台适配各占 10%。这个权重只能用来解释报告里的优先级排序，可不是 ChatGPT 或者 Google 的官方评分。要是分数看起来异常，先看采集到的页面有哪些，再核对每一类的证据；要是输入的样本本身就偏，就算分数精确到个位数也没意义。

建议给报告里的每一条问题都补上四个字段：受影响的 URL、负责人、外部验证指标、复查日期。比如抓取阻断的问题，可以用服务器日志验证；索引问题用搜索平台的官方数据验证；引用和推荐效果，就看真实的来源流量和品牌查询量。要是只在报告里把状态改成“已完成”，却没有外部数据支撑，那审计就变成自说自话了。

失败时怎么办

如果目标站点返回 403、有登录墙，或者严重依赖客户端渲染，工具抓取到的内容可能和真实用户看到的不一样；这时候先换个公开页面验证安装是否正常，再去处理访问权限的问题。非交互安装的情况下，默认会跳过 Playwright 浏览器，所以没有截图不代表核心审计失败了。另外，PDF 报告还依赖 pandoc 和 Chrome，要是最后只生成了 Markdown 报告，别误以为是分析没跑完。

项目的主 Skill 里虽然列了 /geo page 这个命令，但从当前的命令参考说明来看，它还没有独立实现；要是需要稳定的单页检查，优先用 citability、technical、schema 这些已经落地到专项 Skill 里的命令。如果文档和仓库目录的内容不一致，就按当前提交的实际情况来核验，别自己脑补工具没实现的功能。

完成检查

1. 主 Skill、各专项目录，还有 5 个 Agent 文件都能正常找到。
2. /geo quick 命令能对公开测试页返回正常结果。
3. /geo audit 命令能生成 GEO-AUDIT-REPORT.md，且里面的 URL 清单符合预期范围。
4. 高优先级问题都能对应到具体页面、证据和负责人。
5. 工具给出的分数，不会被当成平台收录、排名或者引用的承诺。

把这套配置跑通之后，Claude Code 就能把跨页面、跨专项的检查都集中起来处理。它擅长的是发现线索、整理任务，不擅长帮你判断商业优先级，也没法访问没有授权的内容。把采集范围和验证指标牢牢握在自己手里，GEO 审计才不会只剩个好看的分数。