Google Search Console CLI Skill

You have access to google-search-console-cli, a CLI for the Google Search Console API. Use it to query search analytics, inspect URL indexing, and manage sites and sitemaps.

Quick start

# Check if the CLI is available
google-search-console-cli --help

# List accessible sites
google-search-console-cli sites

If the CLI is not installed, install it:

npm install -g google-search-console-cli

Authentication

The CLI uses a Google service account. Credentials are resolved in this order:

1. --credentials <path> flag (per-command)
2. GOOGLE_APPLICATION_CREDENTIALS env var
3. ~/.config/google-search-console-cli/credentials.json (auto-detected)
4. gcloud Application Default Credentials

Before running any command, verify credentials are configured by running google-search-console-cli sites. If it fails with a credentials error, ask the user to set up authentication.

Site URL formats

Search Console uses two property types:

• URL-prefix property: https://www.example.com/ (must include trailing slash and protocol)
• Domain property: sc-domain:example.com (covers all protocols and subdomains)

Always use the exact format as registered in Search Console. The site URL is a positional argument for most commands.

Output format

All commands output pretty-printed JSON by default. Use --format compact for single-line JSON (useful for piping).

Commands

Search analytics query

The query command is the primary tool for search performance data.

google-search-console-cli query <siteUrl> --start-date <date> --end-date <date> [options]

Required:

• --start-date <date> -- Start date (YYYY-MM-DD)
• --end-date <date> -- End date (YYYY-MM-DD)

Optional:

• --dimensions <names> -- Comma-separated: date, query, page, country, device, searchAppearance, hour
• --type <type> -- Search type: web (default), image, video, news, discover, googleNews
• --dimension-filter <json> -- JSON array of dimension filter groups (see below)
• --aggregation-type <type> -- auto, byPage, byProperty, byNewsShowcasePanel
• --row-limit <n> -- Max rows, 1-25000 (default 1000)
• --start-row <n> -- Starting row offset (default 0)
• --data-state <state> -- Data freshness: all, final, hourly_all
• --all -- Fetch all rows with auto-pagination (mutually exclusive with --start-row)

Response fields per row:

• keys -- Array of dimension values (in the order specified by --dimensions)
• clicks -- Number of clicks
• impressions -- Number of impressions
• ctr -- Click-through rate (0.0 to 1.0)
• position -- Average position in search results

Auto-pagination with --all

When --all is specified, the CLI automatically paginates through all results (using 25000 rows per page) and returns the complete dataset. This is useful for exporting all data without manual pagination.