出海 SEO 实战：想让 AI 分析网站流量，先把 GSC 授权搞对

做出海网站，Google Search Console 基本是绕不开的数据源。

我们平时看关键词、页面点击、搜索曝光、CTR、平均排名，很多都来自 GSC。

如果只是人工打开后台看数据，用网页就够了。但如果你想把这些数据接进自己的后台，做搜索增长看板、SEO 机会发现、文章选题分析，甚至让 AI Agent 自动分析关键词，就需要通过 Search Console API 读取数据。

这时候第一个问题就来了：怎么授权，用哪种方式比较好， OAuth 还是 Service Account？

这篇彻底梳理一下，尽可能用简单容易理解的句子，附带介绍怎么让 AI Agent 来完成这项有点麻烦的操作。细节部分不需要都弄明白，有了预期效果，把内容给到AI调研分析执行就好了。

GSC API 授权方式选择：OAuth vs Service Account

适合场景不同

OAuth 的授权主体是真人 Google 账号。

比如你已经用某个 Gmail 账号验证了网站，在 GSC 里能看到对应 property。

这个时候让这个账号授权你的应用访问 Search Console API，应用拿到 refresh token，后续就可以在服务端用 refresh token 换 access token，再去读取 GSC 数据。

它的好处是路径最直观。因为 GSC 本来就是围绕用户和站点权限来管理的，你用已经有权限的账号授权，权限链路最清楚。

它的问题是 refresh token 不是绝对永久。

用户撤销授权、OAuth client 变化、scope 变化、账号安全状态变化，都可能导致 token 失效。

还有一个容易忽略的点：如果 OAuth App 一直停在 Testing 状态，refresh token 会有更明显的短期失效风险。

Service Account 的授权主体是机器账号。

它没有传统 OAuth refresh token 这个概念，服务端通过 service account key 或其他工作负载身份去换 access token，更像机器到机器调用。对很多 Google Cloud API 来说，这种方式非常适合后台任务。