gsc-cli (binary: gsc) is an independent, unofficial command-line interface for Google Search Console, built for people and coding agents. It covers all 10 active Search Console API methods: Search Analytics with every option, URL Inspection, sitemaps, and properties, plus period comparisons, resumable bulk export, and locally computed insights. Agents should run commands with -o json --no-input, use --read-only unless asked to change something, and preview writes with --dry-run. Run gsc freshness before trusting the last few days, take totals from gsc performance instead of summing query or page rows, and treat gsc inspect as Google's indexed view, not a live test.

# Documentation

- [Introduction](https://projects.piyushgambhir.com/gsc-cli/docs): Meet gsc-cli, an independent, unofficial open-source CLI for Google Search Console, built for people and coding agents.
- [Installation](https://projects.piyushgambhir.com/gsc-cli/docs/installation): Install gsc-cli from a checksum-verified prebuilt binary or build it from source.
- [Authentication](https://projects.piyushgambhir.com/gsc-cli/docs/authentication): Sign in to gsc-cli with your browser, a headless flow, your own OAuth client, a service account, Application Default Credentials, or an access token.
- [Quick start](https://projects.piyushgambhir.com/gsc-cli/docs/quickstart): Sign in, pick a property, and run your first Google Search Console commands with gsc.
- [Output formats](https://projects.piyushgambhir.com/gsc-cli/docs/output-formats): Table, JSON, YAML, and CSV output in gsc, the stdout and stderr contract, the Search Analytics envelope, and structured errors.
- [Reading the data](https://projects.piyushgambhir.com/gsc-cli/docs/data): What Google Search Console data from gsc does and does not mean, so neither people nor agents draw the wrong conclusion.
- [Agents](https://projects.piyushgambhir.com/gsc-cli/docs/agents): Run gsc from coding agents with JSON output, structured errors, read-only mode, dry runs, and the Search Console rules an agent must not get wrong.
- [Compatibility](https://projects.piyushgambhir.com/gsc-cli/docs/compatibility): The Google API snapshot gsc is tested against, how it differs from Google's documentation, and the platforms it runs on.

- **Commands**
- [Overview](https://projects.piyushgambhir.com/gsc-cli/docs/commands): The gsc command surface grouped by area, with the global flags every command accepts.
- [Search performance](https://projects.piyushgambhir.com/gsc-cli/docs/commands/performance): Read Google Search Console performance with gsc, including totals, top queries and pages, trends, data freshness, and period comparisons.
- [Search Analytics queries](https://projects.piyushgambhir.com/gsc-cli/docs/commands/query): Use gsc query for every Search Analytics option, including dimensions, filters, search types, data states, aggregation, pagination, and raw request bodies.
- [URL Inspection](https://projects.piyushgambhir.com/gsc-cli/docs/commands/inspection): Use gsc inspect to see Google's indexed view of one URL or a paced batch, within the URL Inspection quota.
- [Bulk export](https://projects.piyushgambhir.com/gsc-cli/docs/commands/export): Export Google Search Console data day by day to CSV or NDJSON files with gsc export, and resume after an interruption.
- [Insights](https://projects.piyushgambhir.com/gsc-cli/docs/commands/insights): Find striking-distance queries, low CTR for the position, cannibalization, decliners, and new or lost queries with gsc insights, computed locally with their thresholds shown.
- [Properties & sitemaps](https://projects.piyushgambhir.com/gsc-cli/docs/commands/properties): List, add, and remove Google Search Console properties, pick a default, and list, check, submit, and delete sitemaps with gsc.

- **Reference**
- [Command reference](https://projects.piyushgambhir.com/gsc-cli/docs/reference/commands): Every gsc command with its flags and examples, generated from the command tree.
- [API coverage](https://projects.piyushgambhir.com/gsc-cli/docs/reference/api-coverage): Every Search Console API method with the gsc commands that call it, and the methods left out with the reason.

## Related CLI sites

- jira-cli: https://projects.piyushgambhir.com/jira-cli
- cubeapm-cli: https://projects.piyushgambhir.com/cubeapm-cli
- es-cli: https://projects.piyushgambhir.com/es-cli
- grafana-cli: https://projects.piyushgambhir.com/grafana-cli
- jenkins-cli: https://projects.piyushgambhir.com/jenkins-cli
- nginxpm-cli: https://projects.piyushgambhir.com/nginxpm-cli
- bing-webmaster-cli: https://projects.piyushgambhir.com/bing-webmaster-cli
- reckon: https://projects.piyushgambhir.com/reckon