# Google Search Console API：由你的 agent 读取点击、展示与热门查询

连接你已有的 Search Console 资源，你的 agent 就能读取与界面相同的数字：任意日期范围内每个查询的点击、展示、CTR 和平均排名。

## 怎么让 鹦鹉AI 做这件事？

安装行（粘到任意 agent）：`set up 鹦鹉AI — https://parrot.amorist.cn/llms.txt`

然后说：「使用 鹦鹉AI，列出 鹦鹉AI 在过去 28 天里排名第 8 到第 20 位、展示次数超过 50 的查询，按展示次数排序，并告诉我哪些查询的 CTR 最差。」

- **只需连接一次** 为你拥有的资源点一次 OAuth 授权即可。令牌由 鹦鹉AI 持有，不需要你来保管。
- **用大白话提问** 日期范围、筛选和排序是 agent 的活，不是你的。
- **把窗口结束日提前 3 天** Search Console 的数据滞后 2 到 3 天；昨天的数据还是初步数据。

## 为什么走鹦鹉AI

- **不订阅，不买席位** 按次计费。不用绑卡、没有最低消费；给预付余额充值即可。
- **换个工具只是换一个词** 提示词里换一个词就是另一款工具，而不是一次新的集成。

端点：

- `google-search-console.performance` — 站点搜索表现 — 点击、展示、CTR (search-console): https://parrot.amorist.cn/catalog/search-console

## 真正不一样的地方

- 把窗口截止日期设为昨天，实际上是在用初步数据做判断。请用截止到 3 天前的 28 天窗口来做评估。
- 界面的查询表最多 1,000 行；API 可以通过分页越过这个上限，长尾数据就在那里。
- 查询量极低的查询会因隐私原因被隐去，所以按查询拆分的各项合计不会等于站点总计。这个差额是正常的。

## 什么是 Search Console API？

Search Console API 把站点的 Google 搜索表现作为数据返回：点击、展示、CTR 和平均排名，可按查询、页面、国家/地区、设备和日期拆分。它与「效果」报告是同一份数据，但没有界面的行数限制，也是了解用户实际搜了什么才来到你站点的唯一第一方来源。

## 开始之前

**我需要连接什么？** 用那个已有该资源访问权限的 Google 账号，通过 OAuth 授权页面连接一次即可。鹦鹉AI 在服务端保存令牌；你的 agent 始终看不到它。

**我的 agent 能看到别人的站点吗？** 不能。API 只返回你已连接账号有权访问的资源。

**哪些 agent 可以做这件事？** 鹦鹉AI，它规划步骤、发起调用。

HTML 版本： https://parrot.amorist.cn/use-cases/search-console-queries