Google SEO APIs

Direct access to Google's own SEO data. Bridges the gap between crawl-based analysis (existing claude-seo skills) and Google's real-time field data: actual Chrome user metrics, real indexation status, search performance, and organic traffic.

All APIs are free. Setup requires a Google Cloud project with API key and/or service account -- run /seo google setup for step-by-step instructions.

Prerequisites

Before executing any command, check credentials:

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run google_auth.py --check --json

Config file: ~/.config/claude-seo/google-api.json

{
  "service_account_path": "/path/to/service_account.json",
  "api_key": "<GOOGLE_API_KEY>",
  "default_property": "sc-domain:example.com",
  "ga4_property_id": "properties/123456789"
}

If missing, read references/auth-setup.md and walk the user through setup.

Credential Tiers

Tier	Detection	Available Commands
0 (API Key)	api_key present	pagespeed, crux, crux-history, youtube, nlp
1 (OAuth/SA)	+ OAuth token or service account	Tier 0 + gsc, inspect, sitemaps, index
2 (Full)	+ ga4_property_id configured	Tier 1 + ga4, ga4-pages
3 (Ads)	+ ads_developer_token + ads_customer_id	Tier 2 + keywords, volume

Always communicate the detected tier before running commands.