HOME SKILLS BLOG GITHUB
// SKILL

GOOGLE SEO APIS
REAL FIELD DATA

Direct access to Google's own SEO data. Bridges the gap between crawl-based analysis and Google's real-time field data: actual Chrome user metrics from CrUX, real indexation status from Search Console, real search performance, and real GA4 organic traffic. All APIs are free. Setup walks you through Google Cloud project + OAuth in 5 minutes.

$
/seo google pagespeed https://your-site.com

REQUIRES CLAUDE SEO INSTALLED IN CLAUDE CODE

Claude SEO Google APIs integration with GSC PageSpeed CrUX and GA4
// HOW IT WORKS

5 GOOGLE APIS. ONE SKILL.

Every SEO tool you pay for is reselling Google's own data with markup. Claude SEO pulls it directly from the source: Search Console, PageSpeed Insights, CrUX, Indexing API, and GA4. The APIs are free. The friction is OAuth setup, and the skill walks you through it.

The architecture is tiered. With just an API key (Tier 0) you unlock real Chrome user metrics via PageSpeed and CrUX. Add OAuth or a service account (Tier 1) and you get Search Console performance, URL Inspection, and the Indexing API. Add a GA4 property ID (Tier 2) and you get real organic traffic. Tier 3 layers in Keyword Planner. The skill auto-detects your tier and only surfaces commands you can actually run.

/seo google [command] <url> TIER 0 API key PSI, CrUX, NLP TIER 1 OAuth / SA GSC, Indexing TIER 2 + GA4 ID GA4 organic TIER 3 + Ads token Keyword Planner PDF + EXCEL + JSON REPORTS cwv-audit, gsc-performance, indexation, full

The Six Capabilities

Each card maps to a real Google data source you can query the second your credentials are configured.

01
PAGESPEED + CRUX
Combined Lighthouse lab data and CrUX field data in one call. Mobile and desktop strategies. CrUX falls back to origin-level when URL-level data unavailable.
02
SEARCH CONSOLE
Clicks, impressions, CTR, position, top queries, top pages. URL Inspection for crawl/index status. Sitemap submission monitoring. All free.
03
CRUX 25-WEEK HISTORY
Track LCP, INP, CLS, FCP, TTFB over 25 weeks. Catch regressions tied to specific deploys. Real-user data, not lab synthetic.
04
INDEXING API
Submit URLs directly for crawl. Batch up to 200 URLs. Status checks per URL. Job site / live event types supported.
05
GA4 ORGANIC
Organic traffic, top landing pages, engagement, conversions. Requires Tier 2 (GA4 property ID configured). Pulls last 28 days by default.
06
PDF + EXCEL REPORTS
WeasyPrint-based A4 PDF report with matplotlib charts. Excel xlsx with Summary, Queries, Pages, Indexation sheets. Navy header styling, frozen rows, auto-filter.
// USAGE

HOW TO RUN GOOGLE APIS

Credential Tier Detection

Always communicate the detected tier before running commands. Claude SEO checks ~/.config/claude-seo/google-api.json on every invocation. If you only have an API key, only Tier 0 commands surface. If GSC OAuth is wired up, Tier 1 commands unlock. If your GA4 property ID is set, Tier 2 unlocks. If Ads credentials are present, Tier 3 unlocks. You never get prompted for commands you cannot run.

Commands by Tier

CommandWhat it doesTier
/seo google setupCheck/configure API credentials--
/seo google pagespeed <url>PSI Lighthouse + CrUX field data0
/seo google crux <url>CrUX field data only (p75 metrics)0
/seo google crux-history <url>25-week CWV trend analysis0
/seo google youtube <query>YouTube video search (views, likes, duration)0
/seo google youtube-video <id>YouTube video details + top comments0
/seo google nlp <url-or-text>NLP entity extraction + sentiment + classification0
/seo google entities <url-or-text>Entity analysis only (for E-E-A-T)0
/seo google entity <query>Knowledge Graph entity check0
/seo google safety <url>Web Risk URL safety check0
/seo google gsc <property>Search Console: clicks, impressions, CTR, position1
/seo google inspect <url>URL Inspection: index status, canonical, crawl info1
/seo google inspect-batch <file>Batch URL Inspection from file1
/seo google sitemaps <property>GSC sitemap status1
/seo google index <url>Submit URL to Indexing API1
/seo google index-batch <file>Batch submit up to 200 URLs1
/seo google ga4 [property-id]GA4 organic traffic report2
/seo google ga4-pages [property-id]Top organic landing pages2
/seo google keywords <seed>Keyword ideas from Google Ads Keyword Planner3
/seo google volume <keywords>Search volume lookup from Keyword Planner3

Generating Reports

After any analysis command, run /seo google report <type> to produce a styled deliverable. Report types are cwv-audit (Core Web Vitals from PSI + CrUX + history), gsc-performance (Search Console query tables and quick wins), indexation (batch inspection with coverage donut), and full (everything). PDF output uses WeasyPrint with matplotlib charts. Excel output ships with Summary, Queries, Pages, and Indexation sheets, frozen header rows, and auto-filter enabled, so pivots are one click away.

Rate Limits

The skill respects published Google quotas and reports them via /seo google quotas:

  • PageSpeed Insights v5: 240 QPM, 25,000 QPD (API key)
  • CrUX + History: 150 QPM shared, unlimited daily (API key)
  • GSC Search Analytics: 1,200 QPM per site, 30M QPD (service account)
  • GSC URL Inspection: 600 QPM, 2,000 QPD per site (service account)
  • Indexing API: 380 RPM, 200 publish per day (service account)
  • GA4 Data API: 10 concurrent, ~25K tokens per day (service account)

Technical Notes

  • INP replaced FID on March 12, 2024. The skill never references FID.
  • CLS values from CrUX are string-encoded (e.g. "0.05"). Scripts handle parsing.
  • CrUX 404 means insufficient Chrome traffic, not an auth error. PSI lab data is the fallback.
  • Search Analytics data has a 2-3 day lag. Reports note data freshness.
  • round_trip_time replaced effectiveConnectionType in CrUX in Feb 2025.
// FAQ

QUESTIONS ABOUT GOOGLE APIS

No. All Google APIs used by Claude SEO are free: Search Console, PageSpeed Insights v5, CrUX (Chrome User Experience Report), Indexing API v3, and GA4 Data API. You need a Google Cloud project (free) and either an API key (Tier 0 access: PageSpeed, CrUX) or OAuth/service account credentials (Tier 1 access: GSC, Indexing). Tier 2 adds GA4. Tier 3 adds Ads Keyword Planner.
Tier 0 (API key) unlocks PageSpeed, CrUX, CrUX history, YouTube search, and NLP. Tier 1 adds OAuth or service account credentials and unlocks Search Console (clicks, impressions, CTR, position), URL Inspection, Sitemaps, and Indexing API. Tier 2 adds a GA4 property ID and unlocks GA4 organic traffic and top landing pages. Tier 3 adds Google Ads Keyword Planner. Claude SEO detects your tier automatically and gates commands accordingly.
Yes. Run /seo google report [type] to generate a styled PDF report (A4, WeasyPrint, matplotlib charts), HTML report, or Excel workbook (xlsx with Summary, Queries, Pages, Indexation sheets). Report types include cwv-audit (Core Web Vitals), gsc-performance (search performance), and full (everything). The Excel format unlocks pivot tables and downstream analysis.
CrUX provides 28-day p75 metrics from real Chrome users: LCP, INP, CLS, FCP, TTFB. Run /seo google crux <url> for current metrics or /seo google crux-history <url> for 25-week trends. This is real-user data, not synthetic Lighthouse lab tests, what Google actually scores you on for Core Web Vitals. The crux-history command surfaces the trend so you can see whether a recent deploy hurt or helped.
No. Run /seo google setup and Claude SEO walks you through creating a Google Cloud project, enabling APIs, and exchanging credentials. The OAuth web flow uses a localhost:8085 callback for browser-based auth, with a manual code exchange fallback if the callback fails. Service account is supported for headless environments. Tokens auto-refresh, no manual handling required.
// RELATED SKILLS

EXPLORE MORE

TECHNICAL SEO

Pair Google APIs with the technical SEO audit for full crawlability + indexability picture. Real field CWV + lab CWV together.

TECHNICAL SEO AUDIT →

FULL SITE AUDIT

The audit orchestrator detects Google API credentials and spawns the seo-google agent to enrich findings with real Chrome field data.

FULL SEO AUDIT →

IMAGE OPTIMIZATION

PageSpeed Insights surfaces image-related opportunities. Pair with the image skill for WebP conversion and lazy-loading fixes.

IMAGE SEO OPTIMIZATION →

VIEW ALL 23 SKILLS →

// FROM THE BLOG

RELATED GUIDE

FREE SEO REPORTS WITH GOOGLE APIS

How the Google APIs skill was built. OAuth web flow, 4-tier credentials, PDF generator, real CrUX data. Step-by-step setup.

READ GUIDE →

PULL REAL GOOGLE DATA
IN 30 SECONDS.

$
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git && bash claude-seo/install.sh
VIEW ON GITHUB ALL SKILLS >