Skip to content

Latest commit

 

History

History
106 lines (70 loc) · 2.96 KB

README.md

File metadata and controls

106 lines (70 loc) · 2.96 KB

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