All guides

Guide · about 7 minutes

Audit Core Web Vitals across your site with AI

Lab data (one-shot Lighthouse audit) and field data (real Chrome users via CrUX) tell complementary stories. Lab catches regressions you can replay; field tells you what actual visitors experience. Both matter for SEO and for product velocity.

GSC PAP exposes both as MCP tools. `pagespeed_insights` for the Lighthouse lab run and `pagespeed_field_data` for CrUX p75 metrics, sharing a 24-hour cache so calling both for the same URL only burns one quota call.

This guide walks a multi-URL audit prompt that reads top GSC pages, runs PSI on each, and produces an action-ranked report.

The scenario

Google's page experience signals affect ranking, and Core Web Vitals are how that's measured. Manually running PageSpeed Insights on every important URL is slow; sharing one run is brittle (PSI scores swing 20+ points across runs). You want a single chat where the AI runs PSI on your top pages, surfaces both lab and field data, and prioritises fixes by potential ms savings.

The prompt

prompt
Use the gsc-pap MCP. For https://example.com, get my top 10 organic-traffic pages from the last 28 days via Search Console. For each one run pagespeed_insights mobile + pagespeed_field_data mobile. Build a table: page_path, perf_score, LCP_lab, LCP_field_p75, INP_field_p75, CLS_field_p75, and the #1 PSI opportunity by ms savings. Sort by perf_score asc so my worst-performing high-traffic pages bubble to the top.

What happens

  1. 1

    AI fetches the top 10 organic-traffic pages

    Claude/Cursor calls `search_analytics_query` with dimension `page` for the last 28 days, takes the top 10 by clicks. This is your prioritisation set, fixing CWV on a page nobody visits is wasted effort.

  2. 2

    AI loops PSI calls (parallel-safe)

    For each page the AI calls `pagespeed_insights(url, mobile)` and `pagespeed_field_data(url, mobile)`. Both share GSC PAP's PSI cache so this is at most one Google PSI hit per (url, mobile) pair per 24h.

  3. 3

    AI builds the report and surfaces fixes

    Output is a sortable table with both lab and field metrics + the highest-impact opportunity per page. The AI also highlights pages where lab and field disagree (lab says fast, field says slow → environment-specific issue) or where field data is missing (low-traffic URL with no CrUX samples → fall back to lab and origin-level field data).

Outcome

Most sites uncover 2-3 'silent killers': pages with high organic traffic, decent lab scores, but field-level LCP > 3s for real users (typically because of an above-the-fold third-party script CrUX captures but the lab miss). Fixing these in priority order moves the page-experience signal from 'needs improvement' to 'good' for a meaningful chunk of your traffic.

Where to take it next

  • ·Re-run weekly to catch regressions from new deploys.
  • ·Pair with `correlate_gsc_to_ga4` to weight CWV fixes by actual revenue impact.
  • ·For URL templates (e.g, blog posts or product pages) sample 3-5 representative URLs rather than auditing every one.

Other guides

All guides

Find your fastest SEO quick wins with Claude

Spot pages stuck on page 2 of Google with high impressions but low clicks. The fastest organic traffic gains are usually a single sentence, title tag, or meta description away.

7 min read

Detect keyword cannibalization across your site

Two of your pages are competing for the same query - splitting clicks, dragging both rankings down. Find them in one MCP call and decide which to merge, redirect, or differentiate.

6 min read

Correlate organic search clicks with GA4 conversions

Find the pages that bring search clicks but don't convert, and the ones that do. One tool call joins Search Console clicks per page with GA4 sessions, conversions, and revenue per page.

6 min read

Query Search Console data older than Google's 16-month limit

Google retains Search Console data for only 16 months. GSC PAP archives every authorised property continuously so you can query years of history through Claude or Cursor, same dimensions, no truncation.

6 min read

Build a weekly SEO health report with Claude

One prompt that pulls performance, quick wins, decaying pages, ranking shifts, GA4 conversions, and CWV regressions into a single ready-to-share report. Run it every Monday.

8 min read

Diagnose indexing issues with bulk URL Inspection

Stop checking pages one-by-one in Search Console. Run URL Inspection on up to 2,000 URLs in one MCP call, group by indexing state, and surface exactly which content cluster isn't getting indexed.

6 min read

Track keyword ranking trends across years (not months)

Plot how a single query's average position has moved across the last 24-36 months. Spot the algorithm-update spike, the AI Overview-driven decline, the slow consolidation toward your canonical page.

5 min read