报错是这么冒出来的。用网址检查接口批量查了两千条地址,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 查询是采样结果,数量波动不代表索引变化,判断收录以网址检查为准。报错文案容易误导,真正的原因往往在相邻那一层的日志里。

作者 9823189