gsc-cli 2.0.2 → 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 +171 -3
- 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 +17 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 7278e3338526ebd22a07fa284e452db00a738def6c2a4dbfbb4fbeaff3f5d4b3
|
|
4
|
+
data.tar.gz: bfdd760060590b89808a95d1355f4c11aba7e43dc1393f6775e0fcedfec96df2
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 3c41ca07104aabff6c25650a117332c14d93cf5977331ee95f93b15a19c2f77bdd518754b5e5e958c2ea1380bfa1b707e9382c801e87ba5ae0a03258798f891e
|
|
7
|
+
data.tar.gz: 5eca0283978fdfd7f8d279a8f4d3a54366a4430b33a3e767ed7e412fae49e6e0c95f2a880175cbccbf9d6d9c804b82429363b8ad0678a1d378a969b2e4038c2c
|
data/AUTH.md
ADDED
|
@@ -0,0 +1,205 @@
|
|
|
1
|
+
# 🔑 Authentication & API Key Setup Guide for GSC CLI
|
|
2
|
+
|
|
3
|
+
> **Zero Hidden Costs.** Every feature in `gsc-cli` runs on either zero API keys or completely free tiers provided directly by Google and open graph providers.
|
|
4
|
+
> Follow this master guide to connect Google Search Console, Google Indexing, GA4, Google PageSpeed, OpenPageRank, and Keywords Everywhere in under 3 minutes.
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## ⚡ Quick Reference: What Requires an API Key
|
|
9
|
+
|
|
10
|
+
| Tool & Command | Setup Required | Cost | How to Configure |
|
|
11
|
+
| :--- | :---: | :---: | :--- |
|
|
12
|
+
| **Google Search Console (`gsc search`, `gsc top`)** | Service Account JSON | **$0 Free** | `gsc connect` |
|
|
13
|
+
| **Google Indexing API (`gsc index`)** | Service Account JSON | **$0 Free** | `gsc connect` |
|
|
14
|
+
| **Google Analytics 4 (`gsc ga4`)** | Service Account + Property ID | **$0 Free** | `gsc config set ga4_property_id <ID>` |
|
|
15
|
+
| **Google Trends (`gsc trends`, `gsc velocity`)** | **Zero Setup / No Keys** | **$0 Free** | Works out of the box |
|
|
16
|
+
| **Google Suggest & PAA (`gsc suggest`, `gsc questions`)** | **Zero Setup / No Keys** | **$0 Free** | Works out of the box |
|
|
17
|
+
| **On-Page & Competitor Gap (`gsc compare`, `gsc content-gap`)** | **Zero Setup / No Keys** | **$0 Free** | Works out of the box |
|
|
18
|
+
| **Schema & AI Search (`gsc schema`, `gsc llms`)** | **Zero Setup / No Keys** | **$0 Free** | Works out of the box |
|
|
19
|
+
| **Network & Crawler Simulator (`gsc trace`, `gsc robots`)** | **Zero Setup / No Keys** | **$0 Free** | Works out of the box |
|
|
20
|
+
| **Google PageSpeed Insights (`gsc speed`)** | Optional Free API Key | **$0 Free** | `gsc config set pagespeed_api_key <KEY>` |
|
|
21
|
+
| **OpenPageRank Authority (`gsc authority`)** | Free API Key (300k calls/mo) | **$0 Free** | `gsc config set openpagerank_api_key <KEY>` |
|
|
22
|
+
| **Keywords Everywhere (`gsc import clip` vs `gsc ke`)** | Clipboard: $0 / API: $1.25 | **Free or Low** | `gsc config set keywords_everywhere_api_key <KEY>` |
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## 1. Google Search Console & Google Indexing API (Core Setup)
|
|
27
|
+
|
|
28
|
+
The core `gsc` engine connects directly to Google Cloud without any middleman servers or third-party databases.
|
|
29
|
+
|
|
30
|
+
### Step 1: Create a Free Google Cloud Service Account
|
|
31
|
+
1. Open the [Google Cloud Console](https://console.cloud.google.com/).
|
|
32
|
+
2. Create a new project (or select an existing one, e.g. `gsc-tools`).
|
|
33
|
+
3. Go to **APIs & Services > Library**, search for and **Enable** these two APIs:
|
|
34
|
+
* **Google Search Console API**
|
|
35
|
+
* **Web Search Indexing API**
|
|
36
|
+
4. Go to **IAM & Admin > Service Accounts** and click **Create Service Account**:
|
|
37
|
+
* Name: `gsc-operator`
|
|
38
|
+
* Click **Create and Continue**, then click **Done**.
|
|
39
|
+
5. Click on your newly created service account in the table:
|
|
40
|
+
* Navigate to the **Keys** tab.
|
|
41
|
+
* Click **Add Key > Create new key**.
|
|
42
|
+
* Select **JSON** and click **Create**. The key file will download to your computer.
|
|
43
|
+
|
|
44
|
+
### Step 2: 1-Click Interactive Terminal Connect
|
|
45
|
+
In your terminal, run:
|
|
46
|
+
```bash
|
|
47
|
+
gsc connect
|
|
48
|
+
```
|
|
49
|
+
`gsc` automatically inspects your `~/Downloads` folder for the newest Google Cloud JSON key, asks you to confirm with `Y`, moves it securely to `~/.config/gsc/service-account.json`, and displays the service account email.
|
|
50
|
+
|
|
51
|
+
### Step 3: Grant Access in Google Search Console
|
|
52
|
+
1. Copy the service account email (e.g. `gsc-operator@your-project.iam.gserviceaccount.com`).
|
|
53
|
+
2. Go to [Google Search Console](https://search.google.com/search-console/).
|
|
54
|
+
3. Select your property > **Settings** (bottom left) > **Users and permissions**.
|
|
55
|
+
4. Click **Add user**:
|
|
56
|
+
* **Email address**: Paste your service account email.
|
|
57
|
+
* **Permission**: **Owner** *(Required for 1-click Googlebot indexing requests)*.
|
|
58
|
+
5. Verify access immediately:
|
|
59
|
+
```bash
|
|
60
|
+
# List all verified properties
|
|
61
|
+
gsc domains
|
|
62
|
+
|
|
63
|
+
# Test querying search analytics
|
|
64
|
+
gsc search yourdomain.com
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## 2. Google Analytics 4 (GA4 Realtime & Traffic Channels)
|
|
70
|
+
|
|
71
|
+
Query real-time active users, acquisition channels, and Google Ads conversions alongside your Search Console rankings.
|
|
72
|
+
|
|
73
|
+
### Step 1: Enable the API
|
|
74
|
+
In Google Cloud Console, enable the **Google Analytics Data API**.
|
|
75
|
+
|
|
76
|
+
### Step 2: Grant Access in GA4
|
|
77
|
+
1. Open your [Google Analytics 4 Admin Console](https://analytics.google.com/).
|
|
78
|
+
2. Under **Property settings**, click **Property access management**.
|
|
79
|
+
3. Click the **+** icon > **Add users**:
|
|
80
|
+
* Paste your service account email (`gsc-operator@your-project.iam.gserviceaccount.com`).
|
|
81
|
+
* Role: **Viewer** or **Analyst**.
|
|
82
|
+
4. Copy your **Property ID** (found under **Property settings > Property details**).
|
|
83
|
+
|
|
84
|
+
### Step 3: Save Your Property ID
|
|
85
|
+
```bash
|
|
86
|
+
# Save to permanent configuration
|
|
87
|
+
gsc config set ga4_property_id 123456789
|
|
88
|
+
|
|
89
|
+
# Or pass via environment variable
|
|
90
|
+
export GA4_PROPERTY_ID=123456789
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## 3. Google PageSpeed Insights & Core Web Vitals (`gsc speed`)
|
|
96
|
+
|
|
97
|
+
Audit official mobile and desktop Lighthouse scores and 75th percentile Chrome User Experience Report (CrUX) metrics (LCP, INP, CLS, FCP, TTFB).
|
|
98
|
+
|
|
99
|
+
### Unauthenticated Mode (Default)
|
|
100
|
+
`gsc speed` works immediately with **zero configuration** for normal development auditing:
|
|
101
|
+
```bash
|
|
102
|
+
gsc speed https://example.com
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
### High-Throughput Mode (Optional Free API Key)
|
|
106
|
+
If you run high-frequency batch audits in CI/CD pipelines (up to 25,000 queries/day free):
|
|
107
|
+
1. In Google Cloud Console, enable **PageSpeed Insights API**.
|
|
108
|
+
2. Go to **APIs & Services > Credentials** > **Create Credentials** > **API Key**.
|
|
109
|
+
3. Save the key:
|
|
110
|
+
```bash
|
|
111
|
+
gsc config set pagespeed_api_key AIzaSyYourKeyHere
|
|
112
|
+
|
|
113
|
+
# Or pass as environment variable
|
|
114
|
+
export PAGESPEED_API_KEY=AIzaSyYourKeyHere
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
---
|
|
118
|
+
|
|
119
|
+
## 4. OpenPageRank Domain Authority (`gsc authority`)
|
|
120
|
+
|
|
121
|
+
Query true PageRank (0–10) and Global Web Rank computed across Common Crawl's multi-billion page open graph.
|
|
122
|
+
|
|
123
|
+
### Setup (30 Seconds, 300,000 Free Calls / Month)
|
|
124
|
+
1. Sign up for a free account at [OpenPageRank (domcop.com)](https://www.domcop.com/openpagerank/).
|
|
125
|
+
2. Copy your API key from your dashboard.
|
|
126
|
+
3. Save the key:
|
|
127
|
+
```bash
|
|
128
|
+
gsc config set openpagerank_api_key opr-your-key-here
|
|
129
|
+
|
|
130
|
+
# Or pass as environment variable
|
|
131
|
+
export OPENPAGERANK_API_KEY=opr-your-key-here
|
|
132
|
+
```
|
|
133
|
+
4. Test authority lookup:
|
|
134
|
+
```bash
|
|
135
|
+
gsc authority github.com apple.com yourdomain.com
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
## 5. Keywords Everywhere (`gsc import clip` vs `gsc ke`)
|
|
141
|
+
|
|
142
|
+
Get monthly search volume, Cost-Per-Click (CPC), and 12-month historical trend velocity.
|
|
143
|
+
|
|
144
|
+
### Option A: The 100% Free Clipboard Method (Zero Setup)
|
|
145
|
+
You do not need an API key. Whenever you browse Keywords Everywhere in Chrome/Brave:
|
|
146
|
+
1. Click **"Copy"** on any keyword widget.
|
|
147
|
+
2. In your terminal, run:
|
|
148
|
+
```bash
|
|
149
|
+
gsc import clip
|
|
150
|
+
```
|
|
151
|
+
`gsc` parses the clipboard text, normalizes search volumes and CPC, and saves it into your local domain archive.
|
|
152
|
+
|
|
153
|
+
### Option B: Direct API Integration
|
|
154
|
+
If you prefer automated terminal lookups without using the browser extension:
|
|
155
|
+
1. Get an API key from [Keywords Everywhere](https://keywordseverywhere.com/) ($1.25 one-time for 100,000 credits).
|
|
156
|
+
2. Save your key:
|
|
157
|
+
```bash
|
|
158
|
+
gsc config set keywords_everywhere_api_key your_ke_api_key_here
|
|
159
|
+
|
|
160
|
+
# Or pass as environment variable
|
|
161
|
+
export KEYWORDS_EVERYWHERE_API_KEY=your_ke_api_key_here
|
|
162
|
+
```
|
|
163
|
+
3. Query volume directly:
|
|
164
|
+
```bash
|
|
165
|
+
gsc ke "technical seo" "static site generator"
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
---
|
|
169
|
+
|
|
170
|
+
## 6. Configuration Management Cheatsheet
|
|
171
|
+
|
|
172
|
+
View, set, and manage all your local credentials stored securely in `~/.config/gsc/`:
|
|
173
|
+
|
|
174
|
+
```bash
|
|
175
|
+
# View active configuration and stored keys
|
|
176
|
+
gsc config
|
|
177
|
+
|
|
178
|
+
# Set a configuration value
|
|
179
|
+
gsc config set <key> <value>
|
|
180
|
+
|
|
181
|
+
# Run interactive connect for Google Service Account
|
|
182
|
+
gsc connect
|
|
183
|
+
|
|
184
|
+
# Set active default domain
|
|
185
|
+
gsc use example.com
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
### Supported Environment Variables
|
|
189
|
+
For automated Docker, GitHub Actions, or CI/CD pipelines, all configuration can be passed via environment variables without disk storage:
|
|
190
|
+
|
|
191
|
+
```bash
|
|
192
|
+
export GSC_KEY_FILE="/path/to/service-account.json"
|
|
193
|
+
export GSC_DEFAULT_DOMAIN="example.com"
|
|
194
|
+
export GA4_PROPERTY_ID="123456789"
|
|
195
|
+
export PAGESPEED_API_KEY="AIzaSy..."
|
|
196
|
+
export OPENPAGERANK_API_KEY="opr-..."
|
|
197
|
+
export KEYWORDS_EVERYWHERE_API_KEY="..."
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
---
|
|
201
|
+
|
|
202
|
+
<p align="center">
|
|
203
|
+
<b>Need Help?</b><br>
|
|
204
|
+
If you run into permission errors, verify that your service account email is listed as an <b>Owner</b> in Google Search Console Settings.
|
|
205
|
+
</p>
|
data/FUNDING.md
ADDED
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
# Fuel Independent, Zero-Bloat Developer Tooling While Putting Your Brand in Front of High-Velocity Engineers
|
|
2
|
+
|
|
3
|
+
> **The Sponsorship Prospectus for GSC CLI & The ApollosWave Open Source Ecosystem**
|
|
4
|
+
> Put your company, brand, or agency directly into the daily terminal workflows, CI/CD pipelines, and GitHub READMEs of thousands of software engineers, founders, and technical SEO operators — even if you have never sponsored an open-source tool before or operate with a strict B2B performance marketing budget.
|
|
5
|
+
|
|
6
|
+
[](https://www.ruby-lang.org)
|
|
7
|
+
[](https://rubygems.org/gems/gsc-cli)
|
|
8
|
+
[](#)
|
|
9
|
+
[](LICENSE)
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 🎯 The Dilemma: Why Traditional Developer Advertising Fails
|
|
14
|
+
|
|
15
|
+
If you have ever tried to market to developers, engineers, and technical founders, you already know the painful truth:
|
|
16
|
+
- **They use aggressive ad-blockers**: Display ads and programmatic banners are completely invisible to 84% of senior engineers.
|
|
17
|
+
- **They despise corporate sales pitches**: Sponsored blog posts and spammy cold emails get flagged or ignored.
|
|
18
|
+
- **PPC is outrageously expensive**: B2B search terms like *"SEO audit tool"*, *"Google Search Console API"*, or *"SERP tracker"* cost upwards of **$14.50 to $32.00 per single click** on Google Ads — with zero guarantee of conversion.
|
|
19
|
+
- **Conference booths cost a fortune**: Sponsoring a 2-day developer conference costs between **$12,000 and $25,000**, only for the banners to be torn down 48 hours later.
|
|
20
|
+
|
|
21
|
+
### Sponsoring GSC CLI is Fundamentally Different
|
|
22
|
+
`gsc-cli` is not a weekend hobby script. It is an ultra-fast, zero-dependency, sub-50ms engine adopted by developers, agency owners, and AI builders who run mission-critical Google search intelligence every single day.
|
|
23
|
+
|
|
24
|
+
When you back `gsc-cli`, you are not giving away charity. You are securing **365 days of persistent, high-authority visibility** across GitHub, Google-indexed documentation, terminal releases, and developer mindshare for a tiny fraction of a single PPC campaign.
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## ⚡ The 6 Sponsorship Tiers
|
|
29
|
+
|
|
30
|
+
Select the tier that aligns with your brand's growth goals. All payments are billed monthly via Stripe with immediate receipt generation and business tax ID support:
|
|
31
|
+
|
|
32
|
+
| Tier | Monthly | Target Audience | Primary Visibility & Deliverables | Checkout |
|
|
33
|
+
| :--- | :---: | :--- | :--- | :---: |
|
|
34
|
+
| **Community Supporter** | **$10 / mo** | Individual Engineers | Name listed in README Backers section + GitHub Supporter badge | [**Subscribe ($10/mo)**](https://buy.stripe.com/fZu6oG4Qz1EucVT4ygbAs00) |
|
|
35
|
+
| **Backer** | **$50 / mo** | Freelancers & Power Users | Hyperlinked name in Backers section + priority triage on GitHub issues | [**Subscribe ($50/mo)**](https://buy.stripe.com/7sY00ier91Eu5tr0i0bAs01) |
|
|
36
|
+
| **Agency Partner / Team** | **$100 / mo** | Boutique Agencies & Dev Shops | Small company logo & link in **Agency Partners** gallery + issue priority | [**Subscribe ($100/mo)**](https://buy.stripe.com/6oU9AS1Engzog853ucbAs02) |
|
|
37
|
+
| **Bronze Sponsor** | **$500 / mo** | Growing B2B SaaS & Tech Brands | Medium logo with **dofollow backlink** in main Sponsor grid in README & docs | [**Subscribe ($500/mo)**](https://buy.stripe.com/eVqdR882LgzobRP9SAbAs03) |
|
|
38
|
+
| **Silver Sponsor** | **$1,500 / mo** | Established Scaleups & Dev Tools | Large logo on **top fold** of README + monthly roadmap feature priority | [**Subscribe ($1,500/mo)**](https://buy.stripe.com/8x2aEWbeX2IybRP1m4bAs04) |
|
|
39
|
+
| **Gold Title Sponsor** | **$2,500 / mo** | Enterprise & Industry Leaders | **Exclusive Title Sponsor banner** at very top of README + 1hr monthly consulting | [**Subscribe ($2,500/mo)**](https://buy.stripe.com/cNi7sK4Qz6YOaNL3ucbAs05) |
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## 💎 Deep Breakdown: What Each Tier Gets
|
|
44
|
+
|
|
45
|
+
### 1. Community Supporter ($10 / month)
|
|
46
|
+
*Designed for indie developers and fans who love fast, zero-dependency tools.*
|
|
47
|
+
* **README Recognition**: Your name or GitHub handle listed in the `Backers & Supporters` section.
|
|
48
|
+
* **Community Karma**: Direct satisfaction of knowing you keep open-source developer tooling 100% free from venture bloat.
|
|
49
|
+
* 👉 [**Join as Community Supporter ($10/mo)**](https://buy.stripe.com/fZu6oG4Qz1EucVT4ygbAs00)
|
|
50
|
+
|
|
51
|
+
### 2. Backer ($50 / month)
|
|
52
|
+
*Designed for power-user consultants, solo technical SEOs, and senior freelancers.*
|
|
53
|
+
* **Hyperlinked Profile**: Your name linked directly to your personal website or GitHub profile.
|
|
54
|
+
* **Priority Issue Triage**: Your bug reports and edge-case questions receive priority attention from the maintainers.
|
|
55
|
+
* 👉 [**Join as Backer ($50/mo)**](https://buy.stripe.com/7sY00ier91Eu5tr0i0bAs01)
|
|
56
|
+
|
|
57
|
+
### 3. Agency Partner / Team ($100 / month)
|
|
58
|
+
*The no-brainer tier for SEO agencies, digital consultancies, and engineering teams.*
|
|
59
|
+
* **Agency Logo & Dofollow Link**: 32x32px logo and company link featured in the dedicated `Agency Partners & Teams` gallery.
|
|
60
|
+
* **Client Credibility**: Show your clients that your agency actively powers and contributes to leading search intelligence infrastructure.
|
|
61
|
+
* **Priority Feature Consideration**: Suggest new CLI flags, CSV export schemas, or agent prompts tailored to your agency's reporting workflow.
|
|
62
|
+
* 👉 [**Join as Agency Partner ($100/mo)**](https://buy.stripe.com/6oU9AS1Engzog853ucbAs02)
|
|
63
|
+
|
|
64
|
+
### 4. Bronze Sponsor ($500 / month)
|
|
65
|
+
*High-impact exposure for developer tools, hosting providers, analytics SaaS, and growth services.*
|
|
66
|
+
* **Prominent Medium Logo**: 64px crisp logo in the main `Sponsors` grid at the top of the README.
|
|
67
|
+
* **High-Authority Dofollow Backlink**: Direct link to your homepage, product landing page, or free trial.
|
|
68
|
+
* **Release Changelog Mentions**: Acknowledged in official GitHub releases and gem version release notes.
|
|
69
|
+
* 👉 [**Become a Bronze Sponsor ($500/mo)**](https://buy.stripe.com/eVqdR882LgzobRP9SAbAs03)
|
|
70
|
+
|
|
71
|
+
### 5. Silver Sponsor ($1,500 / month)
|
|
72
|
+
*Premium placement for established developer platforms, cloud providers, and enterprise software.*
|
|
73
|
+
* **Top-Fold Showcase**: 96px prominent logo displayed above the fold on the repository README and official documentation.
|
|
74
|
+
* **Monthly Feature Priority**: Direct access to request 1 dedicated feature enhancement, export schema, or integration per quarter.
|
|
75
|
+
* **Co-Marketing & Social Shoutout**: Quarterly feature announcement on our official channels and changelog highlighting your brand's support.
|
|
76
|
+
* 👉 [**Become a Silver Sponsor ($1,500/mo)**](https://buy.stripe.com/8x2aEWbeX2IybRP1m4bAs04)
|
|
77
|
+
|
|
78
|
+
### 6. Gold Title Sponsor ($2,500 / month)
|
|
79
|
+
*Exclusive category exclusivity. Only 1 Gold Title Sponsor slot is available across the entire project.*
|
|
80
|
+
* **Exclusive Hero Banner**: Your custom banner placed at the **very top of the README** right below the primary headline (`"GSC CLI is proudly presented by [Your Company]"`).
|
|
81
|
+
* **1-Hour Monthly Strategy Call**: Direct monthly 60-minute technical consultation with ApollosWave principal engineers regarding search architecture, Core Web Vitals optimization, or AI agent pipelines.
|
|
82
|
+
* **First-Class Ecosystem Integration**: Permanent status as the foundational patron of the ApollosWave open-source stack.
|
|
83
|
+
* 👉 [**Claim Gold Title Sponsorship ($2,500/mo)**](https://buy.stripe.com/cNi7sK4Qz6YOaNL3ucbAs05)
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## 📊 The Math: Why Sponsoring GSC CLI Destroys Google Ads
|
|
88
|
+
|
|
89
|
+
| Channel | Cost | Duration | Audience Quality | Ad-Block Resistant? |
|
|
90
|
+
| :--- | :---: | :---: | :---: | :---: |
|
|
91
|
+
| **Google Ads (B2B SEO)** | $3,500 / mo | Only while paying | Mixed / Low-intent clicks | ❌ No |
|
|
92
|
+
| **Tech Newsletter Sponsor** | $1,800 | 1 email blast | Ephemeral (archived in 24h) | ⚠️ Partial |
|
|
93
|
+
| **Conference Booth** | $15,000 | 2 days | Local attendees only | N/A |
|
|
94
|
+
| **GSC CLI Bronze Sponsor** | **$500 / mo** | **Continuous 365 Days** | **100% Verified Engineers & Founders** | **✅ 100% Yes** |
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
## 💬 Frequently Asked Questions (B2B & Commercial)
|
|
99
|
+
|
|
100
|
+
### Can my business write this off as a tax deduction
|
|
101
|
+
**Yes.** All payments are processed commercially by **ApollosWave LLC**. Your checkout confirmation includes a complete, compliant B2B tax invoice with line-item detail, your company name, and your VAT/EIN/Tax ID. Sponsoring an open-source technical tool is fully classified as a **Software & Advertising / Marketing Expense**.
|
|
102
|
+
|
|
103
|
+
### How quickly will our logo and link appear
|
|
104
|
+
Your logo and backlink are published within **24 hours** of completing checkout. Our team receives an instant automated notification from Stripe and immediately stages your assets.
|
|
105
|
+
|
|
106
|
+
### What assets do we need to provide
|
|
107
|
+
During Stripe checkout, you can supply your website link. After checkout, simply email your high-resolution SVG or transparent PNG logo to `sponsors@apolloswave.com` (or open a GitHub Issue), and our engineers will format and optimize it for dark and light modes.
|
|
108
|
+
|
|
109
|
+
### Can we change our destination URL or logo later
|
|
110
|
+
Yes, at any time. Simply send us an email or file a ticket from your account email, and your links or assets will be updated within 1 business day.
|
|
111
|
+
|
|
112
|
+
### Can we cancel at any time
|
|
113
|
+
Yes. There are no lock-in contracts. You will receive an instant Stripe Customer Portal link where you can update your payment method, download past VAT invoices, or pause/cancel your sponsorship with a single click whenever you wish.
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
<p align="center">
|
|
118
|
+
<b>Ready to elevate your engineering brand?</b><br>
|
|
119
|
+
Choose your tier above, or contact our engineering team directly at <a href="mailto:sponsors@apolloswave.com"><b>sponsors@apolloswave.com</b></a> for custom enterprise arrangements.
|
|
120
|
+
</p>
|
data/README.md
CHANGED
|
@@ -7,6 +7,7 @@
|
|
|
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
|
---
|
|
@@ -18,7 +19,7 @@
|
|
|
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/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli"><b>Superspeed</b></a> —
|
|
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>
|
|
22
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>
|
|
23
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>
|
|
@@ -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/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli)**, 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
|
|
|
@@ -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:
|
|
@@ -463,12 +467,148 @@ gsc skills install
|
|
|
463
467
|
|
|
464
468
|
We build tools for high-performance software, e-commerce, and everyday logistics. Check out our commercial products:
|
|
465
469
|
|
|
466
|
-
- ⚡ **[Superspeed](https://superspeedapp.com/?utm_source=github&utm_medium=readme&utm_campaign=gsc-cli)** — The
|
|
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.
|
|
467
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.
|
|
468
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.
|
|
469
473
|
|
|
470
474
|
---
|
|
471
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** |
|
|
609
|
+
|
|
610
|
+
---
|
|
611
|
+
|
|
472
612
|
## 🏗️ Architecture & Development
|
|
473
613
|
|
|
474
614
|
`gsc-cli` is engineered following a clean, modular Ruby architecture:
|
|
@@ -516,6 +656,34 @@ rake gem:build
|
|
|
516
656
|
|
|
517
657
|
---
|
|
518
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
|
+
|
|
519
687
|
## 🙏 Acknowledgments & Credits
|
|
520
688
|
|
|
521
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.
|