用途:geo-gaps 用于发现 URL 层级上阻碍 AI 搜索资格的技术障碍,把“能否访问”与“能否被选中”分开看待。内容若无法被系统抓取或使用就不可能被选中,但技术可访问并不保证被选中。该报告把抓取证据收窄到响应失败、robots 限制、非索引指令、被规范化的页面以及摘要控制上,属于诊断性 URL 列表,不是可见度评分。
主要能力:针对每个 URL,区分问题项与 searchEligibility,检查 HTML 是否成功响应、是否允许抓取、是否为可索引候选、声明与实际可索引状态、规范化证据以及摘要资格。access 状态为 null 表示未知,而非允许。语义化 HTML、结构化数据、作者信息、日期、问句标题、可回答区块都属于观察项,不能覆盖硬性访问限制,也不会自行创造资格。
使用方式:通过 MCP 时,如需发现报告可先调用 seo_list_reports 且 category 为 crawl,然后调用 seo_describe_report 并传 {"id":"geo-gaps"},再调用 seo_run_report,参数为 {"id":"geo-gaps","params":{"reportId":"crawl_example_20260710","limit":25}}。需确认 isError 为 false 并读取 structuredContent。CLI 流程为:seo reports describe geo-gaps --json 以及 seo reports run geo-gaps --params '{"reportId":"crawl_example_20260710","limit":25}' --json。
解读与限制:解读 URL 列表前先查看 dataStatus、source 与 selection;source.partialReasons 说明缺失的页面或请求证据、抓取不完整、页数上限停止、跳过 URL、请求失败与提取失败。结论需附上 configuredMaxPages、pageLimitReached、请求证据状态以及已评估、匹配、返回、截断的页面计数。传递的警告与注意事项仍是结果的一部分。把 noindex、robots 规则、规范链接或摘要限制视为缺陷前要先确认意图;先修复非本意的响应与访问冲突,部署后再验证确切 URL 与指令。完整结果只描述该次抓取评估过的页面,部分或不可用证据不能支撑“全部正常”的结论,空或很短的缺口列表也不能证明已收录、可见、被选中、被引用或站点覆盖完整。