セットアップ
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データには時間がかかります。 Google は新しいサイトをゆっくりインデックスします。「No data yet」が出る場合、まだクロールされていないか検索トラフィックがゼロです。3 か月未満のサイトでは正常です。