CLI for Google Search Console - dump, query, and run MCP server
npm install @gscdump/cli


> CLI for Google Search Console - dump, sync, compare, analyze, and run MCP server.
- 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
``bash`
npm install -g @gscdump/clior run with npx
npx @gscdump/cli
`bashFirst-run setup (choose cloud or local auth)
gscdump init
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:
`bash
gscdump mcp
`Or add to your Claude config (
~/.claude.json or VS Code settings):`json
{
"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):
`bash
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