实时搜索控制台数据
Give coding agents authenticated access to Google Search Console and Google Analytics 4 data via RefreshAgent. No GCP OAuth setup, no service accounts, and no manual key copying.
RefreshAgent is a secure proxy between the agent and Google's official GSC/GA4 APIs. The bundled Python helper handles authentication via a browser-based login flow that saves the API key to ~/.config/refreshagent/.env. All API calls go through Google's official APIs and cache ages are reported per-response for data freshness.
Installation
OpenClaw
clawhub install live-search-console-data
Direct from GitHub
npx skills add marketingskills/live-search-console-data
Capabilities
- List GSC sites and GA4 properties
- Traffic summaries with period-over-period comparison
- Top queries and pages by clicks and impressions
- Exact keyword position tracking with historical comparison
- Cannibalization detection (query+page conflicts)
- Sitemap submission status and index counts
- GA4 organic sessions, landing pages, and top events
- Client site mapping and proposal building
Usage
The skill includes a Python REST helper that handles authentication automatically. On first use it opens a browser-based Google sign-in to obtain an API key, saves it to ~/.config/refreshagent/.env, then continues the request.
python3 {skill_dir}/scripts/refreshagent_api.py GET /api/v1/sc/sites
python3 {skill_dir}/scripts/refreshagent_api.py GET /api/v1/sc/query --param site_url=sc-domain:example.com --param date_range=30d
python3 {skill_dir}/scripts/refreshagent_api.py GET /api/v1/sc/keyword-position --param site_url=sc-domain:example.com --param keyword="seo tools"
微信扫一扫