ruby-google-suggest 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f317efd0be419a1086b809c04c46b70920a3f0341dc7d41776c1397e8e597e12
+  data.tar.gz: df32e30b26709f6b6f7d6a73395ebe5ca1e4e67f80a88fd3efc8998ca3d6171f
+SHA512:
+  metadata.gz: ec12f9219997236d795193cc42b5ad9739abac02d7a04e8b3edb9da72dca83160eaf54add848d8bdcdcd7118bf18ca248040f68b921f9652802c93ceb0dbe07c
+  data.tar.gz: 46d44e4ccbb79eab7a70d15fc5752e41949e9c6eed78eed872b80cbb97f91b03507bbe6297a02d05aecee68d3ded576b037f57f8aa401bf707515a971e7b3cfb

data/lib/ruby-google-suggest.rb

@@ -0,0 +1,90 @@
+require 'httparty'
+require 'nokogiri'
+require 'pry-byebug'
+
+# Keywords that allow a deeper search
+ALPHA = ("a".."z")
+
+# Keywords that indicate that people are trying to learn more about the good or service
+QUESTIONS = ["are", "what", "how", "where", "is", "who", "alternatives"]
+
+# Keywords that indicate that people are trying to consider goods or services
+# Excluded "and" because it does not generate useful results
+CONSIDERATIONS = ["features", "benefits", "price", "on", "for", "near", "at", "versus", "vs", "compare"]
+
+# Keywords that indicate that people are about to buy goods or services
+DO = ["buy", "sale", "service", "consulting", "consulting", "discount", "promotion", "buy"]
+
+
+module GoogleSuggest
+
+  # Deep search
+  def suggest_deep(query, country, language, negative_keywords)
+    deep_keywords = []
+    ALPHA.each do |letter|
+      puts "looking at '#{letter}' variations"
+      deep_keywords << suggest(query + " #{letter}", country, language, negative_keywords)
+    end
+    deep_keywords.flatten.uniq
+  end
+
+  # Search using question keywords
+  def suggest_with_questions(query, country, language, negative_keywords)
+    questions_keywords = []
+    QUESTIONS.each do |question|
+      puts "looking at '#{question}' variations"
+      questions_keywords << suggest(query + " #{question}", country, language, negative_keywords)
+    end
+    questions_keywords.flatten.uniq
+  end
+
+  # Search using consideration keywords
+  def suggest_with_considerations(query, country, language, negative_keywords)
+    considerations_keywords = []
+    CONSIDERATIONS.each do |consideration|
+      puts "looking at '#{consideration}' variations"
+      considerations_keywords << suggest(query + " #{consideration}", country, language, negative_keywords)
+    end
+    considerations_keywords.flatten.uniq
+  end
+
+  # Search using purchase / call-to-action keywords
+  def suggest_with_action(query, country, language, negative_keywords)
+    do_keywords = []
+    DO.each do |do_keyword|
+      puts "looking at '#{do_keyword}' variations"
+      do_keywords << suggest(query + " #{do_keyword}", country, language, negative_keywords)
+    end
+    do_keywords.flatten.uniq
+  end
+
+  # Main search function 
+  def suggest(query, country, language, negative_keywords=[])
+    base_keywords = []
+    final_keywords = []
+
+    response = HTTParty.get("http://suggestqueries.google.com/complete/search?&output=toolbar&hl=#{language}&q=#{query}&gl=#{country}")
+    doc = Nokogiri::XML(response.body)
+    
+    seed_keywords = doc.xpath("//suggestion").map { |xml| xml["data"]}
+    
+    seed_keywords.each do |seed_keyword|
+      response = HTTParty.get("http://suggestqueries.google.com/complete/search?&output=toolbar&hl=#{language}&q=#{seed_keyword}&gl=#{country}")
+      doc = Nokogiri::XML(response.body)
+      base_keywords << doc.xpath("//suggestion").map { |xml| xml["data"]}
+    end
+
+    final_keywords = base_keywords.flatten.uniq.reject do |base_keyword|
+      states = []
+      negative_keywords.each do |negative_keyword|
+        states << base_keyword.include?(negative_keyword)
+      end
+      states.any?(true)
+    end
+
+    final_keywords
+  end
+
+end
+
+extend GoogleSuggest

metadata

@@ -0,0 +1,43 @@
+--- !ruby/object:Gem::Specification
+name: ruby-google-suggest
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Kenn Costales
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2020-10-20 00:00:00.000000000 Z
+dependencies: []
+description: Uses the Google Suggest API to generate keywords
+email: fxkennyfrc@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ruby-google-suggest.rb
+homepage: https://rubygems.org/gems/ruby-google-suggest
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.1
+signing_key:
+specification_version: 4
+summary: Google Suggest API Wrapper
+test_files: []