Skip to content

A custom Google search (to bypass some limitations on google and VPNs)

Notifications You must be signed in to change notification settings

AssassinUKG/googleSearcher

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

47 Commits
 
 
 
 
 
 

Repository files navigation

googleSearcher

A custom Google search (to bypass some limitations on Google with regards to timeouts, vpns etc)

The tool has been coded to only return 100 (max) URLs from google search. Google only allows 100 results. You can get 100 from pages 1-10 or pages 11-20 etc, but only ever 100 max results at a time.
A Limitation imposed by Google.

WARNING you will quickly hit the Google limit and will need a paid account to get more. Script has been edited to allow number choice 1-100 results

Great for OSINT and Google Dorks!

Install

git clone https://github.com/AssassinUKG/googleSearcher.git
cd googleSearcher
pip install -r requirements.txt

cd gSearcher
python3 gsearcher.py

Usage

python3 gsearcher.py -s "filetype:pdf site:tesla.com"
python3 gsearcher.py -s "cats" -p 4 
python3 gsearcher.py -s "dogs" -n 30 -p 3

Options

usage: gSearch.py [-h] [-s SEARCHTERM] [-n NUMRESULTS] [-p PAGE]

options:
  -h, --help            show this help message and exit
  -s SEARCHTERM, --searchTerm SEARCHTERM
                        Enter a search term!
  -n NUMRESULTS, --numResults NUMRESULTS
                        Enter the number of results to fetch (max 100)
  -p PAGE, --page PAGE  Enter the page number

Screenshots

filetype dork (pdf) image

image

** Update: 04/07/2023: Added option for number of results to help free users ** image


Setup (Google stuffs)

You will need a...

  • GOOGLE API Key
  • GOOGLE CUSTOM SEARCH ENGINE ID

Google API Key

Link: https://console.cloud.google.com/ To create your application's API key:

Create a new key:

  1. Open the Google API Console.
  2. Create or select a project.
  3. On the Credentials page, get an existing API key or create a new one (Create credentials > API key). You can restrict the key before using it in production by clicking Restrict key.

Protect your API key by changing the restrictions to only search API or whatever you need.

Google CSE (Custom Search Engine)

  1. Goto https://programmablesearchengine.google.com/controlpanel/all
  2. Add a new search engine and hit save after (see image for settings) image
  3. Get your search engine ID
    image

Now in the gsearcher.py file replace the variables with your key and cse id.

my_api_key = "Your GOOGLE API KEY"
my_cse_id = "YOU Custom Search Engine ID"

Now you're ready to get results!

Changelog

Update: 04/07/2023:

Added option for number of results to help free users

About

A custom Google search (to bypass some limitations on google and VPNs)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages