Skip to main content

A powerful command-line tool for Google dorking, enabling users to uncover hidden information and vulnerabilities with advanced search queries.

Project description

🔍 DumpDork

DumpDork is a powerful command-line tool for performing Google dorking, allowing users to uncover hidden information and vulnerabilities using advanced search queries directly from the terminal.

preview

Features

  • Effortless Querying: Construct complex search queries with ease using Google's powerful search operators.
  • Customizable Results: Specify the number of results to retrieve, with a maximum limit of 300.
  • Output Options: Save your findings in a neatly formatted JSON file for further analysis or reporting.
  • No CAPTCHA Required: This script does not require users to complete CAPTCHA, making it easier to retrieve results without interruptions.
  • Configurable Credentials: Manage your API credentials securely through a simple YAML configuration file.
  • Interactive Setup Wizard: With an user-friendly wizard which guides you through the setup process, helping you configure your API credentials settings step-by-step.

Installation

Manual:

  1. Clone the repository:
git clone https://github.com/mateofumis/dumpdork.git
cd dumpdork
  1. Set up a virtual environment (optional but recommended):
python3 -m venv env
source env/bin/activate  # On Windows use `.\env\Scripts\activate`
  1. Install dependencies:
pip3 install -r requirements.txt

Using pip install

  1. Install dumpdork with pip3
pip3 install dumpdork

See this project in PyPi: https://pypi.org/project/dumpdork/

Configure your API credentials:

Create config.yaml file in ~/.config/dumpdork/config.yaml with the following structure:

rapidapi:
  host: google-search74.p.rapidapi.com
  key: "YOUR_RAPIDAPI_KEY"

How to get your credentials

  1. Visit https://rapidapi.com/auth/login/ and create an account or sign in.
  2. Once logged in, visit https://rapidapi.com/herosAPI/api/google-search74/playground and claim your FREE API credentials.
  3. Done! Now you can fill your config.yaml with your own credentials.

Usage

$: dumpdork -h
usage: dumpdork.py [-h] [--limit LIMIT] [--output OUTPUT] [--config-file CONFIG_FILE] [--wizard] [query]

Perform a search using RapidAPI.

positional arguments:
  query                 The search query.

options:
  -h, --help            show this help message and exit
  --limit LIMIT         Number of results to return (default is 50. Limit: 300).
  --output OUTPUT       Output file to save results in JSON format.
  --config-file CONFIG_FILE
                        Path to the YAML config file containing API credentials.
  --wizard              Set up your API key for dumpdork, step by step with easy.

Example Queries

  • Search for PHP files on HackerOne:
python3 dumpdork.py 'site:"*.hackerone.com" ext:php' --output h1_results.json --limit 100 --config-file config.yaml
  • Find login pages:
python3 dumpdork.py 'inurl:login (ext:php | ext:asp | ext:aspx | ext:aspxh)' --output juicy_results.json --config-file config.yaml

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue.

🧡 Support me with a virtual Coffee! 🧡

Ko-Fi

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dumpdork-0.1.4.tar.gz (365.7 kB view details)

Uploaded Source

Built Distribution

dumpdork-0.1.4-py3-none-any.whl (9.5 kB view details)

Uploaded Python 3

File details

Details for the file dumpdork-0.1.4.tar.gz.

File metadata

  • Download URL: dumpdork-0.1.4.tar.gz
  • Upload date:
  • Size: 365.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.9

File hashes

Hashes for dumpdork-0.1.4.tar.gz
Algorithm Hash digest
SHA256 97f3f236aec1a4b62d8dc6ae71e7234e9af3db64c17abc67ced4d493156f6276
MD5 1d0fa1d3e65f6f426a5c79bb2dad6086
BLAKE2b-256 0bbcbedb8e5705bc68bdc5b2d6e5f733d362d43ea0cee61df5ee89caee9c9a8d

See more details on using hashes here.

File details

Details for the file dumpdork-0.1.4-py3-none-any.whl.

File metadata

  • Download URL: dumpdork-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 9.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.9

File hashes

Hashes for dumpdork-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 f912106296d2bf8f7e1c528dc134e5d620506c416474cd8db9bd58f64745410a
MD5 d6fbf89e5f9fd378682613e125347e5c
BLAKE2b-256 fc11d8b4e34512b6ac482e61e8527f683b635319064d4f24cbdde8cc69b51e29

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page