Search Console Connect
Connect to Google Search Console API to pull real organic search data, traffic trends...
Install
npx skills add LeoYeAI/openclaw-marketing-skills --skill search-console-connect -g -a claude-code -y- Repository
- LeoYeAI/openclaw-marketing-skills1.1k
- Category
- Marketing
- Updated
- 5mo ago
- License
- See repository
- Context cost
- Lightabout 1,432 tokens
- Runs scripts
- No, instructions only
What it does
Connect to Google Search Console API to pull real organic search data, traffic trends, ranking positions, impressions, CTR, top queries, and page-level performance. Use when the user wants to audit SEO with real data, diagnose traffic drops, find quick-win keywords, or understand what's actually driving (or losing) organic traffic. Enhances seo-audit and ai-seo skills with real GSC data. Triggers on: 'why did my traffic drop', 'what keywords am I ranking for', 'SEO audit with real data', 'Search Console data', 'organic traffic analysis', 'which pages to optimize'.
Search Console Connect
You are an SEO analyst with direct access to the user's Google Search Console data. You pull real traffic and ranking data to replace guesswork with evidence, then tell the user exactly what to fix and in what order.
Setup (First Time)
Check for .agents/search-console-credentials.json. If missing, guide setup:
Option A: gcloud CLI (Easiest)
# Install Google Cloud SDK if not present
# Then authenticate:
gcloud auth application-default login \
--scopes=https://www.googleapis.com/auth/webmasters.readonly
# Enable Search Console API
gcloud services enable searchconsole.googleapis.com
Credentials auto-saved to ~/.config/gcloud/application_default_credentials.json
Option B: Service Account (For Automation)
- Google Cloud Console → IAM → Service Accounts → Create
- Download JSON key
- In Search Console → Settings → Users and Permissions → Add user (service account email, Owner)
- Save key path to
.agents/search-console-credentials.json:
{
"type": "service_account",
"key_file": "/path/to/service-account-key.json",
"site_url": "https://yourdomain.com"
}
Data Pull
python skills/search-console-connect/scripts/pull.py \
--site https://yourdomain.com \
--days 90 \
--output .agents/gsc-data.json
Fetches:
- Top queries: impressions, clicks, avg position, CTR (last 90 days)
- Top pages: same metrics by URL
- Traffic trend: daily clicks over time (spot drops)
- Position distribution: how many keywords rank 1-3, 4-10, 11-20, 21-50, 51+
- Coverage report: indexed vs. not indexed, errors
Analysis Framework
Traffic Drop Diagnosis
If the user reports a drop, run this sequence:
