@gscdump/cli

CLI for Google Search Console - dump, sync, compare, analyze, and run MCP server.

Features

• Data Export - Dump analytics to stdout, file, or SQLite database
• Period Comparison - Compare metrics across time periods
• SEO Analysis - Striking distance, movers & shakers, decay detection
• Indexing Tools - Check status, request indexing, batch operations
• MCP Server - Let AI agents query your search data directly

Install

npm install -g @gscdump/cli
# or run with npx
npx @gscdump/cli

Quick Start

# First-run setup (choose cloud or local auth)
gscdump init

# List your sites
gscdump sites

# Dump last 7 days to stdout
gscdump dump --site https://example.com --period 7d

# Sync to SQLite database
gscdump sync --site https://example.com --db ./gsc.db

# Compare periods
gscdump compare --site https://example.com --period 28d

# Run SEO analysis
gscdump analyze striking-distance --site https://example.com

Commands

| Command | Description | |---------|-------------| | init | First-run setup (choose cloud/local mode) | | auth | OAuth2 login with Google | | sites | List GSC properties | | dump | Export analytics to stdout/file | | sync | Persist to SQLite database | | compare | Period-over-period comparison | | analyze | Run SEO analysis (striking-distance, movers, decay, etc.) | | sitemaps | List/manage sitemaps for a site | | index | URL indexing (status, inspect, request) | | inspect | Quick URL inspection | | config | Manage CLI configuration | | mcp | Start MCP server for AI assistants |

MCP Server

Start the MCP server for AI assistants:

gscdump mcp

Or add to your Claude config (~/.claude.json or VS Code settings):

{
  "mcpServers": {
    "gscdump": {
      "command": "npx",
      "args": ["@gscdump/mcp"]
    }
  }
}

Then ask Claude:

• "What pages lost traffic this week?"
• "Find keywords in striking distance (position 4-20)"
• "Which queries have keyword cannibalization?"
• "Compare this month vs last month"

Auth Setup

Cloud mode (recommended):

gscdump init  # Select "cloud"

Easy setup via cloud.gscdump.com - no API keys needed.

Local mode (bring your own credentials):

1. Create a Google Cloud project
2. Enable "Search Console API" and "Web Search Indexing API"
3. Create OAuth2 credentials (Desktop app)
4. Run gscdump init and select "local"

Related Packages

• gscdump - Core library
• @gscdump/mcp - MCP server
• @gscdump/db - SQLite persistence
• @gscdump/query - Unified data provider

License

MIT