| Name | dumpdork JSON |
| Version |
0.1.4.post1
JSON |
| download |
| home_page | https://github.com/mateofumis/dumpdork |
| Summary | A powerful command-line tool for Google dorking, enabling users to uncover hidden information and vulnerabilities with advanced search queries. |
| upload_time | 2024-08-31 17:09:35 |
| maintainer | None |
| docs_url | None |
| author | Mateo Fumis |
| requires_python | >=3.6 |
| license | None |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# 🔍 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.
## 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:
```bash
git clone https://github.com/mateofumis/dumpdork.git
cd dumpdork
```
2. Set up a virtual environment (optional but recommended):
```bash
python3 -m venv env
source env/bin/activate # On Windows use `.\env\Scripts\activate`
```
3. Install dependencies:
```bash
pip3 install -r requirements.txt
```
### Using pip install
1. Install dumpdork with pip3
```bash
pip3 install dumpdork
```
See this project in PyPi: [https://pypi.org/project/dumpdork/](https://pypi.org/project/dumpdork/)
## Configure your API credentials:
Create config.yaml file in `~/.config/dumpdork/config.yaml` with the following structure:
```yaml
rapidapi:
host: google-search74.p.rapidapi.com
key: "YOUR_RAPIDAPI_KEY"
```
### How to get your credentials
1. Visit [https://rapidapi.com/auth/login/](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](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
```bash
$: 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:
```bash
python3 dumpdork.py 'site:"*.hackerone.com" ext:php' --output h1_results.json --limit 100 --config-file config.yaml
```
- Find login pages:
```bash
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! 🧡
[](https://ko-fi.com/hackermater)
Raw data
{
"_id": null,
"home_page": "https://github.com/mateofumis/dumpdork",
"name": "dumpdork",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": null,
"author": "Mateo Fumis",
"author_email": "mateofumis1@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/21/6a/d6605847c29af091bf585920a1baaef17d80db7127532acd964d3d002a67/dumpdork-0.1.4.post1.tar.gz",
"platform": null,
"description": "# \ud83d\udd0d DumpDork\n\nDumpDork 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.\n\n\n\n## Features\n\n- **Effortless Querying**: Construct complex search queries with ease using Google's powerful search operators.\n- **Customizable Results**: Specify the number of results to retrieve, with a maximum limit of 300.\n- **Output Options**: Save your findings in a neatly formatted JSON file for further analysis or reporting.\n- **No CAPTCHA Required**: This script does not require users to complete CAPTCHA, making it easier to retrieve results without interruptions.\n- **Configurable Credentials**: Manage your API credentials securely through a simple YAML configuration file.\n- **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.\n\n## Installation\n\n### Manual:\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/mateofumis/dumpdork.git\ncd dumpdork\n```\n\n2. Set up a virtual environment (optional but recommended):\n\n```bash\npython3 -m venv env\nsource env/bin/activate # On Windows use `.\\env\\Scripts\\activate`\n```\n\n3. Install dependencies:\n\n```bash\npip3 install -r requirements.txt\n```\n\n### Using pip install\n\n1. Install dumpdork with pip3\n\n```bash\npip3 install dumpdork\n```\n\nSee this project in PyPi: [https://pypi.org/project/dumpdork/](https://pypi.org/project/dumpdork/) \n\n## Configure your API credentials:\n\nCreate config.yaml file in `~/.config/dumpdork/config.yaml` with the following structure:\n\n```yaml\nrapidapi:\n host: google-search74.p.rapidapi.com\n key: \"YOUR_RAPIDAPI_KEY\"\n```\n\n### How to get your credentials\n\n1. Visit [https://rapidapi.com/auth/login/](https://rapidapi.com/auth/login/) and create an account or sign in.\n2. Once logged in, visit [https://rapidapi.com/herosAPI/api/google-search74/playground](https://rapidapi.com/herosAPI/api/google-search74/playground) and claim your FREE API credentials.\n3. Done! Now you can fill your `config.yaml` with your own credentials.\n\n## Usage\n\n```bash\n$: dumpdork -h\nusage: dumpdork.py [-h] [--limit LIMIT] [--output OUTPUT] [--config-file CONFIG_FILE] [--wizard] [query]\n\nPerform a search using RapidAPI.\n\npositional arguments:\n query The search query.\n\noptions:\n -h, --help show this help message and exit\n --limit LIMIT Number of results to return (default is 50. Limit: 300).\n --output OUTPUT Output file to save results in JSON format.\n --config-file CONFIG_FILE\n Path to the YAML config file containing API credentials.\n --wizard Set up your API key for dumpdork, step by step with easy.\n```\n\nExample Queries\n\n- Search for PHP files on HackerOne:\n\n```bash\npython3 dumpdork.py 'site:\"*.hackerone.com\" ext:php' --output h1_results.json --limit 100 --config-file config.yaml\n```\n\n- Find login pages:\n\n```bash\npython3 dumpdork.py 'inurl:login (ext:php | ext:asp | ext:aspx | ext:aspxh)' --output juicy_results.json --config-file config.yaml\n```\n\n## License\n\nThis project is licensed under the Apache License 2.0 - see the LICENSE file for details.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a pull request or open an issue.\n\n## \ud83e\udde1 Support me with a virtual Coffee! \ud83e\udde1\n\n[](https://ko-fi.com/hackermater)\n",
"bugtrack_url": null,
"license": null,
"summary": "A powerful command-line tool for Google dorking, enabling users to uncover hidden information and vulnerabilities with advanced search queries.",
"version": "0.1.4.post1",
"project_urls": {
"Homepage": "https://github.com/mateofumis/dumpdork"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e9f10c8ea87e2866aa5060e14788b9f791c3d1cd97cb537f40192ce126358f0b",
"md5": "c2ac08dae4c5d197981caeca975006ab",
"sha256": "846ac4c04a3967594e8c0f6f277b0134e9c2bfc18a765d52f1889df34a4311eb"
},
"downloads": -1,
"filename": "dumpdork-0.1.4.post1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c2ac08dae4c5d197981caeca975006ab",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 9511,
"upload_time": "2024-08-31T17:09:33",
"upload_time_iso_8601": "2024-08-31T17:09:33.994021Z",
"url": "https://files.pythonhosted.org/packages/e9/f1/0c8ea87e2866aa5060e14788b9f791c3d1cd97cb537f40192ce126358f0b/dumpdork-0.1.4.post1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "216ad6605847c29af091bf585920a1baaef17d80db7127532acd964d3d002a67",
"md5": "eb4f12372e6c9c7d8288cab8ca888ae9",
"sha256": "92900715fcdc472c2002865595e824652c61149c080fee8024bb62edff6e3815"
},
"downloads": -1,
"filename": "dumpdork-0.1.4.post1.tar.gz",
"has_sig": false,
"md5_digest": "eb4f12372e6c9c7d8288cab8ca888ae9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 365687,
"upload_time": "2024-08-31T17:09:35",
"upload_time_iso_8601": "2024-08-31T17:09:35.751640Z",
"url": "https://files.pythonhosted.org/packages/21/6a/d6605847c29af091bf585920a1baaef17d80db7127532acd964d3d002a67/dumpdork-0.1.4.post1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-31 17:09:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mateofumis",
"github_project": "dumpdork",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "dumpdork"
}
