Google Search Console

Architecture

gsc is a Python CLI wrapping two Google APIs:

• Search Console API (webmasters v3 + searchconsole v1) -- search analytics, site management, sitemaps, URL inspection
• PageSpeed Insights API (v5) -- Lighthouse lab tests for performance, accessibility, SEO, best practices

All commands output JSON to stdout. Errors go to stderr. Designed for Claude to invoke and parse programmatically.

Before First Use

1. uv: Run which uv. If missing, ask the user how they want to install it (brew install uv or follow https://docs.astral.sh/uv/getting-started/installation/).
2. Project sync: uv sync --project <skill-dir>
3. Auth: See below.
4. PageSpeed API key: See below.

Search Console Auth (OAuth)