Dork-cli Command-line Google Dork Tool
dork-cli performs searches against a Google custom search engine and returns a list of all the unique page results it finds, optionally filtered by a set of dynamic page extensions.
Any number of additional query terms / dorks can be specified. dork-cli was designed to be piped into an external tool such as a vulnerability scanner for automated testing purposes.
Setup
In order to use this program you need to configure at a minimum two settings: a Google API key and a custom search engine id.Custom Search Engine:
- Create a custom search engine via https://www.google.com/cse/
- Add your desired domain(s) under "Sites to search"
- Click "Search engine ID" button to reveal the id, or grab it from the "cx" url paramter
API key:
- Open the Google API console at https://code.google.com/apis/console
- Enable the Custom Search API via APIs & auth > APIs
- Create a new API key via APIs & auth > Credentials > Create new Key
- Select "Browser key", leave HTTP Referer blank and click Create
Usage
$ ./dork-cli.py -husage: dork-cli.py [-h] [-e ENGINE] [-f [FILETYPES]] [-k KEY] [-m MAX_QUERIES]
[-s SLEEP]
[T [T ...]]
Find dynamic pages via Google dorks.
positional arguments:
T additional search term
optional arguments:
-h, --help show this help message and exit
-e ENGINE, --engine ENGINE
Google custom search engine id (cx value)
-f [FILETYPES], --filetypes [FILETYPES]
File extensions to return (if present but no
extensions specified, builtin dynamic list is used)
-k KEY, --key KEY Google API key
-m MAX_QUERIES, --max-queries MAX_QUERIES
Maximum number of queries to issue
-s SLEEP, --sleep SLEEP
Seconds to sleep before retry if daily API limit is
reached (0=disable)
Examples:
- NOTE: including -f/--filetypes without an argument, e.g. followed by --, defaults to filtering by a builtin list of dynamic file extensions.
$ ./dork-cli.py inurl:login
https://www.example.com/usher/Login.aspx
https://www.example.com/login/
http://www.example.com/rooms/index.php?option=com_user&view=login&Itemid=8
http://www.example.com/index.php?cmd=login
[...]
$ ./dork-cli.py --filetypes -- inurl:id
http://www.example.com/its/sla/sla.php?id=1617
http://www.example.com/bbucks/index.php?site=5&scode=0&id=720
http://www.example.com/directory/details.aspx?id=33
http://www.example.com/SitePages/VOIP%20ID.aspx
http://www.example.com/personnel_ext.php?id=44
http://www.example.com/its/alerts/event.php?id=7220
[...]
$ ./dork-cli.py --filetypes=php,aspx intitle:login inurl:admin
https://www.example.com/users/lab/admin/portal.php
https://www.example.com/admin/start/login.aspx?ReturnUrl=%2Fadmin%2Fscheduling%2Faudit%2Fdefault.aspx
http://www.example.com/admin/admin.php
[...]
API Limitations
The free Google API limits you to 100 searches per day, with a maximum of 10 results per search. This means if you configure dork-cli.py to return 100 results, it will issue 10 queries (1/10th of your daily limit) each time it is run.
You have the option to pay for additional searches via the Google API console. At the time of writing, signing up for billing on the Google API site gets you $300 free to spend on API calls for 60 days.
Download
0 comments:
Post a Comment
Note: only a member of this blog may post a comment.