Metadata-Version: 2.4
Name: godork
Version: 2.5.2
Summary: Advanced & Fast Google Dorking Tool
Home-page: https://github.com/thd3r/godork
Author: Thunder (@thd3r)
Author-email: thd3r@proton.me
License: MIT
Keywords: godork,google dorks,google dorking
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: bs4
Requires-Dist: rich
Requires-Dist: pydub
Requires-Dist: aiohttp
Requires-Dist: asyncio
Requires-Dist: selenium
Requires-Dist: SpeechRecognition
Requires-Dist: webdriver-manager
Requires-Dist: undetected-chromedriver
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary

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

<div align="left">
  <a href="https://python.org"><img src="https://img.shields.io/badge/Built%20with-Python-Blue"></a>
  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-_red.svg"></a>
  <a href="https://github.com/thd3r/godork/releases"><img src="https://img.shields.io/github/release/thd3r/godork.svg"></a>
  <a href="https://pypi.python.org/pypi/godork/"><img src="https://img.shields.io/pypi/v/godork.svg"></a>
  <a href="https://github.com/thd3r/godork/issues?q=is%3Aissue+is%3Aclosed"><img src="https://img.shields.io/github/issues-closed-raw/thd3r/godork?color=dark-green&label=issues%20fixed"></a>
</div>

```sh
                __         __  
  ___ ____  ___/ /__  ____/ /__
 / _ `/ _ \/ _  / _ \/ __/  '_/  v2.5.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

* 🔄 Self-updating via --update-tool flag and never run outdated tools again

* 🐳 Docker-compatible: Seamlessly containerize and deploy in any environment

## Resources
- [Requirements](#requirements)
- [Installation](#installation)
	- [Install with pip](#install-with-pip)
	- [Or clone from GitHub](#or-clone-from-github)
- [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
```

### Or clone from GitHub:

```sh
git clone https://github.com/thd3r/godork.git
cd codork
python3 setup.py install
```

## 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) |
| --debug           | Boolean      | show detailed logs and error for debugging |
| --retries         | Integer      | retries when request is blocked (default: 40) |
| --max-retries     | Integer      | max attempts to bypass protection mechanisms (default: 2) |
| --no-headless     | Boolean      | run in graphical mode when bypassing |
| --update-tool     | Boolean      | update godork to the latest version  |

## 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:

<p align="left">
<a href="https://github.com/societyprojects"><img src="https://avatars.githubusercontent.com/u/181974230?s=400&v=4" width="50" height="50" alt="" style="max-width: 100%;"></a>
</p>

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

<a href="https://www.buymeacoffee.com/thd3r" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
