Google Search Console

The Search Console integration displays search performance metrics (clicks, impressions, CTR, average position) in the dashboard.

What It Does

• Pulls search performance data for monitored sites
• Shows keyword rankings and click-through rates
• Complements the SEO pipeline with real search data

Setup

1. Use the Same Google Cloud Service Account

If you already set up GA4, use the same service account. If not, follow the GA4 setup to create a service account first.

2. Enable the Search Console API

1. In Google Cloud Console, go to APIs & Services > Enable APIs
2. Search for and enable Google Search Console API

3. Add the Service Account to Search Console

1. Go to search.google.com/search-console
2. Select your property
3. Go to Settings > Users and permissions > Add user
4. Enter the service account email with Full permission

4. Configure Environment Variables

# In gridwork-hq/.env.local
GOOGLE_SERVICE_ACCOUNT_JSON={"type":"service_account","project_id":"..."}
GSC_SITE_URL=https://www.yourdomain.com

Environment Variables

Without This Integration

Without Search Console configured, the search performance sections show "Not configured." SEO pipelines still function using other data sources (Brave Search, Ahrefs data provided manually).