Google Search Console Connection

Connects your agent to Google Search Console for search performance data. Pull query-level and page-level performance, index coverage status, and core web vitals. Read-only access.

Authentication

OAuth2 or service account (same as GA4 if using service account).

• client_email — Service account email
• private_key — Service account private key
• site_url — Verified property URL (e.g., https://example.com or sc-domain:example.com)

Endpoints

Search Analytics

• POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query — Query performance data (clicks, impressions, CTR, position) by date, query, page, country, device
• GET /webmasters/v3/sites/{siteUrl}/sitemaps — List submitted sitemaps with status

Index Coverage

• GET /v1/urlInspection/index:inspect — Check index status for a specific URL

Core Web Vitals

• GET /pagespeedonline/v5/runPagespeed — Get CWV scores (LCP, FID, CLS)

Rules

• Rate limit: 200 requests/minute (Search Console standard)
• Search analytics data has a 3-day processing delay
• Date range maximum is 16 months for search analytics
• The agent compares current period vs prior period by default for trend detection
• URL inspection is limited to 2,000 requests/day