$npx -y skills add AgriciDaniel/claude-blog --skill blog-googleGoogle API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity analysis for E-E-A-T, YouTube video search for embedding, and Google Ads Keyword P
| 1 | # Blog Google: Google API Data for Blog Performance |
| 2 | |
| 3 | Direct access to Google's SEO APIs for blog performance analysis. Provides real |
| 4 | Chrome user metrics, indexation status, search performance, entity analysis, YouTube |
| 5 | video discovery, keyword volumes, and PDF/HTML performance reports. |
| 6 | |
| 7 | All APIs are free at normal usage levels. Setup requires a Google Cloud project |
| 8 | with an API key and/or service account. |
| 9 | |
| 10 | ## Prerequisites |
| 11 | |
| 12 | **Always check credentials before running any command:** |
| 13 | ```bash |
| 14 | python3 skills/blog-google/scripts/run.py google_auth --check --json |
| 15 | ``` |
| 16 | |
| 17 | **Config file:** `~/.config/claude-seo/google-api.json` (shared with claude-seo) |
| 18 | ```json |
| 19 | { |
| 20 | "api_key": "AIzaSy...", |
| 21 | "oauth_client_path": "/path/to/client_secret.json", |
| 22 | "default_property": "sc-domain:example.com", |
| 23 | "ga4_property_id": "properties/123456789", |
| 24 | "ads_developer_token": "...", |
| 25 | "ads_customer_id": "123-456-7890" |
| 26 | } |
| 27 | ``` |
| 28 | |
| 29 | If missing, read `references/auth-setup.md` and walk the user through setup. |
| 30 | |
| 31 | ### Credential Tiers |
| 32 | |
| 33 | | Tier | Detection | Available Commands | |
| 34 | |------|-----------|-------------------| |
| 35 | | **0** (API Key) | `api_key` present | `pagespeed`, `crux`, `crux-history`, `youtube`, `nlp` | |
| 36 | | **1** (OAuth/SA) | + OAuth token or service account | Tier 0 + `gsc`, `inspect`, `index` | |
| 37 | | **2** (Full) | + `ga4_property_id` configured | Tier 1 + `ga4` | |
| 38 | | **3** (Ads) | + `ads_developer_token` + `ads_customer_id` | Tier 2 + `keywords` | |
| 39 | |
| 40 | Always communicate the detected tier before running commands. |
| 41 | |
| 42 | ## Quick Reference |
| 43 | |
| 44 | | Command | What it does | Tier | |
| 45 | |---------|-------------|------| |
| 46 | | `/blog google setup` | Check/configure API credentials |: | |
| 47 | | `/blog google pagespeed <url>` | PSI Lighthouse + CrUX field data | 0 | |
| 48 | | `/blog google crux <url>` | CrUX field data only (p75 metrics) | 0 | |
| 49 | | `/blog google crux-history <url>` | 25-week CWV trend analysis | 0 | |
| 50 | | `/blog google youtube <query>` | YouTube video search (views, likes, duration) | 0 | |
| 51 | | `/blog google nlp <url-or-text>` | NLP entity extraction + sentiment | 0 | |
| 52 | | `/blog google gsc <property>` | Search Console: clicks, impressions, CTR, position | 1 | |
| 53 | | `/blog google inspect <url>` | URL Inspection: index status, canonical | 1 | |
| 54 | | `/blog google index <url>` | Submit URL to Indexing API | 1 | |
| 55 | | `/blog google ga4 [property-id]` | GA4 organic traffic report | 2 | |
| 56 | | `/blog google keywords <seed>` | Keyword ideas from Google Ads Keyword Planner | 3 | |
| 57 | | `/blog google report <type>` | PDF/HTML performance report |: | |
| 58 | | `/blog google quotas` | Show rate limits for all APIs |: | |
| 59 | |
| 60 | --- |
| 61 | |
| 62 | ## PageSpeed + CrUX |
| 63 | |
| 64 | ### `/blog google pagespeed <url>` |
| 65 | |
| 66 | Combined Lighthouse lab data + CrUX field data for a published blog post. |
| 67 | |
| 68 | **Script:** `python3 skills/blog-google/scripts/run.py pagespeed_check <url> --json` |
| 69 | **Reference:** `references/api-reference.md` |
| 70 | |
| 71 | Output merges lab scores (point-in-time Lighthouse) with field data (28-day |
| 72 | Chrome user metrics). CrUX tries URL-level first, falls back to origin-level. |
| 73 | |
| 74 | ### `/blog google crux <url>` |
| 75 | |
| 76 | CrUX field data only (no Lighthouse run). Faster. |
| 77 | |
| 78 | **Script:** `python3 skills/blog-google/scripts/run.py pagespeed_check <url> --crux-only --json` |
| 79 | |
| 80 | ### `/blog google crux-history <url>` |
| 81 | |
| 82 | 25-week CrUX History trends. Shows whether CWV metrics are improving, stable, or degrading. |
| 83 | |
| 84 | **Script:** `python3 skills/blog-google/scripts/run.py crux_history <url> --json` |
| 85 | |
| 86 | --- |
| 87 | |
| 88 | ## Search Console |
| 89 | |
| 90 | ### `/blog google gsc <property>` |
| 91 | |
| 92 | Search Analytics: clicks, impressions, CTR, position for last 28 days. |
| 93 | |
| 94 | **Script:** `python3 skills/blog-google/scripts/run.py gsc_query --property <property> --json` |
| 95 | **Default:** 28 days, dimensions=query,page, type=web, limit=1000. |
| 96 | |
| 97 | Includes quick-win detection: queries at position 4-10 with high impressions. |
| 98 | |
| 99 | ### `/blog google inspect <url>` |
| 100 | |
| 101 | URL Inspection: real indexation status from Google. |
| 102 | |
| 103 | **Script:** `python3 skills/blog-google/scripts/run.py gsc_inspect <url> --json` |
| 104 | |
| 105 | Returns: verdict (PASS/FAIL), coverage state, robots.txt status, indexing state, |
| 106 | page fetch state, canonical selection, mobile usability, rich resu |