Skill

google-search-console

Every Google Search Console feature you'd reach for, plus an offline SQLite cache that powers period compare, quick...

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use google-search-console

Choose if

You're running SEO audits or organic-traffic investigations from an agent loop and need GSC's full surface — search analytics, URL inspection, sitemaps, period-over-period compare — plus an offline SQLite cache that extends history beyond the 16-month API window. Free, no paid plan, just Search Console verification + OAuth.

Avoid if

You're looking for SEO data outside your verified properties (GSC only exposes sites you own). Also avoid when you need fresh-day data — GSC's inherent 2-3 day data lag means yesterday's numbers will be empty unless you accept preliminary data via --data-state all. Heavy URL inspection loops will exhaust the per-property ~2,000/day quota.

Risk Flags

  • MEDIUM rate_limit Per-property daily quota of ~2,000 URL inspection requests; the Search Analytics API caps single requests at 25k rows and requires pagination. Agents on portfolio-scale audits must chunk requests.
  • MEDIUM data_quality Data lag is typically 2-3 days for the most recent date — empty rows for the last 1-2 days are expected unless --data-state all is used. Date range is capped at 16 months back from today; older history needs the offline SQLite cache.
  • MEDIUM auth OAuth tokens expire after one hour; agents must refresh via the Playground UI or persist refresh tokens. Wrong scope (read vs write) surfaces as 403 PERMISSION_DENIED on attempted writes.
  • LOW scope Read-only by design — this CLI surfaces telemetry from Google Search Console, it doesn't push changes to the GSC property. URL submission and sitemap mutation operations are available but agents should treat them with care.

Cost

Type: Free · Free tier: The CLI is MIT-licensed and free. Google Search Console API is free for site owners — no paid tier required, only Search Console verification and OAuth credentials.

Install

Default

npx -y @mvanhorn/printing-press install google-search-console

Setup docs →

Estimated time to first success: ~15 min

Dependencies

Minimum runtime: Node.js (for npx); Go fallback not yet available

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT