gsc-cli 2.0.1 → 2.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/AUTH.md +205 -0
- data/FUNDING.md +120 -0
- data/README.md +237 -38
- data/bin/gsc +2028 -197
- data/dist/gsc +167 -5
- data/lib/gsc/backlinks_manager.rb +96 -0
- data/lib/gsc/cli.rb +156 -3
- data/lib/gsc/cli_advanced.rb +570 -0
- data/lib/gsc/config.rb +9 -0
- data/lib/gsc/content_gap.rb +112 -0
- data/lib/gsc/google_suggest.rb +109 -0
- data/lib/gsc/internal_links.rb +132 -0
- data/lib/gsc/llms_generator.rb +104 -0
- data/lib/gsc/network_tracer.rb +86 -0
- data/lib/gsc/open_page_rank.rb +72 -0
- data/lib/gsc/page_comparator.rb +108 -0
- data/lib/gsc/page_speed.rb +110 -0
- data/lib/gsc/robots_checker.rb +83 -0
- data/lib/gsc/schema_validator.rb +122 -0
- data/lib/gsc/serp_preview.rb +66 -0
- data/lib/gsc/version.rb +1 -1
- data/lib/gsc.rb +26 -0
- metadata +33 -6
data/README.md
CHANGED
|
@@ -7,20 +7,21 @@
|
|
|
7
7
|
[](https://rubygems.org/gems/gsc-cli)
|
|
8
8
|
[](#)
|
|
9
9
|
[](LICENSE)
|
|
10
|
+
[](#-sponsorship--backing)
|
|
10
11
|
[](#-ai-agent-native-integration-antigravity-claude-cursor)
|
|
11
12
|
|
|
12
13
|
---
|
|
13
14
|
|
|
14
15
|
<p align="center">
|
|
15
16
|
<b>gsc-cli</b> is a free, open-source initiative built and maintained by
|
|
16
|
-
<a href="https://apolloswave.com"><b>ApollosWave LLC</b></a>.
|
|
17
|
+
<a href="https://apolloswave.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli"><b>ApollosWave LLC</b></a>.
|
|
17
18
|
</p>
|
|
18
19
|
|
|
19
20
|
<p align="center">
|
|
20
21
|
<sub>Explore other software built by our team:</sub><br>
|
|
21
|
-
⚡ <a href="https://superspeedapp.com"><b>Superspeed</b></a> —
|
|
22
|
-
🛒 <a href="https://
|
|
23
|
-
📦 <a href="https://packinglog.com"><b>PackingLog</b></a> — Smart QR-code box inventory & photo catalog for residential & office moves
|
|
22
|
+
⚡ <a href="https://superspeedapp.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli"><b>Superspeed</b></a> — Shopify speed, CRO & revenue leak intelligence app (5.0 ★)<br>
|
|
23
|
+
🛒 <a href="https://supercartapp.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli"><b>Supercart</b></a> — High-converting slide cart drawer & 1-click upsells for Shopify stores<br>
|
|
24
|
+
📦 <a href="https://packinglog.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli"><b>PackingLog</b></a> — Smart QR-code box inventory & photo catalog for residential & office moves
|
|
24
25
|
</p>
|
|
25
26
|
|
|
26
27
|
---
|
|
@@ -35,7 +36,7 @@ Every software company, indie hacker, and e-commerce founder faces the exact sam
|
|
|
35
36
|
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.
|
|
36
37
|
|
|
37
38
|
### The Epiphany Bridge
|
|
38
|
-
At **[ApollosWave](https://apolloswave.com)**, we run multiple production software businesses—from
|
|
39
|
+
At **[ApollosWave](https://apolloswave.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli)**, we run multiple production software businesses—from Shopify revenue & speed intelligence (**[Superspeed](https://superspeedapp.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli)**) and e-commerce upsell apps (**[Supercart](https://supercartapp.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli)**) to physical moving inventory SaaS (**[PackingLog](https://packinglog.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli)**).
|
|
39
40
|
|
|
40
41
|
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**.
|
|
41
42
|
|
|
@@ -47,7 +48,7 @@ We built **`gsc-cli`** to run our own marketing. **We open-sourced it 100% free
|
|
|
47
48
|
|
|
48
49
|
- 📈 **Real-Time Google Trends Engine**: 5-year and 1-year search trajectory, growth velocity percentage, Unicode sparklines (` ▂▃▄▅▆▇█`), and regional demand breakdowns with zero authentication.
|
|
49
50
|
- 🎯 **Zero-Auth Keyword Planner**: Instant seed expansion via Google Autocomplete with automated search intent classification (`Informational`, `Commercial`, `Transactional`).
|
|
50
|
-
- 💰 **Keywords Everywhere API
|
|
51
|
+
- 💰 **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`).
|
|
51
52
|
- 📊 **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.
|
|
52
53
|
- 🚀 **Instant Googlebot Re-Indexing**: Ping Google's Indexing API with `URL_UPDATED` or `URL_DELETED` for priority crawl queueing within seconds.
|
|
53
54
|
- 🔍 **Live Google URL Inspection**: Direct Search Console API check for indexing verdict, assigned canonical URL, crawl timestamps, and robots.txt state.
|
|
@@ -92,6 +93,9 @@ gsc version
|
|
|
92
93
|
|
|
93
94
|
## ⚡ 2-Minute Google Setup
|
|
94
95
|
|
|
96
|
+
> 🔑 **Need help with GA4, Google PageSpeed, OpenPageRank, or Keywords Everywhere?**
|
|
97
|
+
> Check out the complete **[Authentication & API Key Setup Guide (AUTH.md)](AUTH.md)** for 30-second walkthroughs and zero-key features.
|
|
98
|
+
|
|
95
99
|
### Step 1: Create a Google Cloud Service Account Key
|
|
96
100
|
1. Open [Google Cloud Console](https://console.cloud.google.com/).
|
|
97
101
|
2. In **APIs & Services > Library**, enable:
|
|
@@ -147,17 +151,60 @@ gsc site-audit https://packinglog.com/sitemap.xml --report docs/seo/site_audit_i
|
|
|
147
151
|
|
|
148
152
|
---
|
|
149
153
|
|
|
150
|
-
### 1. Keywords Everywhere
|
|
154
|
+
### 1. Keywords Everywhere Dual Workflow (`gsc import clip` & `gsc ke`)
|
|
151
155
|
|
|
152
156
|
#### The Problem
|
|
153
|
-
Knowing *what* people search is only half the battle. You need to know **exact monthly search volume**, **Cost Per Click (CPC)**, and **commercial competition**.
|
|
157
|
+
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.
|
|
154
158
|
|
|
155
|
-
|
|
156
|
-
`gsc-cli` integrates directly with the official Keywords Everywhere API. In a single command, it expands any topic, pulls exact search volumes and CPCs, calculates an **Opportunity Score (0–100)**, and checks whether your domain already ranks for that keyword in Search Console:
|
|
159
|
+
`gsc-cli` provides **two flexible workflows** tailored to how you work:
|
|
157
160
|
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
+
---
|
|
162
|
+
|
|
163
|
+
#### 🆓 Method A: Zero-Cost Clipboard Ingestion (`gsc import clip`)
|
|
164
|
+
> **No API key or paid credits required!** Works 100% free with the Keywords Everywhere web dashboard or browser extension.
|
|
165
|
+
|
|
166
|
+
If you don't have paid API credits, or prefer using the free daily lookups on the Keywords Everywhere website:
|
|
167
|
+
|
|
168
|
+
1. **Copy Your Keywords in the Browser**:
|
|
169
|
+
* Open [Keywords Everywhere](https://keywordseverywhere.com/) (or use their Chrome/Firefox extension or bulk keyword tool).
|
|
170
|
+
* View any table of search volumes, CPCs, and competition metrics.
|
|
171
|
+
* Click **"Copy"** / **"Copy to Clipboard"** (or select the rows and press `Cmd+C` / `Ctrl+C`).
|
|
172
|
+
2. **Run One Command in Your Terminal**:
|
|
173
|
+
```bash
|
|
174
|
+
gsc import clip
|
|
175
|
+
```
|
|
176
|
+
3. **Instant Analysis & GSC Correlation**:
|
|
177
|
+
`gsc-cli` uses native OS clipboard tools (`pbpaste` on macOS, `xclip`/`wl-paste` on Linux) to:
|
|
178
|
+
* Parse volume, CPC, competition score, and monthly history at zero cost.
|
|
179
|
+
* Draw live **Unicode Sparklines (` ▂▃▄▅▆▇█`)** showing 12-month demand trajectory.
|
|
180
|
+
* Calculate **Opportunity Scores (0–100)** to prioritize low-competition/high-volume wins.
|
|
181
|
+
* Automatically cross-reference your live Google Search Console rankings (`🏆 Top 3`, `🥇 Page 1`, `🎯 Striking Distance`, or `🚀 Untargeted`).
|
|
182
|
+
* Automatically archive the snapshot into `~/.config/gsc/domains/<domain>/keywords/` so you can track rank progress over time!
|
|
183
|
+
|
|
184
|
+
---
|
|
185
|
+
|
|
186
|
+
#### ⚡ Method B: Headless Direct API Integration (`gsc ke`)
|
|
187
|
+
> **For automated, headless terminal lookups.** Requires a Keywords Everywhere API key with paid credits.
|
|
188
|
+
|
|
189
|
+
If you have purchased an API key from [Keywords Everywhere](https://keywordseverywhere.com/) (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:
|
|
190
|
+
|
|
191
|
+
1. **Connect your API key once**:
|
|
192
|
+
```bash
|
|
193
|
+
gsc connect ke YOUR_API_KEY
|
|
194
|
+
```
|
|
195
|
+
*Your key is securely stored in `~/.config/gsc/config.json` alongside your Google service account.*
|
|
196
|
+
2. **Check your remaining account credits**:
|
|
197
|
+
```bash
|
|
198
|
+
gsc ke-credits
|
|
199
|
+
```
|
|
200
|
+
3. **Query any keyword topic or seed directly**:
|
|
201
|
+
```bash
|
|
202
|
+
gsc ke "mac cleaner" --limit 25
|
|
203
|
+
```
|
|
204
|
+
4. **Bulk inspect an entire keyword list headlessly**:
|
|
205
|
+
```bash
|
|
206
|
+
gsc ke keywords.txt --country us --limit 100 --json
|
|
207
|
+
```
|
|
161
208
|
|
|
162
209
|
Terminal Output:
|
|
163
210
|
```text
|
|
@@ -173,22 +220,6 @@ Terminal Output:
|
|
|
173
220
|
how to clear system storage mac 9,900 $1.20 0.15 89/100 Informational 🚀 Untargeted
|
|
174
221
|
```
|
|
175
222
|
|
|
176
|
-
#### How to Connect Keywords Everywhere in 10 Seconds
|
|
177
|
-
1. Get an API key from [Keywords Everywhere](https://keywordseverywhere.com/) (credits start at just $1.25 for 100,000 keywords).
|
|
178
|
-
2. Connect it in `gsc`:
|
|
179
|
-
```bash
|
|
180
|
-
gsc connect ke YOUR_API_KEY
|
|
181
|
-
```
|
|
182
|
-
*Your key is securely saved to `~/.config/gsc/config.json` alongside your Google credentials.*
|
|
183
|
-
3. Check remaining account credits anytime:
|
|
184
|
-
```bash
|
|
185
|
-
gsc ke-credits
|
|
186
|
-
```
|
|
187
|
-
4. Bulk inspect an entire keyword file:
|
|
188
|
-
```bash
|
|
189
|
-
gsc ke keywords.txt --country us --limit 100 --json
|
|
190
|
-
```
|
|
191
|
-
|
|
192
223
|
---
|
|
193
224
|
|
|
194
225
|
### 2. Google Trends Real-Time Demand Engine (`gsc trends`)
|
|
@@ -231,18 +262,22 @@ gsc planner "moving boxes" --limit 20
|
|
|
231
262
|
|
|
232
263
|
---
|
|
233
264
|
|
|
234
|
-
### 4. Universal Keyword Ingestion: Google Ads &
|
|
265
|
+
### 4. Universal Keyword Ingestion: Clipboard, Google Ads & Files (`gsc import`)
|
|
235
266
|
|
|
236
267
|
#### The Problem
|
|
237
268
|
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.
|
|
238
269
|
|
|
239
270
|
#### The Magic
|
|
240
|
-
`gsc import` accepts raw
|
|
271
|
+
`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):
|
|
272
|
+
|
|
241
273
|
```bash
|
|
242
|
-
#
|
|
274
|
+
# 1-click ingest directly from your system clipboard (free & zero setup):
|
|
275
|
+
gsc import clip
|
|
276
|
+
|
|
277
|
+
# Import a Keywords Everywhere markdown or CSV export:
|
|
243
278
|
gsc import path/to/KW.md --limit 30
|
|
244
279
|
|
|
245
|
-
# Import Google Ads Keyword Planner CSV/TSV
|
|
280
|
+
# Import a Google Ads Keyword Planner CSV/TSV:
|
|
246
281
|
gsc import path/to/google-ads-keywords.csv --limit 30
|
|
247
282
|
```
|
|
248
283
|
|
|
@@ -344,7 +379,7 @@ gsc saved check 1
|
|
|
344
379
|
|---|---|
|
|
345
380
|
| `gsc trends <query>` | Real-time Google Trends 5y/1y demand velocity, sparklines, and geo breakdown |
|
|
346
381
|
| `gsc planner <seed>` | Zero-auth Google Suggest intent expander with live GSC rank correlation |
|
|
347
|
-
| `gsc import <file>` | Ingest Google Ads
|
|
382
|
+
| `gsc import <file or clip>` | Ingest Google Ads / Keywords Everywhere data from clipboard (`gsc import clip`) or file (.csv, .tsv, .md) with 12m sparklines |
|
|
348
383
|
| `gsc planner-import <file>` | Ingest Google Ads / Keywords Everywhere export (alias for `import`) |
|
|
349
384
|
| `gsc ke <seed or file>` | Keywords Everywhere: Exact monthly volume, CPC, competition & GSC correlation |
|
|
350
385
|
| `gsc ke-credits` | Check remaining Keywords Everywhere account API credits |
|
|
@@ -428,13 +463,149 @@ gsc skills install
|
|
|
428
463
|
|
|
429
464
|
## 🏢 Proudly Backed by ApollosWave LLC
|
|
430
465
|
|
|
431
|
-
`gsc-cli` is free and open-source software under the [MIT License](LICENSE). It is actively developed and maintained by the engineering team at **[ApollosWave LLC](https://apolloswave.com)**.
|
|
466
|
+
`gsc-cli` is free and open-source software under the [MIT License](LICENSE). It is actively developed and maintained by the engineering team at **[ApollosWave LLC](https://apolloswave.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli)**.
|
|
432
467
|
|
|
433
468
|
We build tools for high-performance software, e-commerce, and everyday logistics. Check out our commercial products:
|
|
434
469
|
|
|
435
|
-
- ⚡ **[Superspeed](https://superspeedapp.com)** — The
|
|
436
|
-
- 🛒 **[Supercart](https://
|
|
437
|
-
- 📦 **[PackingLog](https://packinglog.com)** — 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.
|
|
470
|
+
- ⚡ **[Superspeed](https://superspeedapp.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli)** — The premier Shopify speed, CRO & revenue leak intelligence app. Detect ghost checkouts, rage clicks, and latency bottlenecks, then automatically optimize Core Web Vitals to reclaim lost sales.
|
|
471
|
+
- 🛒 **[Supercart](https://supercartapp.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli)** — The modern slide cart drawer for Shopify. Boost Average Order Value (AOV) with automated in-cart upsells, free shipping progress bars, and instant 1-click checkout.
|
|
472
|
+
- 📦 **[PackingLog](https://packinglog.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli)** — 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.
|
|
473
|
+
|
|
474
|
+
---
|
|
475
|
+
|
|
476
|
+
## 🧠 Modern SEO, AI Search (AEO) & Competitor Intelligence (v2.1)
|
|
477
|
+
|
|
478
|
+
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**:
|
|
479
|
+
|
|
480
|
+
### 1. Google Autocomplete & Alphabet Soup (`gsc suggest`)
|
|
481
|
+
Harvest 100+ high-intent search suggestions across the full alphabet in seconds without paying for KeywordTool.io:
|
|
482
|
+
```bash
|
|
483
|
+
# Standard Google search suggestions
|
|
484
|
+
gsc suggest "moving boxes"
|
|
485
|
+
|
|
486
|
+
# Alphabet soup harvester (a-z permutations)
|
|
487
|
+
gsc suggest "storage units" --alphabet
|
|
488
|
+
|
|
489
|
+
# Machine-readable JSON output for AI pipelines
|
|
490
|
+
gsc suggest "commercial packaging" --alphabet --json
|
|
491
|
+
```
|
|
492
|
+
|
|
493
|
+
### 2. People Also Ask (PAA) Question Miner (`gsc questions`)
|
|
494
|
+
Mine real user questions directly from Google search intent modules to build instant FAQ sections and blog content outlines:
|
|
495
|
+
```bash
|
|
496
|
+
gsc questions "packing dishes"
|
|
497
|
+
```
|
|
498
|
+
|
|
499
|
+
### 3. Real Core Web Vitals via PageSpeed Insights (`gsc speed`)
|
|
500
|
+
Directly measure Google's official Core Web Vitals (LCP, INP, CLS, FCP, TTFB) and Lighthouse scores with 25,000 free queries/day:
|
|
501
|
+
```bash
|
|
502
|
+
# Audit mobile Core Web Vitals
|
|
503
|
+
gsc speed https://packinglog.com/ --strategy mobile
|
|
504
|
+
|
|
505
|
+
# Audit desktop performance with machine-readable diagnostics
|
|
506
|
+
gsc speed https://packinglog.com/features --strategy desktop --json
|
|
507
|
+
```
|
|
508
|
+
|
|
509
|
+
### 4. SurferSEO-Style Topical Content Gap (`gsc content-gap`)
|
|
510
|
+
Compare your page against any top-ranking competitor to uncover missing 1-gram, 2-gram, and 3-gram keyphrases and omitted headings:
|
|
511
|
+
```bash
|
|
512
|
+
gsc content-gap https://packinglog.com/ https://uhaul.com/
|
|
513
|
+
```
|
|
514
|
+
|
|
515
|
+
### 5. Head-to-Head On-Page Benchmark (`gsc compare`)
|
|
516
|
+
Run an instant side-by-side comparison of titles, meta descriptions, H1 counts, image alt tags, JSON-LD schemas, and server response times:
|
|
517
|
+
```bash
|
|
518
|
+
gsc compare https://packinglog.com/free-moving-labels https://uhaul.com/moving-supplies/boxes/
|
|
519
|
+
```
|
|
520
|
+
|
|
521
|
+
### 6. AI Search & LLM Citation Readiness (`gsc llms`)
|
|
522
|
+
Perplexity, ChatGPT, and Claude prioritize sites with clean markdown knowledge bases and structured layouts:
|
|
523
|
+
```bash
|
|
524
|
+
# Generate a production-ready /llms.txt file from your sitemap
|
|
525
|
+
gsc llms https://packinglog.com/ --save
|
|
526
|
+
|
|
527
|
+
# Audit a page's citation readiness score for AI answer engines
|
|
528
|
+
gsc llms https://packinglog.com/ audit
|
|
529
|
+
```
|
|
530
|
+
|
|
531
|
+
### 7. Rich Schema Validator & Generator (`gsc schema`)
|
|
532
|
+
Validate JSON-LD structured data against Google's Rich Result guidelines or generate copy-paste snippets:
|
|
533
|
+
```bash
|
|
534
|
+
# Validate existing structured data on a live page
|
|
535
|
+
gsc schema https://packinglog.com/
|
|
536
|
+
|
|
537
|
+
# Generate valid FAQPage JSON-LD snippet
|
|
538
|
+
gsc schema generate faq
|
|
539
|
+
|
|
540
|
+
# Generate valid SoftwareApplication JSON-LD snippet
|
|
541
|
+
gsc schema generate software
|
|
542
|
+
```
|
|
543
|
+
|
|
544
|
+
### 8. Google SERP & Social Card Simulator (`gsc preview`)
|
|
545
|
+
Render an exact ASCII preview of your Google desktop search snippet and OpenGraph/Twitter social cards before publishing:
|
|
546
|
+
```bash
|
|
547
|
+
gsc preview https://packinglog.com/
|
|
548
|
+
```
|
|
549
|
+
|
|
550
|
+
### 9. Redirect Chain & Header Tracer (`gsc trace`)
|
|
551
|
+
Trace multi-hop 301/302 redirect loops, HSTS security headers, canonical links, and `X-Robots-Tag` directives:
|
|
552
|
+
```bash
|
|
553
|
+
gsc trace packinglog.com
|
|
554
|
+
```
|
|
555
|
+
|
|
556
|
+
### 10. Robots.txt Crawler Simulator (`gsc robots`)
|
|
557
|
+
Simulate crawl permissions for Googlebot, GPTBot, PerplexityBot, or ClaudeBot:
|
|
558
|
+
```bash
|
|
559
|
+
gsc robots https://packinglog.com/ /admin --bot gptbot
|
|
560
|
+
```
|
|
561
|
+
|
|
562
|
+
### 11. Domain Authority via OpenPageRank (`gsc authority`)
|
|
563
|
+
Query PageRank (0–10) and Global Web Rank computed across Common Crawl's open graph with 300,000 free calls/month:
|
|
564
|
+
```bash
|
|
565
|
+
gsc authority packinglog.com uhaul.com
|
|
566
|
+
```
|
|
567
|
+
|
|
568
|
+
### 12. GSC External Backlink Ingestion (`gsc backlinks`)
|
|
569
|
+
Ingest your official Google Search Console External Links export without third-party crawler fees:
|
|
570
|
+
```bash
|
|
571
|
+
# Ingest links from clipboard or CSV file
|
|
572
|
+
gsc backlinks import clip
|
|
573
|
+
gsc backlinks import Links_External_Pages.csv
|
|
574
|
+
|
|
575
|
+
# View top referring domains and most linked landing pages
|
|
576
|
+
gsc backlinks packinglog.com
|
|
577
|
+
```
|
|
578
|
+
|
|
579
|
+
---
|
|
580
|
+
|
|
581
|
+
## 🥊 How GSC CLI Compares (The Zero-Bloat Advantage)
|
|
582
|
+
|
|
583
|
+
### Full First-Party SEO Intelligence Without the $300/Mo Scraping Tax
|
|
584
|
+
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.
|
|
585
|
+
|
|
586
|
+
Every other open-source SEO tool on GitHub falls into one of three painful traps:
|
|
587
|
+
|
|
588
|
+
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.
|
|
589
|
+
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.
|
|
590
|
+
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.
|
|
591
|
+
|
|
592
|
+
**`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.
|
|
593
|
+
|
|
594
|
+
### 📊 Feature Comparison Matrix
|
|
595
|
+
|
|
596
|
+
| Capability | every-app/open-seo (18k ⭐) | crawlseo/crawlseo | akvise/trends-checker | ApollosWave/gsc-cli (v2.1.0) |
|
|
597
|
+
| :--- | :--- | :--- | :--- | :--- |
|
|
598
|
+
| **Price** | $10/mo + DataForSEO fees | Free (Requires VPS) | Free / DataForSEO | **100% Free & Open Source ($0)** |
|
|
599
|
+
| **Dependencies** | 100+ npm packages + DB | Docker + Postgres + Node | Python 3.11 + pandas | **0 Gems / Pure Standard Library** |
|
|
600
|
+
| **Binary Size / Footprint** | ~300 MB+ | ~500 MB+ (Docker images) | ~150 MB (Python venv) | **368 KB (Single executable file)** |
|
|
601
|
+
| **Execution Latency** | 3–5 seconds (Web app) | Web UI | 2–4 seconds | **< 50 milliseconds** |
|
|
602
|
+
| **Google Search Console** | Indirect / DataForSEO | ✅ Direct API | ❌ None | **✅ Direct API with Gzip compression** |
|
|
603
|
+
| **Google Indexing API** | ❌ None | ❌ None | ❌ None | **✅ Direct 1-click Googlebot ping** |
|
|
604
|
+
| **Google Analytics 4** | ❌ None | ❌ None | ❌ None | **✅ Realtime, Ads, & Traffic channels** |
|
|
605
|
+
| **Google Trends** | ❌ None | ❌ None | ✅ Standalone only | **✅ Built-in velocity & sparklines** |
|
|
606
|
+
| **Site Crawler & Audits** | Paid DataForSEO crawler | ✅ Max 2k pages | ❌ None | **✅ Sitemap + SERP pixel width checks** |
|
|
607
|
+
| **Keyword Ingestion** | DataForSEO API only | ❌ Manual | ❌ None | **✅ `gsc import clip` (Free Clipboard)** |
|
|
608
|
+
| **AI Agent Native Skill** | MCP server only | MCP server only | ❌ None | **✅ Claude Code / Antigravity Skill + JSON** |
|
|
438
609
|
|
|
439
610
|
---
|
|
440
611
|
|
|
@@ -485,6 +656,34 @@ rake gem:build
|
|
|
485
656
|
|
|
486
657
|
---
|
|
487
658
|
|
|
659
|
+
## 💖 Sponsorship & Backing
|
|
660
|
+
|
|
661
|
+
`gsc-cli` is free, open-source software built to eliminate predatory monthly subscriptions for indie developers, founders, and AI builders.
|
|
662
|
+
|
|
663
|
+
If GSC CLI saves your team hours of manual audit work or hundreds in monthly SaaS fees, consider backing continuous development:
|
|
664
|
+
|
|
665
|
+
| Tier | Monthly | Perks | Sponsorship Link |
|
|
666
|
+
| :--- | :--- | :--- | :--- |
|
|
667
|
+
| **Community Supporter** | **$10 / mo** | Name in README Backers list + Discord/GitHub badge | [**Sponsor $10/mo**](https://buy.stripe.com/fZu6oG4Qz1EucVT4ygbAs00) |
|
|
668
|
+
| **Backer** | **$50 / mo** | Name + link in Backers section + priority issue triage | [**Sponsor $50/mo**](https://buy.stripe.com/7sY00ier91Eu5tr0i0bAs01) |
|
|
669
|
+
| **Agency Partner** | **$100 / mo** | Small logo/link in Agency Backers gallery + priority triage | [**Sponsor $100/mo**](https://buy.stripe.com/6oU9AS1Engzog853ucbAs02) |
|
|
670
|
+
| **Bronze Sponsor** | **$500 / mo** | Medium logo with dofollow backlink in README & docs | [**Sponsor $500/mo**](https://buy.stripe.com/eVqdR882LgzobRP9SAbAs03) |
|
|
671
|
+
| **Silver Sponsor** | **$1,500 / mo** | Large logo on top fold + monthly feature priority request | [**Sponsor $1,500/mo**](https://buy.stripe.com/8x2aEWbeX2IybRP1m4bAs04) |
|
|
672
|
+
| **Gold Title Sponsor** | **$2,500 / mo** | Title banner at top of README + 1h monthly consulting | [**Sponsor $2,500/mo**](https://buy.stripe.com/cNi7sK4Qz6YOaNL3ucbAs05) |
|
|
673
|
+
|
|
674
|
+
> *All sponsorships are processed securely via **Stripe** by ApollosWave LLC. Invoices with company VAT / Business Tax ID provided automatically upon checkout.*
|
|
675
|
+
|
|
676
|
+
👉 **[Read the Full Sponsorship Prospectus & Tier Breakdown →](FUNDING.md)**
|
|
677
|
+
|
|
678
|
+
|
|
679
|
+
### ApollosWave Ecosystem
|
|
680
|
+
GSC CLI is maintained by [ApollosWave LLC](https://apolloswave.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli). Check out our products:
|
|
681
|
+
- **[Superspeed](https://superspeedapp.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli)**: Autonomous Core Web Vitals & website speed optimization engine.
|
|
682
|
+
- **[Supercart](https://supercartapp.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli)**: High-converting slide cart drawer for Shopify merchants.
|
|
683
|
+
- **[PackingLog](https://packinglog.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli)**: Smart QR-code moving box inventory organizer.
|
|
684
|
+
|
|
685
|
+
---
|
|
686
|
+
|
|
488
687
|
## 🙏 Acknowledgments & Credits
|
|
489
688
|
|
|
490
689
|
- **[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.
|