godork

KO | EN

gitlite — search

#python #hacktoberfest #android #javascript #website #react #ios #nodejs #typescript #covid-19 #php #vue

★ 27 Open GitHub ↗

Advanced & Fast Google Dorking Tool

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="left">
  Godork - Advanced & Fast Google Dorking Tool
</h1>

```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

godork

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README