文档
Data Studio：使用 AutoPSEO 数据构建报表
AutoPSEO 没有自己的 Data Studio 连接器。你可以使用 Google 的 Search Console 连接器、上传 CSV，或使用通过 REST API 保持更新的 Google 表格。
AutoPSEO 目前没有提供 Data Studio 连接器。Data Studio 是 Google 的仪表盘工具，前身为 Looker Studio。不过，你仍然可以通过三种方式在其中展示 AutoPSEO 的数据：使用 Google 自带的 Search Console 连接器获取原始数据，导入从 AutoPSEO 报表导出的 CSV，或者使用由定时脚本通过 AutoPSEO 的 REST API 写入数据的 Google 表格。选择哪种方式，取决于仪表盘需要多高的数据时效性，以及它需要的是 AutoPSEO 的分析结果，还是仅仅需要原始指标。
方案 1:Google 的 Search Console 连接器
Google 的连接器直接读取 Search Console 的数据，因此只能提供原始指标，不包含 AutoPSEO 的任何分析。根据 Google 的连接器指南:
- 它提供两张数据表，Site Impression 和 URL Impression，一个数据源只能使用其中一张。如需同时展示两张表，请在报表中添加两个数据源。
- 你至少需要拥有该 Search Console 媒体资源的查看权限，并且两个产品须使用同一个 Google 账号登录。
- Site Impression 涵盖网页、图片、视频和新闻结果；URL Impression 还包含 Discover 和 Google 新闻。
添加方法：依次选择 创建 → 数据源 → Search Console，选择网站、数据表和默认搜索类型，然后点击 连接。
方案 2：上传 AutoPSEO 导出的 CSV
对于一次性或按月更新的仪表盘，可以从任意报表中导出一张数据表(导出数据)，再通过 Data Studio 的 CSV 文件上传连接器添加。Google 的上传要求决定了导出时应如何设置：
- 字段必须以逗号分隔，因此请先将 账户 → CSV 导出格式 设为 标准（美国 / 英国）。
- 文件必须为 UTF-8 编码并包含表头行，AutoPSEO 的导出文件满足这两点。
- 添加到同一数据集的每个文件，其列必须完全相同且顺序一致，因此每次都请导出同一份报表，并使用相同的列和对比设置。
- 新文件会被追加到数据集中，且不会去除重复数据，因此请勿上传日期范围重叠的文件。
- 单个文件最大 100 MB，每位用户的上传存储空间为 2 GB。
百分比导出时带有百分号(27.03%)，因此上传后请检查字段类型。
方案 3：通过 REST API 更新的 Google 表格
如果希望仪表盘自动保持最新，可以让定时任务把 AutoPSEO 的数据写入 Google 表格，再连接该表格。每当报表发起查询时，Google 的表格连接器都会检查是否有数值变化或新增行。
- 在 AutoPSEO 中打开 MCP & API，创建一个权限范围为 只读 的 API 密钥。密钥只显示一次，请将其保存到任务的密钥配置中。
- 在定时任务（Google Apps Script、cron 任务或工作流工具）中调用 REST API，并将数据行写入表格。
- 在 Data Studio 中，通过 Google 表格连接器添加该表格，并勾选 将第一行用作标题。
获取最近 28 天热门查询词的调用示例如下：
curl -s "https://app.autopseo.com/v1/properties/sc-domain%3Aexample.com/queries?range=28d&limit=1000" \
-H "Authorization: Bearer apk_live_..."每个响应都是 JSON，结果位于 data 下，调用的详细信息位于 meta 下。REST API 提供的 19 个 Search Console 和 GA4 工具与 MCP 服务器相同：媒体资源、搜索分析数据行、热门查询词、页面和国家/地区、周期对比、排名变化、新增与丢失的排名、内容衰减、关键词自相残杀、CTR 基准、页面抢排名、URL 检查、站点地图、注释，以及 GA4 概览、细分和关键事件。热门查询词和热门页面最多返回 1,000 行，热门国家/地区最多 300 行，search-analytics 在使用一到两个维度时最多返回 5,000 行原始数据。调用频率限制为每个密钥每分钟 60 次、每个账户每小时 1,000 次，位于 https://app.autopseo.com/v1/openapi.json 的 OpenAPI 3.1 文档描述了每一个参数。
如何选择
| 你的需求 | 使用方式 |
|---|---|
| 由 Google 保持更新的原始点击量和展示次数 | Google 的 Search Console 连接器 |
| 某份 AutoPSEO 报表的月度快照 | CSV 上传 |
| 按计划获取 AutoPSEO 的分析结果，例如排名变化或内容衰减 | 由 REST API 更新的 Google 表格 |
如果搭建仪表盘主要是为了向客户展示数据，那么共享报表链接或定时发送的 Slack 或 Teams 报表可能更省事。我们的常见问题 Looker Studio 中的 Search Console 对 Google 的连接器有更深入的介绍。