https://github.com/thd3r/godork
Scrape results from google search quickly
https://github.com/thd3r/godork
dorking godork google-dorking google-dorks infosec osint osint-tool python scratch security
Last synced: 3 months ago
JSON representation
Scrape results from google search quickly
- Host: GitHub
- URL: https://github.com/thd3r/godork
- Owner: thd3r
- License: mit
- Created: 2023-05-30T10:59:19.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-26T09:43:44.000Z (11 months ago)
- Last Synced: 2024-11-26T10:55:41.548Z (11 months ago)
- Topics: dorking, godork, google-dorking, google-dorks, infosec, osint, osint-tool, python, scratch, security
- Language: Python
- Homepage: https://pypi.org/project/godork/
- Size: 1.85 MB
- Stars: 16
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Godork - Advanced & Fast Google Dorking Tool
```sh
__ __
___ ____ ___/ /__ ____/ /__
/ _ `/ _ \/ _ / _ \/ __/ '_/ v2.6.2
\_, /\___/\_,_/\___/_/ /_/\_\ latest
/___/
thd3r & societyprojects
```
**Godork** is a high-performance tool designed to scrape links and titles from Google search results using the [asyncio](https://docs.python.org/3/library/asyncio.html) library, which enables efficient cooperative multitasking. Combined with [aiohttp](https://docs.aiohttp.org), this tool allows you to quickly and reliably extract URLs along with their corresponding titles. Additionally, Godork is capable of bypassing restrictions imposed by network providers, ensuring uninterrupted access to search data
## ✨ Why Godork?
* ⚡ Blazing-fast performance using asynchronous HTTP requests (aiohttp)
* 🔍 Automated dork execution with support for lists, batches, and single queries
* 🌐 Proxy-ready: Bypass restrictions and stay anonymous with HTTP proxy integration
* 🕶️ Headless browser mode with Selenium to defeat CAPTCHAs and JS-based blocks
* 🐳 Docker-compatible: Seamlessly containerize and deploy in any environment
## Resources
- [Requirements](#requirements)
- [Installation](#installation)
- [Install with pip](#install-with-pip)
- [Options](#options)
- [Example Usage](#example-usage)
- [Basic dorking](#basic-dorking)
- [Batch mode](#batch-mode)
- [Help & Bugs](#help--bugs)
- [Contributors](#contributors-heart)
- [License](#license)
- [Support](#support)
## Requirements
```sh
# This is required for the pydub library
$ sudo apt install ffmpeg
# Check the version of the google-chrome browser
$ google-chrome --version
# If the browser version does not exist run this command
$ wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
$ sudo apt -f install
$ sudo dpkg -i google-chrome-stable_current_amd64.deb
# After that, take the version from your google-chrome browser and place it here
$ wget https://storage.googleapis.com/chrome-for-testing-public/{PUT_THAT_VERSION_HERE}/linux64/chromedriver-linux64.zip
$ unzip chromedriver-linux64.zip
$ cd chromedriver-linux64
$ sudo mv chromedriver /usr/bin
```
## Installation
**Godork** requires **python 3.8** or higher to install successfully
### Install with pip:
```sh
pip install godork
```
## Options
| Option | Type | Description |
|-------------------|--------------|------------------------------------------------|
| -v, --version | flag | displays the current version of godork |
| -d, --dorks | string | single dork or file containing multiple dorks |
| -p, --proxy | string | http proxy to use with godork (e.g. http://127.0.0.1:8080) |
| --retries | integer | retries when request is blocked (default: 40) |
| --max-retries | integer | max attempts to bypass protection mechanisms (default: 2) |
| --debug | boolean | show detailed logs and error for debugging |
| --no-headless | boolean | run in graphical mode when bypassing |
## Example Usage
### Basic dorking:
```sh
godork --dorks "intitle:index.of site:example.com"
```
> [!WARNING]
> Developers assume no liability and are not responsible for any issue or damage.
### Batch mode:
```sh
godork --dorks dorks.txt --proxy http://127.0.0.1:8080 --no-headless
```
## Help & Bugs
If you are still confused or found a bug, please [open the issue](https://github.com/thd3r/godork/issues). All bug reports are appreciated, some features have not been tested yet due to lack of free time.
## Contributors :heart:
## License
Licensed under the [MIT License](https://github.com/thd3r/godork/blob/main/LICENSE.md).
Contributions are welcome :) feel free to fork, suggest improvements, or submit pull requests.
## Support
