排名数据

工作原理

Google Search Console (GSC) 追踪每一个为你带来展示或点击的搜索查询。ZensInk 连接 GSC API 拉取这些数据——哪些查询有排名、排第几、点击率多少。

这是你自己的真实数据，不是估算。这是 Google 视角下最准确的站点画像。

配置

1. 在 Google Search Console 验证站点

在 search.google.com/search-console 添加你的域名。验证所有权（域名属性用 DNS TXT 记录最简单）。

2. 创建 OAuth 凭证

ZensInk 需要只读 API 访问。在 Google Cloud Console 创建 Desktop OAuth 客户端，然后运行一次性配置脚本：

python3 -m zens_ink.setup_gsc

这会打开浏览器授权，并把凭证保存到 ~/.config/gcloud/application_default_credentials.json。

3. 配置站点 URL

在 .env 中：

GSC_SITE_URL=sc-domain:example.com

域名属性用 sc-domain:，URL 前缀属性用 https://。

用法

热门查询

查看哪些搜索词为你带来最多展示：

python3 -m zens_ink.search_performance --queries

热门页面

查看哪些页面获得最多搜索流量：

python3 -m zens_ink.search_performance --pages

按页面路径筛选

聚焦某个分区：

python3 -m zens_ink.search_performance --page /blog/

日期范围

python3 -m zens_ink.search_performance --start 2025-01-01 --end 2025-06-30

国家分布

python3 -m zens_ink.search_performance --country

输出格式

================================================================================
  sc-domain:example.com | query | 2025-01-01 - 2025-06-25
  47 rows | 3402 impressions | 89 clicks
================================================================================

  seo tools free                        imp=  420  clk= 12  CTR=2.9%  pos= 12.4
  keyword research tool                 imp=  310  clk=  8  CTR=2.6%  pos= 15.1
  best ai seo tool                      imp=  180  clk=  5  CTR=2.8%  pos= 18.7