报错是这么冒出来的。用网址检查接口批量查了两千条地址,verdict 全是 PASS,覆盖状态写的是已编入索引,site 查询却一条都搜不到。
真正麻烦的地方在于,几个原因的现象几乎一样。接口反映索引库状态,site 查询受节点和地域影响。也可能是页面能索引但没有排名,查询词与内容不匹配。
另外,结果被安全搜索或个性化设置过滤。
第一件事是核对接口返回的字段
curl -s 'https://searchconsole.googleapis.com/v1/urlInspection/index:inspect' -H 'Authorization: Bearer $TOKEN'
然后换精确标题片段再查
site:www.example.com "页面标题片段"
接着对比效果报告里的展示数
curl -s 'https://www.example.com/api/gsc?days=28' | head
末了抽一条看覆盖状态原文
curl -s 'https://www.example.com/api/inspect?url=/post/' | head
中途换过一次思路,把范围缩到最小的那一层,反而快了。
恢复的判定其实很直接。用标题片段能查到该页,效果报告里该页有展示记录,接口与报表状态一致。
site 查询是采样结果,数量波动不代表索引变化,判断收录以网址检查为准。报错文案容易误导,真正的原因往往在相邻那一层的日志里。
