Command Reference
| Command | Description | Tier |
|---|
/blog google setup | Configure API credentials | -- |
/blog google pagespeed <url> | PSI + CrUX field data | 0 |
/blog google crux <url> | CrUX field data only | 0 |
/blog google crux-history <url> | 25-week CWV trends | 0 |
/blog google gsc <property> | Search Console metrics | 1 |
/blog google inspect <url> | URL Inspection | 1 |
/blog google index <url> | Indexing API submit | 1 |
/blog google ga4 [property-id] | GA4 organic traffic | 2 |
/blog google ga4-pages [property-id] | Top organic landing | 2 |
/blog google youtube <query> | YouTube video search | 0 |
/blog google nlp <url-or-text> | Entity extraction + sentiment | 0 |
/blog google keywords <seed> | Google Ads Keyword Planner | 3 |
Credential Tiers
- Tier 0 (API key): PageSpeed, CrUX, CrUX history, YouTube, NLP. Free API key from Google Cloud Console, no OAuth flow.
- Tier 1 (OAuth or service account): Adds Search Console, URL Inspection, Sitemaps, Indexing API. One OAuth consent grants all four.
- Tier 2 (GA4 property ID): Adds GA4 organic traffic and top landing pages. Requires a GA4 property already collecting data.
- Tier 3 (Ads developer token): Adds Google Ads Keyword Planner. Requires an approved Google Ads developer token and a customer ID.
Claude Blog auto-detects your tier from the config file and only surfaces commands you can actually run. Run /blog google setup first to walk through Tier 0 and 1 in five minutes.
Sharing config with claude-seo
blog-google and seo-google read the same config file at ~/.config/claude-seo/google-api.json. If you have both plugins installed, you only set up credentials once. Run /seo google setup or /blog google setup and the OAuth tokens, GA4 property ID, and Ads tokens are shared. The two skills do not duplicate functionality: claude-seo targets site-wide audits while claude-blog targets blog content workflows.
Config File Schema
{
"api_key": "AIzaSy...",
"oauth_client_path": "/path/to/client_secret.json",
"default_property": "sc-domain:example.com",
"ga4_property_id": "properties/123456789",
"ads_developer_token": "...",
"ads_customer_id": "123-456-7890"
}
All fields are optional. The presence of each field promotes you to the next tier.