Skillget

gsc-cli

mcp
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Uyari
  • network request — Outbound network request in lib/gsc/cli_advanced.rb
  • network request — Outbound network request in lib/gsc/client.rb
  • network request — Outbound network request in lib/gsc/config.rb
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

⚡ Zero-gem CLI & AI Agent engine for Google Search Console, Google Indexing API, GA4, Keywords Everywhere & Google Trends. Trigger instant Googlebot crawls, inspect live URLs, audit sitemaps, calculate keyword opportunity scores, and track rank movement in pure Ruby.

README.md

🚀 GSC CLI — The Zero-Dependency Google Search Console, Trends & Indexing Engine for High-Growth Operators

Zero Gem Dependencies. Pure Ruby standard library (Net::HTTP, OpenSSL, JSON).
Sub-50ms CLI & AI Agent engine for real-time Google search rankings, instant Googlebot indexing, Google Trends velocity, Keywords Everywhere volume, and 360° SEO health audits.

Ruby
Gem Version
Dependencies
License: MIT
Sponsor
AI Agent Native

gsc-cli is a free, open-source initiative built and maintained by ApollosWave LLC.

Explore other software built by our team:
⚡ Superspeed — Built for Shopify speed, CRO & revenue leak intelligence app (5.0 ★)
🛒 Supercart — Built for Shopify slide cart drawer, in-house shipping protection & upsells (5.0 ★)
📦 PackingLog — Smart QR-code box inventory & photo catalog for residential & office moves

⚡ The Brutal Truth About Modern SEO (And Why We Built GSC CLI)

Every software company, indie hacker, and e-commerce founder faces the exact same painful reality:

  1. You're Paying $300/Month for Guesswork: Third-party SEO suites (Ahrefs, Semrush, Moz) scrape search results and guess your rankings using outdated third-party databases. Meanwhile, Google already has the exact, ground-truth data for your site sitting inside Search Console—for free.
  2. Official Google API Gems Are Bloated Monsters: The official Google API Ruby gems (google-apis-searchconsole_v1, google-apis-indexing_v3, googleauth) drag in 40+ dependency gems, take 3 to 5 seconds just to boot, trigger bundle conflicts, and introduce constant supply-chain security alerts.
  3. Google Search Console's Web UI is Painfully Slow: Clicking through Google Search Console's web interface to inspect 50 URLs or spot keyword cannibalization takes hours of repetitive clicking, filtering, and tab-switching.
  4. AI Agents Need Clean, Fast, Machine-Readable Intelligence: Modern AI coding agents (Google Antigravity, Claude Code, Cursor, Codex) cannot click web buttons. They need raw, fast, deterministic JSON over stdout.

The Epiphany Bridge

At ApollosWave, we run multiple production software businesses—from Shopify revenue & speed intelligence (Superspeed) and e-commerce upsell apps (Supercart) to physical moving inventory SaaS (PackingLog).

We refused to bloat our repos with 40 gems or waste 10 hours a week clicking in Search Console. We needed a single, standalone pure-Ruby CLI that connects directly to Google APIs using native OpenSSL and Net::HTTP in under 50 milliseconds.

We built gsc-cli to run our own marketing. We open-sourced it 100% free under the MIT License so other builders and businesses can grow organic search traffic faster without the corporate SEO tax.

💎 Key Capabilities at a Glance

  • 📈 Real-Time Google Trends Engine: 5-year and 1-year search trajectory, growth velocity percentage, Unicode sparklines ( ▂▃▄▅▆▇█), and regional demand breakdowns with zero authentication.
  • 🎯 Zero-Auth Keyword Planner: Instant seed expansion via Google Autocomplete with automated search intent classification (Informational, Commercial, Transactional).
  • 💰 Keywords Everywhere Dual Ingestion (Zero-Cost Clipboard & Headless API): Ingest free keyword tables directly from the Keywords Everywhere web dashboard via gsc import clip (zero credits required), or connect paid API keys for 1-step automated terminal lookups (gsc ke).
  • 📊 Google Ads Planner Ingestion: Ingest CSV exports from Google Ads Keyword Planner, calculate composite Opportunity Scores (0–100), and cross-correlate with live GSC rankings.
  • 🚀 Instant Googlebot Re-Indexing: Ping Google's Indexing API with URL_UPDATED or URL_DELETED for priority crawl queueing within seconds.
  • 🔍 Live Google URL Inspection: Direct Search Console API check for indexing verdict, assigned canonical URL, crawl timestamps, and robots.txt state.
  • 💀 90-Day Zombie Page Detection: Automatically scan XML sitemaps to find zero-impression deadweight URLs draining your Google crawl budget.
  • 🛡️ Cannibalization & Decay Detection: Spot internal URLs fighting for the same queries, and compare 28-day period-over-period traffic trends.
  • 📊 Google Analytics 4 (GA4) Behavioral Link: Stream live active visitors (gsc realtime --watch) and correlate SERP rankings with landing page bounce rates.
  • 📑 Off-Page & On-Page SEO Merger (gsc page): Combines Detailed SEO Extension DOM inspection (title pixel width & SERP truncation, meta description, H1–H6 tree, missing alt attributes, canonicals, JSON-LD schema, OG/Twitter cards) with real Google Search Console 90-day search queries, clicks, and rankings.
  • 🕷️ 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.
  • 🤖 AI Agent Native: Every single command supports --json for instantaneous programmatic consumption by AI agents.

📦 Quick Installation

Option 1: Official RubyGem (Instant Global Install)

gem install gsc-cli

Option 2: 1-Line Standalone Installer (macOS & Linux)

curl -fsSL https://raw.githubusercontent.com/ApollosWave/gsc-cli/main/install.sh | bash

Option 3: In Your Gemfile (Bundler)

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

⚡ 2-Minute Google Setup

🔑 Need help with GA4, Google PageSpeed, OpenPageRank, or Keywords Everywhere?
Check out the complete Authentication & API Key Setup Guide (AUTH.md) for 30-second walkthroughs and zero-key features.

Step 1: Create a Google Cloud Service Account Key

  1. Open Google Cloud Console.
  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.

Step 2: Run 1-Click Interactive Connect

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.

Step 3: Add the Email to Google Search Console

  1. Copy the service account email displayed in the terminal.
  2. Go to Google 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

🧠 In-Depth Guides: Keyword Demand & Search Intelligence

0. Detailed Off-Page + On-Page SEO Merger (gsc page & gsc site-audit)

The Problem

On-page SEO browser extensions (like Detailed SEO Extension) inspect your DOM (titles, meta, headings, schemas), but they are blind to whether your page actually ranks on Google. Conversely, Google Search Console shows search impressions and positions, but tells you nothing about missing H1s, broken links, or images missing alt tags.

The Magic

gsc page merges both worlds into a single, cohesive 360° audit:

# Audit any URL combining DOM inspection with GSC 90-day search performance
gsc page https://packinglog.com/

# Deep internal link verification: tests HTTP status codes (200, 404, 500)
gsc page https://packinglog.com/ --check-links

# Local template auditing before deploying
gsc page src/routes/+page.svelte

And gsc site-audit crawls entire XML sitemaps to generate prioritized AI fix sprints:

gsc site-audit https://packinglog.com/sitemap.xml --report docs/seo/site_audit_issues.md

1. Keywords Everywhere Dual Workflow (gsc import clip & gsc ke)

The Problem

Knowing what people search is only half the battle. You need to know exact monthly search volume, Cost Per Click (CPC), and commercial competition. But keyword tools either force you to buy expensive API subscriptions or lock valuable data inside disconnected browser spreadsheets.

gsc-cli provides two flexible workflows tailored to how you work:

🆓 Method A: Zero-Cost Clipboard Ingestion (gsc import clip)

No API key or paid credits required! Works 100% free with the Keywords Everywhere web dashboard or browser extension.

If you don't have paid API credits, or prefer using the free daily lookups on the Keywords Everywhere website:

  1. Copy Your Keywords in the Browser:
    • Open Keywords Everywhere (or use their Chrome/Firefox extension or bulk keyword tool).
    • View any table of search volumes, CPCs, and competition metrics.
    • Click "Copy" / "Copy to Clipboard" (or select the rows and press Cmd+C / Ctrl+C).
  2. Run One Command in Your Terminal:
    gsc import clip
  3. Instant Analysis & GSC Correlation:
    gsc-cli uses native OS clipboard tools (pbpaste on macOS, xclip/wl-paste on Linux) to:
    • Parse volume, CPC, competition score, and monthly history at zero cost.
    • Draw live Unicode Sparklines ( ▂▃▄▅▆▇█) showing 12-month demand trajectory.
    • Calculate Opportunity Scores (0–100) to prioritize low-competition/high-volume wins.
    • Automatically cross-reference your live Google Search Console rankings (🏆 Top 3, 🥇 Page 1, 🎯 Striking Distance, or 🚀 Untargeted).
    • Automatically archive the snapshot into ~/.config/gsc/domains/<domain>/keywords/ so you can track rank progress over time!

⚡ Method B: Headless Direct API Integration (gsc ke)

For automated, headless terminal lookups. Requires a Keywords Everywhere API key with paid credits.

If you have purchased an API key from Keywords Everywhere (credits start at just $1.25 for 100,000 keyword lookups), you can query search demand directly from the terminal without ever opening a browser:

  1. Connect your API key once:
    gsc connect ke YOUR_API_KEY
    Your key is securely stored in ~/.config/gsc/config.json alongside your Google service account.
  2. Check your remaining account credits:
    gsc ke-credits
  3. Query any keyword topic or seed directly:
    gsc ke "mac cleaner" --limit 25
  4. Bulk inspect an entire keyword list headlessly:
    gsc ke keywords.txt --country us --limit 100 --json

Terminal Output:

🔍 KEYWORDS EVERYWHERE SEARCH DEMAND (Seed: mac cleaner)
   Country: US · Provider: Google Keyword Planner via Keywords Everywhere API
   Correlated with GSC: superspeedapp.com

  KEYWORD                              VOL/MO      CPC    COMP   OPP SCORE  INTENT         GSC RANK STATUS
  ──────────────────────────────────────────────────────────────────────────────────────────────────────────
  best mac cleaner 2025                18,100    $4.80    0.42      82/100  Commercial     🎯 Striking Distance (Pos 8.4)
  free mac disk cleaner                12,400    $3.10    0.28      88/100  Transactional  🚀 Untargeted
  clean my mac alternative              6,600    $6.50    0.35      81/100  Commercial     🥇 Page 1 (Pos 4.2)
  how to clear system storage mac       9,900    $1.20    0.15      89/100  Informational  🚀 Untargeted

2. Google Trends Real-Time Demand Engine (gsc trends)

The Problem

Standard search volume metrics are 12-month trailing averages. When consumer behavior shifts, or a seasonal moving spike occurs, static tools keep showing last year's data while you miss the active breakout.

The Magic

gsc trends queries Google Trends explore and widget APIs directly in real time with zero authentication and zero API keys. It calculates:

  • Trajectory Velocity: Compares recent interest vs historical baseline.
  • Velocity Badges: 🚀 (Explosive Breakout), 🔥 (Strong Surging), 📈 (Growing Demand), ⚖️ (Stable Demand), 📉 (Cooling).
  • Unicode Sparklines: Visualizes interest curves right in your terminal ( ▂▃▄▅▆▇█).
  • Geographic Heatmap: Identifies top states and regions driving demand.
gsc trends "moving boxes" --geo US --time 12m

gsc trends "local llm" --geo US --time 5y --json

3. Autocomplete Keyword Intent Expander (gsc planner)

The Problem

You need fresh keyword ideas based on what Google users are actively searching right now, without setting up paid APIs or logging into Google Ads.

The Magic

gsc planner queries Google's autocomplete infrastructure with zero keys, extracts 20–50 qualified search phrases, and uses regex linguistic heuristics to classify Search Intent:

  • Informational: "how to pack dishes for moving", "why is mac running slow"
  • Commercial: "best moving apps", "superspeed vs cleanmymac"
  • Transactional: "buy wardrobe moving boxes cheap", "hire movers near me"

It then checks your active domain's GSC rankings so you instantly see untargeted opportunities:

gsc planner "moving boxes" --limit 20

4. Universal Keyword Ingestion: Clipboard, Google Ads & Files (gsc import)

The Problem

Exporting search volume and CPC data from keyword tools usually results in messy spreadsheets that sit forgotten in your downloads folder. Merging those keywords with your live Google Search Console rankings requires complex VLOOKUPs and manual position checking.

The Magic

gsc import accepts raw keyword data directly from your clipboard or files exported from both Google Ads Keyword Planner and Keywords Everywhere (in .csv, .tsv, or markdown table format):

# 1-click ingest directly from your system clipboard (free & zero setup):
gsc import clip

# Import a Keywords Everywhere markdown or CSV export:
gsc import path/to/KW.md --limit 30

# Import a Google Ads Keyword Planner CSV/TSV:
gsc import path/to/google-ads-keywords.csv --limit 30

gsc automatically:

  • Deduplicates redundant keyword rows across multiple concatenated batches.
  • Normalizes search volumes, CPC bids, and competition tiers.
  • Extracts 12-Month Historical Demand: Automatically identifies monthly columns and renders a live Unicode Sparkline ( ▂▃▄▅▆▇█) for each keyword in your terminal.
  • Calculates Opportunity Scores (0–100):
    $$\text{Opportunity} = \text{Search Volume (0–50)} + (1 - \text{Competition}) \times 50$$
  • Cross-References Live GSC Rankings: Instantly flags whether your active domain is already ranking (🏆 Top 3, 🥇 Page 1, 🎯 Striking Distance) or represents an untapped gap (🚀 Untargeted).
  • Auto-Archives to Domain Storage: Automatically persists the dataset to ~/.config/gsc/domains/<domain>/keywords/ for historical rank tracking.

Terminal Output:

Opp Score | Volume/mo | CPC     | Comp | Tier   | Trend% [12m] | GSC Status                  | Intent        | Keyword
--------------------------------------------------------------------------------------------------------------------------------
       75 |     1,000 |  $11.04 | 0.10 | Low    |  -69% ▄▅▅█▅▁ | 🚀 Untargeted                | Navigational  | moving from san francisco to new york
       69 |        77 |   $0.00 | 0.00 | Low    |   +0% ▄▄▄▄▄▄ | 🚀 Untargeted                | Navigational  | moving from dallas to orlando
       68 |       390 |   $1.99 | 0.17 | Low    |  +25% ▁▄▄▄██ | 🚀 Untargeted                | Navigational  | storage unit size calculator
       68 |       110 |   $1.74 | 0.05 | Low    |  -65% ▂██▁▄▁ | 🚀 Untargeted                | Navigational  | moving checklist app
       64 |        30 |   $2.19 | 0.05 | Low    |  +83% ▃▁▁▆██ | 🚀 Untargeted                | Navigational  | moving volume calculator

5. Domain Keyword Archive & Rank Movement Tracker (gsc saved)

The Problem

Keyword research is only valuable if you track whether your content efforts actually move the needle over time. Without historical snapshots, you cannot tell if an unranked keyword from two months ago has entered striking distance.

The Magic

gsc-cli automatically stores all research and imported datasets in isolated domain directories under ~/.config/gsc/domains/<domain>/keywords/.

~/.config/gsc/
├── config.json
├── service-account.json
└── domains/
    ├── packinglog.com/
    │   └── keywords/
    │       ├── 2026-09-10-kw-md.json
    │       └── 2026-09-10-moving-boxes.json
    └── superspeedapp.com/
        └── keywords/
            └── 2026-09-10-mac-cleaner.json

List Saved Snapshots

gsc saved

📁 SAVED KEYWORD RESEARCH ARCHIVES (packinglog.com)
   Location: ~/.config/gsc/domains/packinglog.com/keywords

  # | Date       | Source                | Keywords | Seed / File
  --------------------------------------------------------------------------------
 [1] | 2026-09-10 | Import                |      209 | KW.md
 [2] | 2026-09-10 | Google Autocomplete   |       50 | moving boxes

Re-Check Live Search Console Rankings & Track Wins

Run gsc saved check <id> to re-query Search Console API in real-time and measure your rank progress:

gsc saved check 1

══════════════════════════════════════════════════════════════
📊 KEYWORD RANKING & OPPORTUNITY TRACKER (packinglog.com)
══════════════════════════════════════════════════════════════
  🏆 Top 3 Rankings:            2   (+2 new)
  🥇 Page 1 Rankings (4–10):    5   (+3 new)
  🎯 Striking Distance (11–20): 14  (+6 new)
  🚀 Untargeted / Unranked:     188
  📈 Total Tracked Keywords:    209
══════════════════════════════════════════════════════════════

🛠️ Complete CLI Command Reference

1. Setup, Configuration & Domain Switching

Command Description
gsc connect 1-Click interactive setup wizard: auto-detects key in Downloads or drag & drop
gsc connect ke [key] Connect Keywords Everywhere API key and save to ~/.config/gsc/config.json
gsc connect-ga4 Interactive Google Analytics 4 linking wizard
gsc domains List all verified Search Console properties and linked GA4 properties
gsc use <domain or #> Switch active default domain (e.g. gsc use 2 or gsc use packinglog.com)
gsc open Open ~/.config/gsc configuration directory in Finder
gsc where Inspect CLI binary path, active credential file, and config path
gsc update Self-update gsc to the latest version directly from GitHub
gsc version Display CLI version and Ruby runtime environment

2. Google Trends & Keyword Intelligence

Command Description
gsc trends <query> Real-time Google Trends 5y/1y demand velocity, sparklines, and geo breakdown
gsc planner <seed> Zero-auth Google Suggest intent expander with live GSC rank correlation
gsc import <file or clip> Ingest Google Ads / Keywords Everywhere data from clipboard (gsc import clip) or file (.csv, .tsv, .md) with 12m sparklines
gsc planner-import <file> Ingest Google Ads / Keywords Everywhere export (alias for import)
gsc ke <seed or file> Keywords Everywhere: Exact monthly volume, CPC, competition & GSC correlation
gsc ke-credits Check remaining Keywords Everywhere account API credits
gsc saved List saved keyword research snapshots for the active domain
gsc saved check [id] Re-check saved keyword snapshots against live GSC rankings to track wins
gsc saved view [id] View stored keyword metrics and opportunity scores
gsc saved delete [id] Delete a saved keyword research snapshot

3. Search Performance & SEO Growth Intelligence

Command Description
gsc top-queries Top search queries, impressions, CTR, and average position
gsc top-pages Top indexed landing pages driving organic clicks & impressions
gsc opportunities Striking-distance queries (Pos 7–20) to push to Page 1 and Top 3
gsc underperformers High-ranking queries (Top 10) with below-average CTR (title & meta tag wins)
gsc cannibalization Detect multiple internal URLs competing for the same search queries
gsc decay [--compare 28] Period-over-period decay detection (decaying vs surging queries)
gsc devices Search traffic breakdown by device (Desktop, Mobile, Tablet)
gsc countries Geographic search demand by country with flags and CTR
gsc snippets Search appearance appearances (Reviews, Products, FAQs)
gsc audit Comprehensive 4-step 360° SEO & Indexing Health Audit

4. Detailed On-Page DOM & Autonomous Site Crawling

Command Description
gsc page <url or file> 360° On-Page DOM audit (Title pixel width, meta, H1-H6, images, schema) + GSC rankings
gsc page <url> --check-links Verify HTTP status codes (detects 404 broken links) across all page links
gsc site-audit [sitemap] Crawl sitemap/site, test dead links, audit DOM flaws, and output summary
gsc site-audit --report <file> Export comprehensive AI-actionable Markdown fix sprint (e.g. site_issues.md)

4. Live Indexation & Googlebot Control

Command Description
gsc inspect <url> Live Google Search Console URL inspection (coverage, canonical, crawl date)
gsc index <url> Notify Googlebot to crawl/index a newly published URL immediately (URL_UPDATED)
gsc remove <url> Notify Googlebot a URL has been permanently deleted (URL_DELETED)
gsc status <url> Check Google Indexing API submission status and latest notification timestamp
gsc inspect-sitemap <file/url> Bulk inspect indexation status for all URLs in an XML sitemap
gsc index-sitemap <file/url> Batch submit all URLs in an XML sitemap to Google Indexing API
gsc zombies <sitemap> Identify zero-impression deadweight URLs wasting crawl budget over 90 days
gsc sitemaps-list List registered XML sitemaps in Search Console
gsc sitemaps-submit <url> Submit or re-submit an XML sitemap to Search Console

5. Google Analytics 4 (GA4) On-Site Behavior

Command Description
gsc realtime [--watch] Stream active visitors, real-time page paths, and countries
gsc ga4 [--organic] Landing page bounce rates, engagement rates, and average session duration
gsc correlation Merge GSC keyword rankings with GA4 bounce rates per landing page
gsc channels Traffic acquisition channels (Organic Search, Direct, Referral, Paid)
gsc ads Google Ads campaign performance (Clicks, Cost, CPC, Conversions)

🤖 AI Agent Native Integration (Antigravity, Claude, Cursor)

gsc-cli was built from the ground up for autonomous AI coding agents. Every single command supports the --json flag to return clean, deterministic, machine-readable JSON over stdout.

Agent Workflow Examples

# 1. Ask your agent to inspect striking-distance keywords:
gsc opportunities --min-imp 20 --json

# 2. Ask your agent to audit indexation before shipping a release:
gsc audit --json

# 3. Ask your agent to discover keyword demand with volume and CPC:
gsc ke "moving boxes" --limit 50 --json

# 4. Ask your agent to notify Googlebot the second it publishes a new blog post:
gsc index https://example.com/blog/new-guide --json

Install the official AI Agent Skill:

gsc skills install

🏢 Proudly Backed by ApollosWave LLC

gsc-cli is free and open-source software under the MIT License. It is actively developed and maintained by the engineering team at ApollosWave LLC.

We build tools for high-performance software, e-commerce, and everyday logistics. Check out our commercial products:

  • ⚡ Superspeed — Official Built for Shopify speed, CRO & revenue leak intelligence app (5.0 ★). Detect ghost checkouts, rage clicks, and latency bottlenecks, then automatically optimize Core Web Vitals to reclaim lost sales.
  • 🛒 Supercart — Official Built for Shopify slide cart drawer (5.0 ★). Lift AOV with a sub-10ms reactive drawer, 1-click in-cart upsells, multi-tier rewards, and self-funded shipping protection with 0% GMV commission.
  • 📦 PackingLog — The personal and business moving box inventory management app. Batch-photograph box items with your phone, print scannable QR stickers, and locate any item in seconds.

🧠 Modern SEO, AI Search (AEO) & Competitor Intelligence (v2.1)

GSC CLI v2.1 introduces a zero-cost, zero-gem suite of tools covering AI search readiness, competitor gap analysis, Core Web Vitals, and first-party Google autocompletions:

1. Google Autocomplete & Alphabet Soup (gsc suggest)

Harvest 100+ high-intent search suggestions across the full alphabet in seconds without paying for KeywordTool.io:

# Standard Google search suggestions
gsc suggest "moving boxes"

# Alphabet soup harvester (a-z permutations)
gsc suggest "storage units" --alphabet

# Machine-readable JSON output for AI pipelines
gsc suggest "commercial packaging" --alphabet --json

2. People Also Ask (PAA) Question Miner (gsc questions)

Mine real user questions directly from Google search intent modules to build instant FAQ sections and blog content outlines:

gsc questions "packing dishes"

3. Real Core Web Vitals via PageSpeed Insights (gsc speed)

Directly measure Google's official Core Web Vitals (LCP, INP, CLS, FCP, TTFB) and Lighthouse scores with 25,000 free queries/day:

# Audit mobile Core Web Vitals
gsc speed https://packinglog.com/ --strategy mobile

# Audit desktop performance with machine-readable diagnostics
gsc speed https://packinglog.com/features --strategy desktop --json

4. SurferSEO-Style Topical Content Gap (gsc content-gap)

Compare your page against any top-ranking competitor to uncover missing 1-gram, 2-gram, and 3-gram keyphrases and omitted headings:

gsc content-gap https://packinglog.com/ https://uhaul.com/

5. Head-to-Head On-Page Benchmark (gsc compare)

Run an instant side-by-side comparison of titles, meta descriptions, H1 counts, image alt tags, JSON-LD schemas, and server response times:

gsc compare https://packinglog.com/free-moving-labels https://uhaul.com/moving-supplies/boxes/

6. AI Search & LLM Citation Readiness (gsc llms)

Perplexity, ChatGPT, and Claude prioritize sites with clean markdown knowledge bases and structured layouts:

# Generate a production-ready /llms.txt file from your sitemap
gsc llms https://packinglog.com/ --save

# Audit a page's citation readiness score for AI answer engines
gsc llms https://packinglog.com/ audit

7. Rich Schema Validator & Generator (gsc schema)

Validate JSON-LD structured data against Google's Rich Result guidelines or generate copy-paste snippets:

# Validate existing structured data on a live page
gsc schema https://packinglog.com/

# Generate valid FAQPage JSON-LD snippet
gsc schema generate faq

# Generate valid SoftwareApplication JSON-LD snippet
gsc schema generate software

8. Google SERP & Social Card Simulator (gsc preview)

Render an exact ASCII preview of your Google desktop search snippet and OpenGraph/Twitter social cards before publishing:

gsc preview https://packinglog.com/

9. Redirect Chain & Header Tracer (gsc trace)

Trace multi-hop 301/302 redirect loops, HSTS security headers, canonical links, and X-Robots-Tag directives:

gsc trace packinglog.com

10. Robots.txt Crawler Simulator (gsc robots)

Simulate crawl permissions for Googlebot, GPTBot, PerplexityBot, or ClaudeBot:

gsc robots https://packinglog.com/ /admin --bot gptbot

11. Domain Authority via OpenPageRank (gsc authority)

Query PageRank (0–10) and Global Web Rank computed across Common Crawl's open graph with 300,000 free calls/month:

gsc authority packinglog.com uhaul.com

12. GSC External Backlink Ingestion (gsc backlinks)

Ingest your official Google Search Console External Links export without third-party crawler fees:

# Ingest links from clipboard or CSV file
gsc backlinks import clip
gsc backlinks import Links_External_Pages.csv

# View top referring domains and most linked landing pages
gsc backlinks packinglog.com

🥊 How GSC CLI Compares (The Zero-Bloat Advantage)

Full First-Party SEO Intelligence Without the $300/Mo Scraping Tax

Get complete ground-truth Search Console analytics, instant Googlebot indexing, and real-time trends in under 50ms — even if you refuse to pay third-party API fees, run heavy Docker containers, or manage bloated database dependencies.

Every other open-source SEO tool on GitHub falls into one of three painful traps:

  1. The DataForSEO Tax Trap: Many open-source tools look impressive until you discover they are thin frontends around DataForSEO. Every single keyword search, competitor look-up, and rank check costs you per-query API credits. When your credit balance runs dry, the tool stops working completely.
  2. The 500MB Docker Bloat Trap: Other suites require launching docker-compose, PostgreSQL databases, Redis queues, and heavy Node.js web servers just to audit 50 URLs. They are impossible to embed into lightweight terminal workflows or autonomous AI agent loops.
  3. The Fragile Single-Feature Script: Python-based tools often drag in heavy pandas and pytrends dependencies that break whenever Google updates internal endpoint tokens, without offering Google Search Console, Google Indexing, or actionable ranking correlation.

gsc-cli was engineered on a radically different architectural philosophy: Zero gems. Zero external databases. Zero middleman scraping fees. Pure Ruby standard library communicating directly with Google's bare-metal HTTP APIs in under 50 milliseconds.

📊 Feature Comparison Matrix

Capability every-app/open-seo (18k ⭐) crawlseo/crawlseo akvise/trends-checker ApollosWave/gsc-cli (v2.1.0)
Price $10/mo + DataForSEO fees Free (Requires VPS) Free / DataForSEO 100% Free & Open Source ($0)
Dependencies 100+ npm packages + DB Docker + Postgres + Node Python 3.11 + pandas 0 Gems / Pure Standard Library
Binary Size / Footprint ~300 MB+ ~500 MB+ (Docker images) ~150 MB (Python venv) 368 KB (Single executable file)
Execution Latency 3–5 seconds (Web app) Web UI 2–4 seconds < 50 milliseconds
Google Search Console Indirect / DataForSEO ✅ Direct API ❌ None ✅ Direct API with Gzip compression
Google Indexing API ❌ None ❌ None ❌ None ✅ Direct 1-click Googlebot ping
Google Analytics 4 ❌ None ❌ None ❌ None ✅ Realtime, Ads, & Traffic channels
Google Trends ❌ None ❌ None ✅ Standalone only ✅ Built-in velocity & sparklines
Site Crawler & Audits Paid DataForSEO crawler ✅ Max 2k pages ❌ None ✅ Sitemap + SERP pixel width checks
Keyword Ingestion DataForSEO API only ❌ Manual ❌ None ✅ gsc import clip (Free Clipboard)
AI Agent Native Skill MCP server only MCP server only ❌ None ✅ Claude Code / Antigravity Skill + JSON

🏗️ Architecture & Development

gsc-cli is engineered following a clean, modular Ruby architecture:

gsc-cli/
├── bin/
│   └── gsc                      # Lean executable runner (< 15 lines)
├── lib/
│   ├── gsc.rb                   # Central loader & stdlib requirements
│   └── gsc/
│       ├── version.rb           # Semantic versioning (2.0.0)
│       ├── color.rb             # Zero-dependency ANSI formatting
│       ├── config.rb            # ~/.config/gsc/config.json persistence
│       ├── auth.rb              # Pure OpenSSL JWT generator
│       ├── client.rb            # Net::HTTP client with JSON serialization
│       ├── api.rb               # GSC, Indexing & GA4 API endpoints
│       ├── sitemap_loader.rb    # XML crawler & sitemap index parser
│       ├── google_trends.rb     # Real-time search demand engine
│       ├── keyword_planner.rb   # Autocomplete expander & intent classifier
│       ├── keywords_everywhere.rb # Keywords Everywhere API client
│       ├── command_registry.rb  # Command catalog (47 commands) & AI skills
│       └── cli.rb               # Option parser, command router & wizards
├── dist/
│   └── gsc                      # Standalone bundled binary (curl distribution)
├── gsc.gemspec                  # Standard RubyGem specification
├── Rakefile                     # Tasks for build, test, and install
└── install.sh                   # Universal 1-click shell installer

Development Tasks

# Run syntax verification across all modular files
rake test

# Build the standalone single-file binary into dist/gsc
rake build:standalone

# Install local development build to ~/.local/bin/gsc
rake install:standalone

# Build gem package
rake gem:build

💖 Sponsorship & Backing

gsc-cli is free, open-source software built to eliminate predatory monthly subscriptions for indie developers, founders, and AI builders.

If GSC CLI saves your team hours of manual audit work or hundreds in monthly SaaS fees, consider backing continuous development:

Tier Monthly Perks Sponsorship Link
Community Supporter $10 / mo Name in README Backers list + Discord/GitHub badge Sponsor $10/mo
Backer $50 / mo Name + link in Backers section + priority issue triage Sponsor $50/mo
Agency Partner $100 / mo Small logo/link in Agency Backers gallery + priority triage Sponsor $100/mo
Bronze Sponsor $500 / mo Medium logo with dofollow backlink in README & docs Sponsor $500/mo
Silver Sponsor $1,500 / mo Large logo on top fold + monthly feature priority request Sponsor $1,500/mo
Gold Title Sponsor $2,500 / mo Title banner at top of README + 1h monthly consulting Sponsor $2,500/mo

All sponsorships are processed securely via Stripe by ApollosWave LLC. Invoices with company VAT / Business Tax ID provided automatically upon checkout.

👉 Read the Full Sponsorship Prospectus & Tier Breakdown →

ApollosWave Ecosystem

GSC CLI is maintained by ApollosWave LLC. Check out our products:

  • Superspeed: Autonomous Core Web Vitals & website speed optimization engine.
  • Supercart: High-converting slide cart drawer for Shopify merchants.
  • PackingLog: Smart QR-code moving box inventory organizer.

🙏 Acknowledgments & Credits

  • Ben Sheldon: 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: The companion SEO & marketing skills (ai-seo, seo-audit, schema, programmatic-seo, copywriting, cro) are adapted from the open-source marketingskills repository by Corey Haines (MIT License).
  • Basecamp & Kamal: Modular CLI directory layout and standalone distribution patterns inspired by Basecamp's open-source tooling.

📄 License

This project is open-source software licensed under the MIT License. See LICENSE for details.

Yorumlar (0)

Sonuc bulunamadi