gsc-cli 2.2.0 → 2.2.3

data/lib/gsc/cli/keywords.rb

@@ -384,7 +384,7 @@ module GSC
             key = input unless input.nil? || input.empty?
             key = existing if key.empty?
           else
-            puts "Get your Keywords Everywhere API key at: #{Color.c('https://keywordseverywhere.com/', Color::UNDERLINE)}"
+            puts "Get your Keywords Everywhere API key at: #{Color.c('https://keywordseverywhere.com/?fpr=us25sg', Color::UNDERLINE)}"
             print "Paste your Keywords Everywhere API Key: "
             key = $stdin.gets&.strip
           end
@@ -415,7 +415,7 @@ module GSC
             puts "  2. #{Color.c('100% Free Live Google Trends (Breakout & Related terms):', Color::BLUE, Color::BOLD)}"
             puts "     • Run: #{Color.c('gsc trends "seo audit"', Color::BLUE, Color::BOLD)}"
             puts "  3. #{Color.c('Top Up Credits for Automated Background CLI Lookups:', Color::GRAY, Color::BOLD)}"
-            puts "     • Purchase credits at: https://keywordseverywhere.com/credit-packages.html"
+            puts "     • Purchase credits at: https://keywordseverywhere.com/credit-packages.html?fpr=us25sg"
             puts "     • Your key is already saved; it will work immediately upon top-up.\n"
           else
             puts "\nTry searching keywords:"
@@ -440,7 +440,7 @@ module GSC
             puts "\n" + Color.c("ℹ️ You have 0 paid REST API credits remaining.", Color::YELLOW)
             puts "• Free Web Alternative: Check volume on keywordseverywhere.com, click 'Copy', then run: #{Color.c('gsc import clip', Color::CYAN)}"
             puts "• Free Live Trends: #{Color.c('gsc trends "seo audit"', Color::BLUE)}"
-            puts "• Top up credits at: https://keywordseverywhere.com/credit-packages.html"
+            puts "• Top up credits at: https://keywordseverywhere.com/credit-packages.html?fpr=us25sg"
           end
         else
           if acct[:error].to_s =~ /401|Unauthorized/i
@@ -477,7 +477,7 @@ module GSC
           else
             puts Color.c("\n❌ Keywords Everywhere API key not configured!\n", Color::RED, Color::BOLD)
             puts "#{Color::BOLD}RECOMMENDATIONS:#{Color::RESET}"
-            puts "  1. Connect a key: #{Color.c('gsc connect ke', Color::CYAN, Color::BOLD)} (Get key at https://keywordseverywhere.com/)"
+            puts "  1. Connect a key: #{Color.c('gsc connect ke', Color::CYAN, Color::BOLD)} (Get key at https://keywordseverywhere.com/?fpr=us25sg)"
             puts "  2. Use 100% free Google Trends (No key needed!): #{Color.c("gsc trends \"#{target}\"", Color::BLUE, Color::BOLD)}"
             puts "  3. Use 500 free daily web lookups: Copy web table -> #{Color.c('gsc import clip', Color::GREEN, Color::BOLD)}\n"
           end
@@ -524,7 +524,7 @@ module GSC
                 { action: 'import_clipboard', cmd: 'gsc import clip', desc: 'Use 500 free daily web lookups on keywordseverywhere.com and import via clipboard' },
                 { action: 'google_trends', cmd: "gsc trends \"#{target}\"", desc: '100% Free real-time search interest & rising breakout queries' },
                 { action: 'gsc_analytics', cmd: 'gsc top-queries', desc: 'Real impressions & clicks from your active Google Search Console domain' },
-                { action: 'topup', url: 'https://keywordseverywhere.com/credit-packages.html', desc: 'Purchase API credits to enable automated background CLI lookups' }
+                { action: 'topup', url: 'https://keywordseverywhere.com/credit-packages.html?fpr=us25sg', desc: 'Purchase API credits to enable automated background CLI lookups' }
               ]
             })
             return
@@ -547,13 +547,13 @@ module GSC
             puts "     • High-impression queries and Page 2 striking-distance keywords:"
             puts "       #{Color.c('gsc top-queries', Color::MAGENTA, Color::BOLD)}  or  #{Color.c('gsc opportunities', Color::MAGENTA, Color::BOLD)}\n"
             puts "  4. #{Color.c('Top Up API Credits for Automated Background CLI Lookups', Color::GRAY, Color::BOLD)}"
-            puts "     • Purchase credits at: #{Color.c('https://keywordseverywhere.com/credit-packages.html', Color::UNDERLINE)}"
+            puts "     • Purchase credits at: #{Color.c('https://keywordseverywhere.com/credit-packages.html?fpr=us25sg', Color::UNDERLINE)}"
             puts "     • Your key is already saved; it will work immediately once credited.\n"
           elsif err_str =~ /401|Unauthorized/i
             puts Color.c("\n🔑 Invalid or Expired Keywords Everywhere API Key", Color::RED, Color::BOLD)
             puts "Your API key was rejected by api.keywordseverywhere.com (HTTP 401).\n\n"
             puts "#{Color::BOLD}RECOMMENDATIONS:#{Color::RESET}"
-            puts "  • Check or generate your API key at: #{Color.c('https://keywordseverywhere.com/first-install-addon.html', Color::UNDERLINE)}"
+            puts "  • Check or generate your API key at: #{Color.c('https://keywordseverywhere.com/first-install-addon.html?fpr=us25sg', Color::UNDERLINE)}"
             puts "  • Reconnect key: #{Color.c('gsc connect ke <KEY>', Color::CYAN, Color::BOLD)}"
             puts "  • Or use free Google Trends without any key: #{Color.c("gsc trends \"#{target}\"", Color::BLUE)}"
           elsif err_str =~ /429|Rate Limit/i

data/lib/gsc/cli_advanced.rb

@@ -170,13 +170,61 @@ module GSC
       puts "╚══════════════════════════════════════════════════════════════╝"
 
       m = data[:metrics] || {}
-      puts "\n#{Color::BOLD}📊 CORE WEB VITALS (Lab Metrics):#{Color::RESET}"
+      puts "\n#{Color::BOLD}🔬 LIGHTHOUSE LAB METRICS (Simulated #{strategy.upcase}):#{Color::RESET}"
       puts "   • LCP (Largest Contentful Paint) : #{Color.c(m[:lcp] || 'N/A', Color::BOLD)}"
       puts "   • FCP (First Contentful Paint)   : #{Color.c(m[:fcp] || 'N/A', Color::BOLD)}"
       puts "   • CLS (Cumulative Layout Shift)  : #{Color.c(m[:cls] || 'N/A', Color::BOLD)}"
       puts "   • TBT (Total Blocking Time)      : #{Color.c(m[:tbt] || 'N/A', Color::BOLD)}"
       puts "   • Speed Index                    : #{Color.c(m[:speed_index] || 'N/A', Color::BOLD)}"
 
+      fd = data[:field_data] || {}
+      if fd.any?
+        source_label = data[:field_source] == :origin ? "Domain-Wide Origin RUM" : "URL-Level RUM"
+        overall = data[:overall_category] || "UNKNOWN"
+        overall_col = overall == 'FAST' ? Color::GREEN : (overall == 'AVERAGE' ? Color::YELLOW : Color::RED)
+        puts "\n#{Color::BOLD}🌐 CrUX FIELD DATA (28-Day Real User Monitoring - #{source_label}):#{Color::RESET}"
+        puts "   • Core Web Vitals Status        : #{Color.c(overall, overall_col, Color::BOLD)}"
+
+        if fd['LARGEST_CONTENTFUL_PAINT_MS']
+          val = "#{(fd['LARGEST_CONTENTFUL_PAINT_MS'][:percentile].to_f / 1000).round(2)} s"
+          cat = fd['LARGEST_CONTENTFUL_PAINT_MS'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • LCP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+
+        if fd['INTERACTION_TO_NEXT_PAINT']
+          val = "#{fd['INTERACTION_TO_NEXT_PAINT'][:percentile]} ms"
+          cat = fd['INTERACTION_TO_NEXT_PAINT'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • INP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+
+        if fd['CUMULATIVE_LAYOUT_SHIFT_SCORE']
+          val = (fd['CUMULATIVE_LAYOUT_SHIFT_SCORE'][:percentile].to_f / 100).round(3).to_s
+          cat = fd['CUMULATIVE_LAYOUT_SHIFT_SCORE'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • CLS (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+
+        if fd['FIRST_CONTENTFUL_PAINT_MS']
+          val = "#{(fd['FIRST_CONTENTFUL_PAINT_MS'][:percentile].to_f / 1000).round(2)} s"
+          cat = fd['FIRST_CONTENTFUL_PAINT_MS'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • FCP (75th Percentile)         : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+
+        if fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE']
+          val = "#{fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE'][:percentile]} ms"
+          cat = fd['EXPERIMENTAL_TIME_TO_FIRST_BYTE'][:category]
+          col = cat == 'FAST' ? Color::GREEN : (cat == 'AVERAGE' ? Color::YELLOW : Color::RED)
+          puts "   • TTFB (75th Percentile)        : #{Color.c(val, Color::BOLD)} [#{Color.c(cat, col)}]"
+        end
+      else
+        puts "\n#{Color::BOLD}🌐 CrUX FIELD DATA (28-Day Real User Monitoring):#{Color::RESET}"
+        puts "   #{Color.c('ℹ️ Insufficient real-user Chrome visits over the rolling 28-day window for Google CrUX telemetry.', Color::GRAY)}"
+        puts "   #{Color.c('   (Google requires a minimum traffic threshold before publishing real-user CrUX field data).', Color::GRAY)}"
+      end
+
       opps = data[:opportunities] || []
       unless opps.empty?
         puts "\n#{Color::BOLD}💡 TOP SPEED OPPORTUNITIES:#{Color::RESET}"

data/lib/gsc/page_speed.rb

@@ -28,9 +28,9 @@ module GSC
 
       uri = URI("#{API_URL}?#{query_params.join('&')}")
       req = Net::HTTP::Get.new(uri)
-      req['User-Agent'] = 'gsc-cli/2.1'
+      req['User-Agent'] = "gsc-cli/#{GSC::VERSION}"
 
-      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true, open_timeout: 10, read_timeout: 30) do |http|
+      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true, open_timeout: 15, read_timeout: 60) do |http|
         http.request(req)
       end
 
@@ -64,16 +64,28 @@ module GSC
       tbt = audits.dig('total-blocking-time', 'displayValue')
       si  = audits.dig('speed-index', 'displayValue')
 
-      # CrUX Field Data (if available)
+      # CrUX Field Data (URL or Origin fallback if available)
       crux_metrics = {}
+      crux_source = nil
       crux = data.dig('loadingExperience', 'metrics') || {}
-      crux.each do |k, v|
-        crux_metrics[k] = {
-          percentile: v['percentile'],
-          category: v['category']
-        }
+      if crux && !crux.empty?
+        crux_source = :url
+      else
+        crux = data.dig('originLoadingExperience', 'metrics') || {}
+        crux_source = :origin unless crux.empty?
       end
 
+      if crux && !crux.empty?
+        crux.each do |k, v|
+          crux_metrics[k] = {
+            percentile: v['percentile'],
+            category: v['category']
+          }
+        end
+      end
+
+      overall_category = data.dig('loadingExperience', 'overall_category') || data.dig('originLoadingExperience', 'overall_category')
+
       # Opportunities
       opportunities = []
       audits.each do |k, v|
@@ -103,6 +115,8 @@ module GSC
           speed_index: si
         },
         field_data: crux_metrics,
+        field_source: crux_source,
+        overall_category: overall_category,
         opportunities: opportunities.first(5)
       }
     end

data/lib/gsc/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GSC
-  VERSION = '2.2.0'
+  VERSION = '2.2.3'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gsc-cli
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.2.3
 platform: ruby
 authors:
 - ApollosWave LLC