Google 搜索洞察代理

要解决的问题

Google Search Console 的搜索分析接口返回的是一张很宽的数据表：成千上万条查询、页面、设备、国家的组合，每行带 impressions、CTR、position。人工在后台翻页面只能看到聚合后的曲线，想回答「哪个查询的排名掉了」「哪个国家转化率异常」「某类页面整体 CTR 是否低于站内平均」这类问题，往往要把数据导出来自己算。这个技能解决的就是这一步：直接从 API 拉取结构化数据，再按维度切片做趋势分析。

它如何工作

核心只有一个调用：向 Google Search Console API v1 的 searchAnalytics/query 端点发起请求。技能的主要工作分三步：

• 取数：用站点属性授权后请求 searchAnalytics/query，拿到包含 impressions、clicks、ctr、position 的行级数据；
• 切片：按 page、query、device、country 维度做过滤和分组，把大表拆成可分析的子集；
• 看趋势：基于 position 和 CTR 的时间序列判断涨跌，定位是查询侧、页面侧还是设备/地区侧的问题。

适用边界与注意点

• 数据依赖 GSC 侧的统计与归集，接口返回的是抽样和估算值，小流量站点 position 波动大，单条查询的结论要谨慎对待；
• position 是该查询下的平均排名，并非精确排名；
• 需要站点已通过验证且具备 Search Analytics 数据权限，新站或刚验证的站点可能拿到空结果；
• 维度过滤依赖数据本身有展示量，长尾查询若 impressions 为 0，通常不会出现在结果里。