Google 搜索控制台徽标

搜索引擎优化及搜索

连接 谷歌搜索控制台 适用于 Excel、Google Sheets、AI 和 REST

查询、页面、国家/地区和设备以表格形式呈现。Query Streams 内部用于自身 SEO 的连接器也与此相同。

免费开始 13个目的地

一个连接，每个表面

搜索控制台数据可以去哪里

谷歌搜索控制台 实时 API 数据 作为 SQL 表
联合查询 + 任何其他连接器 · 一条 SQL 跨来源 · 每个计划
网络代理
  • 1 出站连接
  • 0 入境口岸
  • 只读 · 凭据保留

运行

Query Streams 将 Search Console 属性转换为 SQL 语句——将每个查询、页面、国家/地区和设备的组合都作为一行列存储在一个表中，此外还包括您的网站、站点地图和检查结果——这些数据可以通过 Microsoft Excel、Google Sheets、Power BI、MCP 上的 AI 助手以及 REST 端点读取。它会提取 Google 在首次同步时保留的全部 16 个月的数据，而 Search Console 界面不会一次性提供这些数据。

  1. 为您的团队、供应商和合作伙伴

  2. Search Console 到 Excel 微软 Excel · Excel 加载项

    将实时搜索控制台结果直接提取到工作表中，并按需刷新——支持桌面版 Excel、Excel Online 和 Microsoft 365。

    搜索控制台指南

  3. Search Console 到 Google Sheets 表格插件

    从侧边栏运行已保存的 Search Console 查询，并将结果行拖放到工作表中。共享协作者可以自行刷新工作表。

    搜索控制台指南

  4. 向 Nova 询问有关 Search Console 的问题 Nova AI · 文本转 SQL

    用简单的英语提问。Nova 已经了解您的 Search Console 表，会自动编写并运行 SQL 查询，解释答案并绘制图表——无需编写查询语句，也无需提供任何凭据。

    Nova 的工作原理

  5. 搜索控制台到数据查看器 结果共享 · 团队、供应商、合作伙伴 · 手机、平板电脑、台式机

    您可以与任何人（同事、供应商、合作伙伴）共享实时 Search Console 结果，将其以可收藏的网格形式呈现，无论在手机、平板电脑还是台式机上打开，结果都会重新显示。他们看到的是结果，而不是 SQL 语句或凭据。

    数据查看器的工作原理
  6. 对于应用程序和系统

  7. 搜索控制台 REST API HTTP 端点

    将 Search Console 查询发布为任何应用程序都可以调用的已认证 JSON 端点，符合 OpenAPI 3.1 规范，并预置了 Postman、Insomnia 和 Hoppscotch 集合。无需打开数据库端口。

    REST API 的工作原理

  8. Search Console 到 Power BI Power Query M

    将生成的 Power Query M 粘贴到 Power BI 高级编辑器中，报表即可通过 HTTPS 读取实时搜索控制台结果——无需 ODBC 驱动程序，也无需打开数据库端口。

    Power BI 的工作原理

  9. Search Console 到 Airtable 自动化平台

    按计划将搜索控制台行同步到 Airtable，或者在 Airtable 自动化脚本中获取它们。

    搜索控制台指南

  10. 搜索控制台到 Baserow 自动化平台

    通过 REST 端点从 Search Console 向 Baserow 表提供数据——无论是自托管还是 Baserow 云。

    搜索控制台指南

  11. 搜索控制台到 SeaTable 自动化平台

    无需导出文件或公开数据库，即可使用 Search Console 数据保持 SeaTable 数据库的最新状态。

    搜索控制台指南

  12. 搜索控制台到 Smartsheet 自动化平台

    将 Search Console 的结果推送到 Smartsheet 网格中，以便计划和报告从源系统读取数据，而不是从上周的导出数据读取数据。

    搜索控制台指南

  13. Search Console 到 Anvil Anvil Works · 应用平台

    通过 REST 端点将 Anvil Python 应用程序与 Search Console 连接起来，而不是将数据库凭据嵌入到应用程序中。

    搜索控制台指南
  14. 人工智能工具

  15. 搜索控制台 MCP 服务器 Claude、Cursor 和 MCP 客户端

    赋予 AI 助手对 Search Console 的只读访问权限，并提供它编写正确 SQL 所需的架构——聊天中无需提供凭据。

    搜索控制台指南
  16. 已送达

  17. 搜索控制台警报和报告 Slack · Discord · 电子邮件 · Webhook

    将 Search Console 查询设置为定时执行，并将查询结果发送到 Slack、Discord、电子邮件或签名 webhook，或者等到行数、阈值或百分比变化超过您设定的阈值时才发送消息。

    警报和报告的工作原理

工作原理

5 个步骤，无需更改入站防火墙规则

01

创建一个 Google 服务帐号，并将其添加为 Search Console 媒体资源中的用户。

02

安装网络代理并向其提供服务帐户密钥和站点 URL（可以是 https 形式或 sc-domain 形式）。

03

保存。首次同步将回溯过去十六个月，涵盖所有五种搜索类型。

04

针对 gsc.search_analytics 编写普通 SQL — 或者让 Nova 来编写。

05

从 Excel、Sheets、Power BI、MCP 或 REST 读取数据，并将其连接到存储您的注册信息和收入的任何系统。

专题深度解析

搜索控制台能为您提供什么

十六个月，汇总在一张表格中

Search Console 会保留十六个月的数据，并分阶段显示。一旦数据导入 SQL，界面无法实现的同比比较就只能通过 GROUP BY 语句来实现。

  • gsc.search_analytics 记录每条查询、页面、国家/地区、设备和日期对应的数据，包括点击次数、展示次数、点击率和平均排名。
  • 同步了五种搜索类型，而不仅仅是网页搜索。 — 图片、视频、新闻和“发现”类别也会出现，每个类别都有标签。
  • Discover 和 News 行不包含查询或设备信息，因为 Google 不会报告这些维度。这些列为空，并非人为创建。
  • gsc.sites 和 gsc.sitemaps 作为它们自己的表，因此可以查询提交计数与索引计数。

坦诚面对谷歌的延迟问题

Search Console 的数据大约滞后三天，而且最近几天的数据在首次显示后还会不断变化。这两种情况都是 Google 的惯例，而且这两种情况都是公开显示的，而不是隐藏的。

  • 同步时间会追溯到三天前，因为请求更新的数据明天就会返回错误的数字。
  • 每一行都有一个 data_state 列，用于标记它是部分结算还是最终结算，因此报告可以排除仍在结算中的日期，而不是默默地将它们平均计算在内。
  • 每次增量扫描都会重新读取最后五天的数据，因此部分行会成为最终行，而不是保持最初看到的版本。

我们自己也在用这个。

Query Streams 会在此连接器上运行其自身的 SEO——相同的表、相同的三天延迟、相同的部分结果与最终结果标识。它并非为展示 logo 而构建的演示集成。

  • 如果一个查询返回的结果超过 Google 每天每页返回的 25000 行，那么你得到的就是这部分结果；将其拆分到更多维度并不会自动进行。
  • URL 检查表存在，并且是按需填充的，而不是通过计划的同步填充的。

每个 API 连接器共享

每个 API 连接器的工作原理

  • 您的帐户将变成表格 — 端点映射到具有主键和索引的类型化 SQL 表，因此您可以编写 SELECT、JOIN 和 GROUP BY，而不是翻阅 JSON。
  • 您可以选择同步哪些内容以及同步频率。 每个表都有自己的时间间隔，或者根本没有时间间隔。如果供应商的 API 支持，则只会获取自上次运行以来发生更改的记录。
  • 副本归你所有 它以 AES-256-GCM 加密的形式存储在您本地的 DuckDB 文件中，与代理程序位于同一位置。它不在我们的云端。
  • 供应商只会收到你的消息。 — 代理直接从您自己的网络调用 API，因此 Query Streams 不需要您的令牌来回答查询。

知道这个很有用

  • 这是一个同步副本，而不是实时代理。 — 查询读取的是已经获取过的数据，因此返回速度与 SQL 查询相同，不会超出 API 速率限制。此外，所选表还可以在读取数据时刷新过期的行。
  • 您的速率限制将得到遵守。 — 每个连接器都会在供应商公布的限制范围内自行控制速度，因此报告不会导致您的帐户对使用它的其他所有帐户进行限速。
  • 没有东西会被扔掉 — 表中未命名的字段保存在 raw_data JSON 列中，您仍然可以对其进行查询。
  • 将其连接到您的数据库 — 在同一条语句中同时使用 API 表和 SQL Server 表在这里只是普通的查询，而不是集成项目。

跨源 SQL

将 Search Console 与您的其他数据连接起来

Search Console 可以告诉你哪个页面带来了点击。但它无法告诉你哪些点击最终促成了账户注册，也无法告诉你账户最终支付了多少费用。这两项信息由其他渠道提供，一条报表可以涵盖所有三项内容。每个数据源只运行其能够处理的部分，并将结果流式传输回服务器，所有数据合并都在中央完成——各个数据源之间互不通信，也不会复制任何数据。

3 个连接 · 3 个代理

谷歌搜索控制台 搜索引擎优化及搜索
PostgreSQL 关系引擎
条纹 付款与账单

一份声明

——来自搜索引擎控制台的点击量、数据库中的注册量、来自 Stripe 的收入
选择   s.page, SUM(s.clicks) AS clicks, SUM(i.amount_due) AS invoiced
从     gsc_site.gsc.search_analytics1 s
连接     pg_crm.public.customers2       c ON c.landing_page = s.page
连接     计费.stripe.invoices3       i ON i.customer = c.stripe_id
GROUP BY s.page
ORDER BY 点击 DESC；

这三个部分分别是连接、架构和表——连接名称就是您自己命名的。列仅供参考；您的表将就是您自己的表。Search Console 数据最多可追溯到三天前，这是 Google 自身的报告延迟，并非同步操作造成的。所有部分均采用只读模式：仅支持 SELECT、WITH 和 EXPLAIN 语句，并且对单个查询中每个数据源可传输的数据量有限制。 联合查询的工作原理

连接详情

搜索控制台需要什么

验证
已添加为房源用户的 Google 服务帐户密钥。只读权限，由代理持有。
财产
网站 URL — https://example.com/ 或 sc-domain:example.com。如果留空，则帐户可以看到的所有房产都会同步。
伸手够到
从您的网络到 Search Console API 的 HTTPS 连接正常。没有入站流量。
模式
gsc — 因此包括 gsc.search_analytics、gsc.sitemaps
表格
4. 搜索分析、站点、站点地图和 URL 检查
搜索类型
网络、图片、视频、新闻和发现，每个类别都标注在这一行中。
新鲜
数据更新至三天前，这是谷歌自身的数据报告滞后。每次更新都会重新读取最近五天的数据。
历史
首次同步后 16 个月——Google 保留所有内容
本地副本
代理程序旁边，您的计算机上有一个使用 AES-256-GCM 加密的 DuckDB 文件。

只读是结构性的。此连接器发出的每次调用都是读取操作，并且它持有的令牌是范围只读的——它不能提交站点地图或请求索引。

在跨源查询中，三部分引用的中间部分是 gsc。名为 gsc_site 的连接读取搜索分析数据，其写法为 gsc_site.gsc.search_analytics。

供应商文档： search.google.com

常问问题

关于 Google Search Console 的问题

哪些工具可以通过查询流读取 Google Search Console 数据？

只需一次连接，即可访问所有平台：Excel、Google Sheets、MCP、REST API、Airtable、Baserow、SeaTable、Smartsheet、Anvil、Power BI、定时提醒和报表。只需连接一次帐户，所有平台即可读取同一个只读连接——无需为每个工具单独设置，也无需创建数据副本。

我是否需要为我的 Google Search Console 帐户打开防火墙端口？

不。Query Streams 网络代理运行在您的网络内部，并打开一个单独的出站加密连接。它不会监听入站流量，无需 VPN，并且帐户会保留其现有的防火墙规则。

查询流能否更改 Google Search Console 中的数据？

不。代理在执行时强制执行只读模式——一次只执行一条语句，仅限 SELECT 及其相关语句。凭据保留在代理上，绝不会发送到查询流。

Query Streams 需要连接到 Google Search Console 的哪些组件？

可访问的主机、角色及其密码——代理程序携带驱动程序，因此无需在帐户上安装任何内容。身份验证：Google 服务帐户密钥，已作为用户添加到媒体资源中。只读权限，由代理程序持有。媒体资源：网站 URL——https://example.com/ 或 sc-domain:example.com。如果留空，则帐户可以访问的所有媒体资源都会同步。访问方式：通过 HTTPS 从您的网络访问 Search Console API。无入站请求。架构：gsc——例如 gsc.search_analytics、gsc.sitemaps。

我可以在同一个查询中将 Google Search Console 连接到另一个数据库吗？

是的——这就是联合查询。一条语句可以同时引用 Google Search Console 和其他连接，格式为 connection.schema.table。每个数据源只运行它能够执行的部分，并将结果流式传输回来；连接操作在中心进行，因此各个数据源之间不会相互连接，也不会进行任何复制或调度。所有部分（SELECT、WITH 和 EXPLAIN）都采用只读模式，并且单个数据源在单次查询中可以传输的数据量有限制。联合查询是一项套餐功能；联合查询页面会显示当前的数据源和大小限制。

将 Search Console 放置在工作地点。

安装代理，将其指向您的帐户，然后选择目标位置。

免费开始 所有连接器

只读 仅限出站 凭证保留在代理人身上。