GSC-CLI: GSC CLI. Zero Dependencies. Search Intelligence in Ruby

A new open-source Ruby tool called gsc-cli automates Google Search Console indexing and diagnostics with zero runtime gem dependencies, using only Ruby's standard library (Net::HTTP, OpenSSL, JSON) and cold-booting in roughly 15ms, according to its developers. The MIT-licensed tool reports 371 test suites, 1,991 assertions and 0 failures across Ruby 3.0 through 3.4, and cites production results including 3,897 pages indexed (+380% in three weeks) and 3,530+ AI Overview impressions tracked via its aio-hunter and cite-sim commands. The developers position gsc-cli against the official google-apis-searchconsole_v1, google-apis-indexing_v3, googleauth, signet and faraday gems, which they say pull in 40+ transitive dependencies and add 3 to 5 seconds to cold-boot time.

Zero runtime gems. Pure Ruby standard library Net::HTTP , OpenSSL , JSON . Cold-boots in ~15ms with 371 test suites, 1,991 assertions, and 0 failures across Ruby 3.0 through 3.4. Extract first-party Google rankings, automate technical SEO audits, and manage Googlebot indexing without bloated SDK dependencies. Actual Google Search Console data from production domains audited, indexed, and scaled via gsc-cli . | Automated Indexation +380% in 3 Weeks | AI Overview Capture 3.53K Impressions | |---|---| | 3,897 Pages Indexed +380% Surge Stalled at ~800 pages for months until automated sitemap inspection gsc inspect-sitemap , soft-404 fixes, and priority queueing broke the crawl deadlock. | 3,530+ AI Overview Impressions Tracked and captured live visibility in Google's new Generative AI search features using citation gap analysis gsc aio-hunter and structure scoring gsc cite-sim . | Every software engineer, technical SEO, and developer-operator managing search presence faces the exact same architectural frustrations: 1. The 40-Gem Dependency Tax : The official Google API Ruby gems google-apis-searchconsole v1 , google-apis-indexing v3 , googleauth , signet , faraday pull in 40+ transitive gem dependencies . They add 3 to 5 seconds to cold-boot time, trigger Bundler version conflicts, inflate container image sizes, and introduce ongoing supply-chain vulnerability alerts. 2. Paying $300 to $1,000+/Month for Sampled Guesswork : Third-party SEO suites charge hundreds of dollars per month to scrape search results with external proxy farms and estimate traffic using sampled third-party panels. Meanwhile, Google Search Console provides 100% first-party ground-truth data for your domain directly from production search logs—completely free. 3. Google Search Console's Web UI Does Not Scale : Inspecting 50 URLs, isolating soft-404 indexation drops, or detecting cannibalization across multiple client properties requires hours of manual tab switching, filtering, and clicking. 4. Google AI Overviews AIO Intercepting Search Clicks : Zero-click searches continue to expand. If technical content is not structured for citation in Gemini and AI Overviews, organic visibility drops even when ranking on Page 1. 5. AI Coding Agents Cannot Click Web Buttons : Modern coding agents Antigravity, Claude Code, Cursor, Cline require deterministic, sub-50ms JSON over stdout to diagnose and fix search issues directly inside the local repository. We built gsc-cli to automate Googlebot indexing and search diagnostics in < 50 milliseconds using pure standard-library Ruby, and open-sourced it 100% free under the MIT License so every builder, engineering team, and operator can run first-party search automation with zero dependency bloat. 1. First-Party Ground Truth Over Guesswork : Third-party estimation suites rely on sampled clickstream models and external proxy scraping. Google Search Console stores the exact, 100% first-party click, impression, and position data directly from Google's search infrastructure—completely free. 2. Zero-Dependency Purity < 1ms Boot Time : Official Google API gems drag in 40+ dependency gems, slowing down boot times and creating dependency lock-in. GSC-CLI communicates directly with Google's bare-metal HTTP APIs using pure Ruby standard library Net::HTTP , OpenSSL , JSON , executing in < 1 millisecond . 3. Actionable Remediation Over Passive Error Dumps : Most diagnostic tools dump hundreds of error rows into a table without solutions. gsc-cli pairs forensic diagnostics with automated remediation—such as generating copy-paste redirect blocks for 14 server environments Nginx, Caddy, Cloudflare, Next.js, Vercel, etc. for soft-404 traps. 4. Zero-Trust Local Execution No Telemetry, No External AI Calls : Developer tools should respect machine resources and codebase privacy. gsc-cli runs 100% locally, requires zero external LLM API keys, makes zero calls to third-party AI servers, collects zero telemetry, and never reads or transmits private repository files. Conventional wisdom says: "To build Google API integrations, you must install the official Google API gems google-apis-searchconsole v1 , googleauth ." We reject that completely. Google's APIs are just standard, RFC-compliant HTTPS endpoints returning JSON. Forcing a developer to pull in 40+ transitive gem dependencies just to send a signed HTTP POST request is architectural malpractice: - It bloats container images. - It inflates Docker deployment sizes. - It creates endless bundle install version conflicts. - It slows down sub-millisecond AI agent loops. By implementing Google's JWT service account authentication in pure OpenSSL and streaming responses through native Net::HTTP with Gzip decompression, gsc-cli boots in < 1 millisecond and executes entire multi-step audit loops in under 50 milliseconds. - 🤖 Google AI Overview AIO Hunter gsc aio-hunter : Detects Google AI Overviews on SERPs, extracts cited sources, measures citation gaps, and generates snippet capture recipes. - 🔮 AI Citation Simulator gsc cite-sim : Tests how likely LLMs Gemini, ChatGPT, Claude are to cite your URL based on information density, fact ratios, and structural headings. - 🏦 Agency Credential Vault gsc vault : Local AES-256-GCM encrypted store managing 50+ service accounts with instant switching gsc switch <domain , strict POSIX permissions, and path-traversal isolation. - 🚨 Soft-404 Diagnostic Engine with Instant Fixes gsc soft-404 --fix nginx : Diagnoses soft-404 traps and outputs copy-paste redirect blocks for 14 server stacks Nginx, Caddy, Cloudflare, SvelteKit, Next.js, Astro, Shopify, Vercel . - 🎯 Tactical Striking Distance Playbook gsc strike : Automatically detects high-impression Page 2 queries Positions 4–20 paired with intent-matched title hook rewrites and internal link anchor recipes. - 📉 Organic CTR Curve Simulator gsc ctr-curve : Non-linear regression modeling expected CTR by position and calculating exact click upside for ranking leaps. - ⚡ Ultra-Low Token Modes for AI Agents --compact & --ndjson : Minified single-line JSON --compact saving 35–45% LLM context tokens, and newline-delimited streaming --ndjson for array data. - 📱 Mobile vs. Desktop SERP Parity Auditor gsc mobile-parity : Uncovers cross-device rank discrepancies, responsive suppression penalties, and mobile CTR leaks. - 🩺 Zero-Gem Cold-Start Doctor gsc doctor : Verifies 100% standard library purity, measures sub-50ms execution speed, and validates credential security. - 📈 Real-Time Google Trends Engine gsc trends : 5-year and 1-year search trajectory, velocity percentages, Unicode sparklines ▂▃▄▅▆▇█ , and regional demand breakdowns with zero authentication. - 🎯 Zero-Auth Keyword Planner gsc planner : Instant seed expansion via Google Autocomplete with automated search intent classification Informational , Commercial , Transactional . - 💰 Keywords Everywhere Ingestion gsc import clip & gsc ke : Ingest free keyword tables directly from clipboard zero credits required or connect a Keywords Everywhere API key https://keywordseverywhere.com/?fpr=us25sg partner referral link that helps support continuous open-source maintenance of this project for automated terminal lookups. - 🚀 Instant Googlebot Re-Indexing gsc index : Ping Google's Indexing API with URL UPDATED or URL DELETED for priority crawl queueing within seconds. - ⚡ Multi-Engine IndexNow Protocol gsc indexnow : Instantly submit pages and sitemaps across Microsoft Bing, Yandex, Seznam, and Naver simultaneously. - 🖥️ Google SERP & Title Pixel Simulator gsc serp : Simulate desktop 580px and mobile 650px Google SERP cards, calculate precise proportional pixel widths, and prevent truncation before publishing. - 🛡️ Cannibalization & Decay Detection gsc cannibalization , gsc decay : Spot internal URLs fighting for the same queries, and compare 28-day period-over-period traffic trends. - 📊 Google Analytics 4 GA4 Behavioral Link gsc realtime , gsc ga4 : Stream live active visitors and correlate SERP rankings with landing page bounce rates. - 🕷️ Autonomous Site Audit & Broken Link Repair gsc site-audit : Crawls all sitemap URLs, checks HTTP response codes for dead internal links 404/500/timeouts , audits missing image alts and heading defects, and exports an AI-actionable Markdown fix sprint. - ⚡ Dual Lab & Field Core Web Vitals gsc speed & gsc speed-correlate : Audits simulated Lighthouse Lab metrics LCP, FCP, CLS, TBT, Speed Index alongside official 28-day Chrome User Experience Report CrUX Real User Monitoring RUM field data LCP, INP, CLS, FCP, TTFB and correlates page speed directly with organic GSC search rankings. - 🤖 AI Agent Native : Every single command supports --compact , --ndjson , and --json for instantaneous programmatic consumption by AI agents. | Traditional Stack Official SDK / SaaS | GSC-CLI Architecture | |---|---| | Manual Web UI Bottleneck : Clicking through 15 tabs in Google Search Console to inspect 50 URLs takes 45+ minutes. | Instant 1-Command Batching : gsc inspect-sitemap sitemap.xml inspects all URLs with automatic quota pacing in seconds. | | Sampled Third-Party Guesswork : Paying $300–$1,000+/mo $3,600–$12,000/yr for external proxy scrapers that model keyword volumes. | 100% Google Ground Truth $0 : Raw impression, click, and position logs direct from Google Search Console. | | 40-Gem Dependency Tax : Bloating your Gemfile with Google SDK gems that add 3–5 seconds to cold boot. | 0 Gem Dependencies : Pure Ruby standard library OpenSSL , Net::HTTP , JSON executing in < 1 millisecond . | | Multi-Client Credential Chaos : Juggling loose JSON keys across folders and risking credential leaks. | Agency Credential Vault gsc vault : Local AES-256-GCM encrypted vault with instant domain switching gsc switch . | | Passive Error Reporting : Diagnostic tools tell you that you have 404s, but leave you to write the server rules. | Active Automated Remediation : gsc soft-404 <url --fix nginx synthesizes instant, copy-paste server blocks for 14 stacks. | | Blind to AI Overviews : Unaware that Google Gemini / AI Overviews are intercepting 40% of zero-click searches. | Google AIO Hunter & Citation Simulator : gsc aio-hunter identifies AI Overviews and extracts competitor citation recipes. | | Token-Guzzling JSON in AI Agents : Feeding pretty-printed JSON into coding agents wastes 40% of your LLM context window. | Ultra-Low Token Modes --compact , --ndjson : Minified output saving 35–50% of tokens for Claude Code, Cursor, and Antigravity. | | Untrusted Third-Party Scripts : Running opaque scripts that scan your repository or send files to external servers. | Zero-Trust Local Execution : Completely isolated, deterministic UNIX tool. Never scans, reads, or transmits your private code. | If gsc-cli saved your team from 40 bloated gems or streamlined your search data pipeline: 👉 Star GSC CLI on GitHub https://github.com/ApollosWave/gsc-cli to support zero-dependency open-source tooling. gem install gsc-cli curl -fsSL https://raw.githubusercontent.com/ApollosWave/gsc-cli/main/install.sh | bash gem 'gsc-cli' Ensure ~/.local/bin is in your shell PATH : echo 'export PATH="$HOME/.local/bin:$PATH"' ~/.zshrc source ~/.zshrc Verify your installation: gsc version gsc doctor Verify all 371 test suites and 1,991 assertions on your own machine in seconds: js git clone https://github.com/ApollosWave/gsc-cli.git cd gsc-cli rake test = 371 runs, 1991 assertions, 0 failures, 0 errors, 0 skips 🔑 Need help with GA4, Google PageSpeed, OpenPageRank, or Keywords Everywhere? Check out the complete Authentication & API Key Setup Guide AUTH.md https://github.com/ApollosWave/gsc-cli/blob/main/AUTH.md for 30-second walkthroughs and zero-key features. 1. Open Google Cloud Console https://console.cloud.google.com/ . 2. In APIs & Services Library , enable: - Web Search Indexing API - Google Search Console API - Optional for GA4 : Google Analytics Data API 3. In IAM & Admin Service Accounts , click Create Service Account e.g. gsc-indexer . 4. Click your new service account Keys tab Add Key Create new key JSON . Download the file. In your terminal, simply run: gsc connect gsc automatically searches your ~/Downloads folder for recently created Google Cloud service account keys, lets you confirm with Y , and saves it securely to ~/.config/gsc/service-account.json . 1. Copy the service account email displayed in the terminal. 2. Go to Google Search Console https://search.google.com/search-console/ Select your property Settings Users and permissions . 3. Click Add User , paste the email, and set permission to Owner . Verify access immediately: gsc domains 1. Core Search Performance: Top Queries, Pages & CTR gsc top-queries , gsc top-pages , gsc performance Google Search Console's web UI is sluggish, hides low-volume long-tail queries behind pagination limits, and makes cross-referencing brand vs. non-brand queries painful. Exporting CSVs to spreadsheets burns 20+ minutes every time you want to check yesterday's organic clicks. gsc-cli streams your exact Google Search Console ground-truth performance directly into your terminal in under 50 milliseconds . Filter by brand, segment devices, compare date ranges, and export clean JSON or CSV in one command: Top 20 search queries with impressions, clicks, CTR, and average SERP position gsc top-queries --limit 20 Filter brand vs. non-brand queries automatically gsc top-queries --brand gsc top-queries --non-brand Top indexed landing pages driving search traffic gsc top-pages --limit 15 Overall 30-day domain performance scorecard with device & country breakdown gsc performance --days 30 Retrieve 100% of all queries via automated API pagination no 1,000-row web limit gsc top-queries --all --csv all search queries.csv Most SEO reports simply dump a list of keywords without telling you what to write, where to link, or what the revenue payoff will be . Page 2 keywords Positions 4–20 generate 80% of your search impressions but only 5% of your clicks. - gsc ctr-curve : Generates an empirical, non-linear CTR regression curve mapping your domain's real CTR by position against Google's global benchmarks, simulating the exact click gain of advancing to Top 3. - gsc strike : Automatically synthesizes a tactical Page 2 attack plan with 3 SERP-safe hook titles < 560px , heading recipes, and targeted internal link anchor suggestions: Simulate organic CTR curve and click upside for Page 2 rankings gsc ctr-curve --days 30 --target-pos 3 Generate tactical Page 2 striking distance playbook gsc strike --limit 10 Surface quick-win CTR underperformers Top 10 ranking but low click-through gsc underperformers --min-imp 50 Export playbook directly to CSV for copywriters & content teams gsc strike --limit 20 --csv docs/seo/striking playbook.csv Waiting days or weeks for Googlebot to discover new landing pages or updated documentation kills organic momentum. Meanwhile, checking if Google has indexed a URL or flagged a canonical error requires tedious manual clicking inside Search Console's URL Inspection tool. gsc-cli communicates directly with Google's Indexing API and live URL Inspection API to check status and force priority crawling in seconds: Production turnaround: Stalled at ~800 pages with 4.5K unindexed for months, then surging to 3,897 indexed pages in 3 weeks +380% while clearing out 3,300+ unindexed backlog errors via automated inspection and indexing loops. Query live Google indexing verdict, assigned canonical, and crawl timestamp gsc inspect https://example.com/blog/core-web-vitals Ping Googlebot to prioritize crawling a newly published or updated URL gsc index https://example.com/blog/core-web-vitals Batch inspect an entire XML sitemap with automatic quota pacing gsc inspect-sitemap https://example.com/sitemap.xml Multi-Engine IndexNow: Instantly notify Bing, Yandex, Seznam, and Naver simultaneously gsc indexnow https://example.com/blog/core-web-vitals 4. Cannibalization, Traffic Decay & Zombie Page Detection gsc cannibalization , gsc decay , gsc zombies Internal URLs competing for the same search intent keyword cannibalization split page equity, causing Google to oscillate rankings between pages. Meanwhile, stealth traffic decay and dead zero-click URLs quietly drain your Google crawl budget. gsc-cli diagnoses algorithmic cannibalization conflicts and period-over-period decay before traffic crashes: Detect internal URLs fighting for the exact same queries gsc cannibalization Period-over-period decay detection 28-day comparison: decaying vs surging queries gsc decay --compare 28 Scan XML sitemap for 90-day zero-impression zombie pages draining crawl budget gsc zombies https://example.com/sitemap.xml --purge-map Keyword research tools either lock data behind expensive API subscriptions or leave valuable volume data trapped in disconnected browser extensions. gsc-cli provides zero-cost clipboard ingestion and real-time demand tracking with zero API keys required : 1. Copy any keyword table from Keywords Everywhere or Google Ads in your browser Cmd+C 2. Run one command to parse volumes, sparklines, and cross-reference live GSC rankings: gsc import clip Real-time Google Trends 5y/1y search trajectory and velocity percentage zero-auth gsc trends "technical seo audit" --geo US --time 12m Google Autocomplete intent expander Informational, Commercial, Transactional gsc planner "nextjs seo" On-page SEO checkers titles, headings, meta tags live in browser extensions, completely disconnected from your real Google Search Console performance data. gsc page unites on-page DOM inspection with 90-day GSC search queries, clicks, and rankings in a single terminal view: Audit any URL combining DOM inspection with GSC 90-day search performance gsc page https://example.com/ Deep internal link verification: tests HTTP status codes 200, 404, 500 gsc page https://example.com/ --check-links Crawl entire XML sitemaps to audit dead links, missing alts, and heading hierarchy gsc site-audit https://example.com/sitemap.xml --report docs/seo/site audit issues.md Google AI Overviews Gemini in search results intercept high-intent queries before users ever reach blue links. If an AI Overview appears for your core keywords, your organic CTR can crater unless your site is cited inside the AI answer box. gsc aio-hunter scans live SERPs for AI Overviews, extracts cited sources, and measures your citation readiness: Production impact: Capturing over 3,500 impressions directly inside Google Search Console's new Generative AI features Beta report. Hunt AI Overview presence and extract cited competitor sources gsc aio-hunter "best technical seo audit tools" Test how likely LLMs Gemini, ChatGPT, Perplexity are to cite your URL gsc cite-sim https://example.com/guides/core-web-vitals Synthesize 40–60 word high-density direct answers with FAQ schema embedding gsc answer "what is soft 404 error" Soft-404 errors silently destroy your Google crawl budget by returning 200 OK on empty templates or missing content. Writing server redirect rules manually across different stacks is slow and error-prone. gsc soft-404 detects empty templates, blank pages, and canonical loops, auto-detects your tech stack, and generates copy-paste redirect blocks for 14 server environments: Diagnose any URL for soft-404 status auto-detects tech stack & server gsc soft-404 https://example.com/broken-page Generate copy-paste rules for your specific tech stack: gsc soft-404 https://example.com/broken-page --fix sveltekit gsc soft-404 https://example.com/broken-page --fix caddy gsc soft-404 https://example.com/broken-page --fix cloudflare gsc soft-404 https://example.com/broken-page --fix nextjs gsc soft-404 https://example.com/broken-page --fix nginx gsc soft-404 https://example.com/broken-page --fix shopify gsc soft-404 https://example.com/broken-page --fix all 9. Dual Lab Lighthouse & Field CrUX 28-Day RUM Core Web Vitals gsc speed & gsc speed-correlate Synthetic lab audits like local Lighthouse runs only measure artificial simulation on simulated throttled CPU, which often contradicts real user experience. Meanwhile, Google's official search ranking algorithm evaluates real-world Core Web Vitals LCP, INP, CLS from 28-day Chrome User Experience Report CrUX field telemetry. gsc speed delivers both in a single terminal command—pairing synthetic lab diagnostics with Google's 28-day URL-level CrUX field data and top speed optimization opportunities: Measure Core Web Vitals Lab + CrUX Field Data for any URL gsc speed https://superspeedapp.com Correlate Core Web Vitals directly with organic GSC ranking positions gsc speed-correlate --days 28 ⚡ Measuring Core Web Vitals via Google PageSpeed Insights MOBILE : https://superspeedapp.com 🔬 LIGHTHOUSE LAB METRICS Simulated MOBILE : • LCP Largest Contentful Paint : 2.1 s • FCP First Contentful Paint : 1.4 s • CLS Cumulative Layout Shift : 0.02 • TBT Total Blocking Time : 80 ms • Speed Index : 2.3 s 🌐 CrUX FIELD DATA 28-Day Real User Monitoring - URL-Level RUM : • Core Web Vitals Status : PASSED • LCP 75th Percentile : 1.23 s FAST • INP 75th Percentile : 69 ms FAST • CLS 75th Percentile : 0.0 FAST • FCP 75th Percentile : 1.15 s FAST • TTFB 75th Percentile : 973 ms AVERAGE 💡 TOP SPEED OPPORTUNITIES: • Reduce unused JavaScript: Est savings of 398 KiB • Reduce unused CSS: Est savings of 68 KiB Agencies and multi-brand operators juggle dozens of client Google service account JSON files. Leaving unencrypted keys scattered across client folders invites credential leakage, path-traversal vulnerabilities, and accidental cross-client query pollution. gsc vault provides a hardened, local AES-256-GCM encrypted credential vault supporting 50+ client service accounts with strict POSIX permissions 0700/0600 and instant zero-friction domain switching: Check encrypted vault status, stored keys & cipher health gsc vault status Add a client service account key to the encrypted store gsc vault add ./client-key.json --domain client.com --alias client1 List all vaulted domains, client emails & GA4 property links gsc vault list Switch active client context instantly by domain, alias, or index gsc switch client.com gsc switch client1 gsc use 2 💡 Token Economy Note for AI Agents & Pipelines: Every command supporting --json also natively supports --compact single-line minified JSON saving 35–45% LLM tokens and --ndjson newline-delimited streaming JSON . Commands handling tabular ranking data also support --csv saving 65–75% LLM tokens . | Command | Shortcut | Description | Flags | |---|---|---|---| | gsc connect | auth | 1-Click interactive setup wizard auto-detects service account in Downloads | --json , --compact | | gsc connect ke key | — | Connect Keywords Everywhere API key | — | | gsc connect-ga4 | — | Interactive Google Analytics 4 property linking wizard | — | | gsc doctor | health | Zero-Gem Stdlib & Cold Start Doctor: validates < 50ms latency & config integrity | --fix , --json , --compact | | gsc domains | sites | List all verified Search Console properties and linked GA4 properties | --json , --compact | | gsc use <domain | switch | Switch active default domain property | — | | gsc switch <domain | use | Fast agency switch between client domains or credential vault profiles | — | | gsc vault status | add | list | remove | | gsc where | — | Inspect CLI binary path, active credential file, and config path | --json , --compact | | gsc version | -v | Display CLI version and Ruby runtime environment | --json , --compact | | gsc commands | — | Machine-readable catalog of all 80 commands | --json , --compact | | Command | Shortcut | Description | Flags | |---|---|---|---| | gsc performance | perf | Search performance summary Clicks, Impressions, CTR, Position | --days , --json | | gsc top-queries | queries | Top search queries, impressions, CTR, and average position | --limit , --days , --brand , --non-brand , --csv , --json | | gsc top-pages | pages | Top indexed landing pages driving organic clicks & impressions | --limit , --days , --csv , --json | | gsc opportunities | opps | Striking-distance queries Pos 7–20 with high impression volume | --min-imp , --days , --csv , --json | | gsc strike | striker | Tactical Striking Playbook: High-yield queries primed for Top 3 rankings | --min-imp , --limit , --json | | gsc underperformers | u | High-ranking queries with below-average CTR title & meta tag wins | --limit , --days , --json | | gsc cannibalization | cannibal | Detect multiple internal URLs competing for the same search queries | --limit , --days , --json | | gsc decay | — | Period-over-period decay detection decaying vs surging queries | --compare , --days , --json | | gsc devices | — | Search traffic breakdown by device Desktop, Mobile, Tablet | --days , --json | | gsc countries | — | Geographic search demand by country with flags and CTR | --days , --json | | gsc snippets | — | Search appearance appearances Reviews, Products, FAQs | --days , --json | | gsc brand | — | Brand vs. Non-brand query segmentation and traffic split | --days , --brand-terms , --json | | gsc ctr-curve | — | Empirical CTR curve modeling by position with revenue lift simulator | --days , --target-pos , --json | | gsc intent-shift | — | Search intent volatility and position shift monitor | --days , --min-imp , --json | | gsc kw-value | kwval | Mathematical keyword conversion pipeline & dollar valuation matrix | --aov , --conv-rate , --margin , --target-pos , --csv , --json | | gsc landing-roi <url | roi | Landing page economic ROI & revenue leakage audit merges GSC + bounce rates | --aov , --conv-rate , --benchmark , --csv , --json | | Command | Shortcut | Description | Flags | |---|---|---|---| | gsc aio-hunter <query | aio | Google AI Overview Opportunity Hunter: detects AIO presence & cited sources | --limit , --min-imp , --days , --csv , --json | | gsc cite-sim <url | citability | AI Citation Simulator: tests LLM citability readiness and content density | --json | | gsc geo <url | aeo | Generative Engine Optimization GEO & LLM answer audit | --json | | gsc serp <title | preview | Google SERP Card & Pixel Simulator Desktop 580px, Mobile 650px | --desc , --url , --json | | gsc serp-features <q | — | Live SERP feature detector AI Overviews, PAA, Featured Snippets | --geo , --json | | gsc llms <url | ai-ready | AI Knowledge Base Generator: outputs structured /llms.txt bundle | --save , --json | | gsc entity <url | kg | Knowledge Graph & Entity Authority Auditor Wikidata, Wikipedia links | --json | | gsc firewall <url | ai-bots | AI Search Bot Firewall Scanner: audits robots.txt for GPTBot, ClaudeBot | --json | | gsc answer <q | — | Direct answer box and featured snippet synthesizer | --json | | Command | Shortcut | Description | Flags | |---|---|---|---| | gsc soft-404 <url | — | Soft-404 Diagnostic Engine with automated multi-stack redirect generation | --fix <stack , --json | | gsc mobile-parity <dom | mobile | Mobile vs. Desktop SERP Parity Auditor: cross-device rank gap diagnosis | --days , --gap-threshold , --csv , --json | | gsc audit | 360 | Comprehensive 360° technical and organic health audit | --json | | gsc report | — | Executive 360° Health Scorecard with letter grade and sparklines | --days , --sparkline , --json | | gsc page <url | — | Detailed On-Page DOM audit meta, headings, alts, schema + GSC performance | --check-links , --json | | gsc site-audit <sitemap | — | Crawls sitemaps, tests 404 dead links, audits DOM flaws, and outputs fix sprint | --report <file , --json | | gsc speed <url | vitals | Dual Lab Lighthouse & Field CrUX 28-day RUM Core Web Vitals LCP, INP, CLS, TTFB | --strategy mobile | | gsc speed-correlate | sc-perf | Correlates Core Web Vitals page speed with GSC organic rankings | --days , --strategy , --json | | gsc canonical-chains | chains | Canonical redirect loops and multi-hop chain detector | --limit , --json | | gsc low-ctr | — | High-impression low-CTR title & meta description rewriter | --limit , --min-imp , --json | | gsc titles <url | title-opt | Title pixel width calculator and SERP truncation optimizer | --json | | gsc headings <url | h1 | Heading structure H1–H6 depth, order, and keyword presence auditor | --json | | gsc orphans | — | Internal link equity analyzer: rescues orphaned unlinked pages | --json | | gsc internal-links | — | Deep internal link equity audit and anchor text distribution | --json | | gsc image-seo <url | — | Image SEO auditor: missing alt attributes, next-gen formats WebP/AVIF | --json | | gsc hreflang <url | — | International hreflang reciprocity and ISO language/region validator | --json | | gsc eeat <url | — | E-E-A-T Auditor: author credentials, publisher transparency & trust signals | --json | | gsc security <url | — | Security & HTTP headers auditor: SSL, HSTS, CSP, and X-Robots-Tag | --json | | gsc rich-results <url | rich | Google Rich Results eligibility and Schema.org test | --type , --json | | gsc schema <url | ld-json | JSON-LD Structured Data Validator and generator | --json | | gsc schema-generate | schema-gen | Valid Schema.org JSON-LD generator faq , software , article , product | --type , --json | | gsc trace <domain | redirects | Multi-hop 301/302 redirect tracer with SSL and header inspection | --json | | gsc robots <url | robots-txt | Robots.txt crawler permissions simulator across major bots | --bot , --json | | gsc authority <domain | opr | OpenPageRank Domain Authority 0–10 and Global Rank from Common Crawl | --json | | gsc compare <u1 <u2 | vs | Head-to-head on-page technical benchmark comparison | --json | | gsc content-gap <u1 <u2 | gap | Topical content gap analyzer: missing 1-gram, 2-gram, and 3-gram keyphrases | --json | | Command | Shortcut | Description | Flags | |---|---|---|---| | gsc inspect <url | — | Live Google URL inspection coverage status, assigned canonical, crawl date | --json | | gsc index <url | — | Priority Googlebot crawl submission URL UPDATED | --dry-run , --json | | gsc remove <url | — | Notify Googlebot of permanently deleted URL URL DELETED | --dry-run , --json | | gsc status <url | — | Check Google Indexing API submission status and latest notification timestamp | --json | | gsc index-batch | — | Batch URL indexing processor with daily 200-URL quota tracking | --batch-size , --force , --dry-run , --json | | gsc indexnow <url | — | Multi-engine instant submission Bing, Yandex, Seznam, Naver | --key , --json | | gsc zombies <sitemap | — | Detect zero-impression deadweight URLs wasting crawl budget over 90 days | --days , --json | | gsc sitemaps-list | — | List registered XML sitemaps in Search Console | --json | | gsc sitemaps-submit <url | — | Submit or re-submit an XML sitemap to Search Console | --json | | gsc sitemap-tree <url | — | Visual sitemap hierarchy tree and URL limit validator | --json | 🛡️ Batch Indexing Safety Guard gsc index-batch clear : When automating bulk indexing in scripts, CI/CD, or AI agents, an accidental clear could wipe hundreds of queued URLs waiting to be indexed. To prevent queue loss: Interactive Shells : Requires explicit y/N user confirmation. Non-Interactive / Scripts / Agents : Requires --force / -f aborts with exit code 1 if omitted . Automatic Backup : Every clear automatically snapshots the pending queue to ~/.gsc/backups/queue backup <TIMESTAMP .json before wiping, so URLs are never lost. | Command | Shortcut | Description | Flags | |---|---|---|---| | gsc trends <query | — | Real-time Google Trends trajectory velocity, sparklines & geo breakdown | --geo , --time , --json | | gsc planner <seed | — | Autocomplete seed expander with intent classification & live GSC correlation | --limit , --json | | gsc suggest <seed | — | Google Autocomplete & Alphabet Soup a-z keyword harvester | --alphabet , --json | | gsc questions <seed | paa | People Also Ask PAA question miner for FAQs and blog outlines | --limit , --json | | gsc import <file | clip | — | Ingest Google Ads / Keywords Everywhere data from clipboard clip or file | | gsc ke <seed | file | — | Keywords Everywhere direct API: exact monthly volume, CPC & competition | | gsc ke-credits | — | Check remaining Keywords Everywhere account API credits | --json | | gsc saved | — | List saved keyword research snapshots for the active domain | --json | | gsc saved check id | — | Re-check saved keyword snapshots against live GSC rankings to track wins | --json | | gsc saved view id | — | View stored keyword metrics and opportunity scores | --json | | gsc saved delete id | — | Delete a saved keyword research snapshot | — | | gsc seasonal <keyword | — | Seasonal keyword demand forecasting and peak month detection | --json | | gsc sparkline <query | — | High-resolution Unicode sparkline visualizer ▂▃▄▅▆▇█ | --days , --json | | Command | Shortcut | Description | Flags | |---|---|---|---| | gsc realtime | — | Stream active visitors, real-time page paths, and countries --watch | --watch , --json | | gsc ga4 | — | Landing page bounce rates, engagement rates, and average session duration | --organic , --json | | gsc correlation | — | Merge GSC keyword rankings with GA4 bounce rates per landing page | --json | | gsc channels | — | Traffic acquisition channels Organic Search, Direct, Referral, Paid | --json | | gsc ads | — | Google Ads campaign performance Clicks, Cost, CPC, Conversions | --json | | Command | Shortcut | Description | Flags | |---|---|---|---| | gsc skills install | show | — | Inspect or auto-install native AI Agent Skill SKILL.md | | gsc skill-pack | — | Autonomous Agent Skill Pack Generator for Cursor, Antigravity, and Claude | --install , --json | | gsc prompts list | show | — | 27 battle-tested tactical SEO growth prompts and playbooks | | gsc vault status | add | list | remove | | gsc cache status | clear | — | Multi-tier gzip response cache manager | 💡 Zero External LLM Calls : gsc-cli does NOT require an OpenAI or Anthropic API key and sends zero data to third-party AI servers. Everything runs locally on your machine. "AI Agent Native" refers to our deterministic --compact minified JSON and --ndjson flags designed to save 35–45% context tokens when called by local coding agents Claude Code, Cursor Composer, Antigravity . gsc-cli was engineered from the ground up to serve as the high-speed sensory organ for autonomous AI coding agents Antigravity , Claude Code , Cursor Composer , Windsurf , and OpenCode . Traditional CLI tools output ANSI-colored terminal text designed exclusively for human eyes—forcing AI agents to burn thousands of tokens scraping strings, guessing table columns, and hallucinating missing fields. gsc-cli eliminates this waste completely with sub-millisecond execution , zero gem overhead , and three ultra-efficient machine output formats . Every token consumed by CLI output burns developer budget, introduces LLM generation latency, and pushes critical prompt context out of the agent's memory window. gsc-cli provides four deterministic output formats to optimize your token economics: | Format | Flag | Avg. Chars 100 Rows | Est. Tokens | Token Savings | Optimal AI Agent Scenario | |---|---|---|---|---|---| | Tabular CSV | --csv | 3,920 | ~980 | 72.5% savings | High-cardinality exports 100–5,000 keywords/pages | | Compact JSON | --compact | 8,110 | ~2,028 | 43.0% savings | Default for Claude Code & Cursor single-turn queries | | Streaming NDJSON | --ndjson | 8,230 | ~2,058 | 42.2% savings | Streaming processors, jq/grep pipes & subagent tasks | | Pretty JSON | --json | 14,240 | ~3,560 | 0% Baseline | Human developer terminal inspection & debugging | ⚡ The Bottom Line: Switching your autonomous agents from --json to --compact immediately cuts token consumption by ~43% , allowing your agents to ingest more than double the keyword and performance data within identical context limits. Autonomous coding agents require strict, unpolluted output streams. gsc-cli enforces a military-grade stdout/stderr separation contract: - Zero ANSI Pollution : When --compact , --ndjson , --json , or --csv is detected, all ANSI terminal colors, progress bars, and Unicode spinners are automatically suppressed. - Pure Stdout Payload : Stdout contains only valid, parseable JSON, NDJSON, or CSV. - Stderr Diagnostic Routing : Network warnings, rate-limit retries, and error traces are routed strictly to stderr . - POSIX Exit Codes : Clean exit 0 on success, 1 on error or validation failure. Feed these exact commands to your AI agents or add them to your cursorrules / agent system prompts : Agent prompt: "Find our highest-impression striking distance queries Pos 7–20 and save token budget" gsc strike --min-imp 25 --limit 15 --compact Agent prompt: "Check if Google is showing an AI Overview for our core product query and who they cite" gsc aio-hunter "technical seo checklist" --compact Agent prompt: "Inspect missing landing page and synthesize an automated Nginx redirect block" gsc soft-404 https://example.com/missing-guide --fix nginx --compact Agent prompt: "Submit our newly published blog post to Google's Indexing API for crawl queueing" gsc index https://example.com/blog/high-impact-seo --compact Agent prompt: "Switch to client domain and pull 28-day performance summary" gsc switch clientdomain.com && gsc perf --days 28 --compact Install the official gsc-cli skill directly into your coding agent's environment: Installs SKILL.md into Antigravity, Claude, and Cursor skill directories gsc skills install Once installed, your agent automatically understands all 80 commands, flag permutations, token-saving modes, and diagnostic workflows without needing manual prompting. | Capability | Google Search Console Web UI | Official Google API SDK 40 Gems | Enterprise SEO Suites $300–$1,000+/mo | ApollosWave/gsc-cli v2.2.2 | |---|---|---|---|---| | Pricing | Free $0 | Free $0 | $300–$1,000+/mo $3,600–$12,000/yr | 100% Free & Open Source $0 | | Dependencies | Web Browser only | 40+ transitive gems googleauth , etc. | SaaS Web Application | 0 Gems / Pure Standard Library | | Boot / Execution Latency | Slow manual clicking | 3–5 seconds cold boot | Web UI latency | < 1 millisecond Compiled Binary | | Data Accuracy | 100% Google Ground Truth | 100% Google Ground Truth | Sampled external proxy estimates | 100% Google Ground Truth Direct API | | CLI Command Surface | ❌ None Web only | Raw Ruby code required | ❌ None Web dashboard | 80 Production Commands | | Core GSC Workflows | Manual tab clicking & export | Complex API code boilerplate | Partial GSC sync via OAuth | top-queries , top-pages , performance | | Instant Googlebot Indexing | Manual 1-by-1 submit | Complex JWT boilerplate | ❌ None | ✅ 1-Click Priority Ping gsc index | | Multi-Engine IndexNow | ❌ None | ❌ None | ❌ None | ✅ Bing, Yandex, Seznam, Naver gsc indexnow | | Striking Distance Playbook | ❌ Manual spreadsheet work | ❌ None | Expensive add-on tiers | ✅ Automated Page 2 Playbook gsc strike | | Google AI Overviews AIO | ❌ None | ❌ None | Limited / expensive beta tiers | ✅ Built-in aio-hunter & cite-sim | | Automated Fix Generation | ❌ None Error tables only | ❌ None | ❌ None | ✅ 14-Stack Redirects gsc soft-404 --fix | | Token Economics for AI | ❌ None | Verbose unformatted JSON | ❌ None | ✅ Native --compact , --ndjson , --csv 35–75% savings | | Autonomous AI Agent Skills | ❌ None | ❌ None | ❌ None | ✅ Native Skill for Claude, Cursor, Antigravity | gsc-cli is engineered with 100% pure Ruby standard library. It compiles into a single, self-contained, zero-dependency executable: gsc-cli/ ├── bin/ │ ├── gsc Compiled single-file binary RubyGems entry point │ └── test live Visual showcase & internal test harness ├── lib/ │ ├── gsc.rb Central stdlib loader │ └── gsc/ │ ├── version.rb Semantic versioning 2.2.2 │ ├── color.rb Zero-dependency ANSI formatting │ ├── config.rb Configuration persistence │ ├── auth.rb Pure OpenSSL JWT generator │ ├── client.rb Net::HTTP client with Gzip decompression │ ├── api.rb GSC, Indexing, GA4, PageSpeed endpoints │ ├── aio hunter.rb Google AI Overview Opportunity Hunter │ ├── citation simulator.rb AI Citability score & grounding heuristics │ ├── soft 404 analyzer.rb Soft-404 diagnostic & multi-stack fix generator │ ├── mobile parity.rb Cross-device SERP parity auditor │ ├── doctor.rb Zero-gem cold-start benchmark doctor │ ├── command registry.rb Catalog of all 80 production commands │ ├── cli/ Modular subcommand domains audit, keywords, growth... │ └── cli.rb Primary command dispatcher & router ├── dist/ │ └── gsc Standalone bundled binary 1-click curl & GitHub releases ├── gsc.gemspec Standard RubyGem specification ├── Rakefile Build, test, and standalone install tasks └── install.sh Universal 1-click shell installer Run syntax checks and all 359 unit test suites rake test Run 100-scenario deep forensic regression suite rake test:forensic Build the standalone single-file binary into dist/gsc rake build:standalone Install local development build to ~/.local/bin/gsc rake install:standalone gsc-cli is 100% free, MIT-licensed open-source software built to eliminate expensive recurring SaaS fees for developers, teams, and AI builders. If gsc-cli saves your team hours of manual audit work or monthly subscriptions, consider supporting continuous maintenance: 👉 View our Full Sponsorship Tiers & Company Invoicing Details → https://github.com/ApollosWave/gsc-cli/blob/main/FUNDING.md gsc-cli was created and is actively maintained by ApollosWave LLC https://apolloswave.com . We originally built this engine to automate Google Search Console diagnostics, crawl budgets, and Core Web Vitals across our own production applications: - Superspeed https://superspeedapp.com — Real-user monitoring RUM , Core Web Vitals, and speed intelligence for high-volume Shopify storefronts. - Supercart https://supercartapp.com — Slide cart drawer, in-house shipping protection, and real-time e-commerce upsell infrastructure. - PackingLog https://packinglog.com — Our newly launched physical moving inventory and QR-code tracking SaaS — where waiting weeks for Googlebot to discover new landing pages wasn't an option. We open-sourced gsc-cli under the MIT license so developers, engineering teams, and AI agents can run first-party search automation locally with zero dependency bloat. - Ben Sheldon https://github.com/bensheldon : Inspired by Ben Sheldon's backend Ruby Google Ads API implementation and the Rails performance community's passion for lean, zero-dependency, server-side tools. - Corey Haines https://github.com/coreyhaines31 : The companion SEO & marketing skills ai-seo , seo-audit , schema , programmatic-seo , copywriting , cro are adapted from the open-source marketingskills https://github.com/coreyhaines31/marketingskills repository by Corey Haines https://github.com/coreyhaines31 MIT License . - Basecamp & Kamal https://github.com/basecamp/kamal : Modular CLI directory layout and standalone distribution patterns inspired by Basecamp's open-source tooling. gsc-cli is 100% free, open-source software licensed under the MIT License https://github.com/ApollosWave/gsc-cli/blob/main/LICENSE . We built this because we believe command-line developer tools should be fast, transparent, and respect your machine's resources. The modern Ruby standard library is more than capable of handling enterprise-grade API integrations and cryptographic authentication without dragging in 40 third-party gems. If gsc-cli saves your team time, eliminates an unnecessary SaaS subscription, or accelerates your search pipelines, stars, feedback, and pull requests are always welcome.