https://github.com/tuladhar/multi-threaded-google-ban-checker
Multi-threaded Google Ban Checker
https://github.com/tuladhar/multi-threaded-google-ban-checker
google hacktoberfest multi-threading proxies
Last synced: about 1 year ago
JSON representation
Multi-threaded Google Ban Checker
- Host: GitHub
- URL: https://github.com/tuladhar/multi-threaded-google-ban-checker
- Owner: tuladhar
- License: mit
- Created: 2016-09-24T11:11:14.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2020-10-22T04:33:56.000Z (over 5 years ago)
- Last Synced: 2025-03-29T06:11:19.825Z (about 1 year ago)
- Topics: google, hacktoberfest, multi-threading, proxies
- Language: Python
- Homepage:
- Size: 39.1 KB
- Stars: 2
- Watchers: 2
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Multi-threaded Google Ban Checker
[](https://github.com/tuladhar/multi-threaded-google-ban-checker/blob/main/Contributors.md)
[](https://github.com/tuladhar/multi-threaded-google-ban-checker/issues)
[](https://github.com/tuladhar/multi-threaded-google-ban-checker/pulls)
[](https://github.com/tuladhar/multi-threaded-google-ban-checker/commits/main)
[](https://github.com/tuladhar/multi-threaded-google-ban-checker/stargazers)
[](https://github.com/tuladhar/multi-threaded-google-ban-checker/network/members)
[](https://github.com/tuladhar/multi-threaded-google-ban-checker/watchers)
[](https://github.com/tuladhar/multi-threaded-google-ban-checker/blob/main/LICENSE)
NOTE:
This is not a Google account, domain or advertisements ban checker
## Table of Contents
* [Installation](#Installation)
* [How it works](#How it works?)
* [Contributing](#Contributing)
* [Author](#Author)
* [Contributors](#Contributors)
**Usage: main.py [options]**
| Options | Description |
| ------------ | ------------ |
| -d, --debug | Print debug information |
| -n NUM, --threads NUM | set maximum number of threads to use (default: 100) |
| -%, --show-progress-status | show realtime progress status and a tabular result at the end |
| -R, --realtime | show realtime results in csv format |
# Installation
```shell
$ pip install prettytable requests
$ git clone https://github.com/tuladhar/multi-threaded-google-ban-checker
$ cat PROXIES.txt | python main.py --realtime
```
#### `PROXIES.txt` should be in following format (one proxy per line):
**NOTE:**
- Only one unique account can be searched at a time
```markdown
username:password@proxy1:port
username:password@proxy2:port
...
```
#### Google Keywords and User Agents used by the script:
- `helper/keywords.txt`
- `helper/useragents.txt`
**NOTE:**
- Please make sure your username and password exist here before using this
- Please update these files as needed.
- Always update the files before using this
How it works?
-------------
1. List of proxies (one per line) are read from standard input in following format and randomize internally by the script:
```markdown
username:password@proxy1:port
username:password@proxy2:port
...
```
2. `X` number of worker threads are created (see `--threads` option)
3. Proxies are distributed among pool of available threads and each thread does the following:
1. Each proxy makes 3 requests, retrieving default 10 page per request.
2. First page is requested as normal
3. Google ban is checked (50x), and if not banned then thread waits 40 seconds before using the proxy for another request
4. After 40 seconds wait, second page is requested by adding `&start=10` to query string
5. Repeats step iii.
6. After 40 seconds wait, third page is requested by adding `&start=20` to query string
7. Finally thread returns with result.
## Contributing: Getting Started
* Fork this repository (Click the Form button, top right of this page)
* Clone your fork down to your local machine
```markdown
git clone https://github.com/your-username/multi-threaded-google-ban-checker.git
```
* Comment to the Issue you want to work on - so I can assign you to it OR create a new Issue from a LeetCode Problem that is not implemented yet
* Create a branch for a new feature
```markdown
git checkout -b feature/branch-name
```
* Or if its a bugfix to a file
```markdown
git checkout -b bugfix/branch-name
```
* Make your changes (choose from the Tasks above!)
* Commit and Push
```markdown
git add .
git commit -m 'commit message'
git push origin branch-name
```
* Create a New Pull Request from your forked repository ( Click the 'New Pull Request' Button located at the top of your repo)
* Wait for your PR review and merge approval!
* __Star this repository__ if you had fun!
**NOTE:**
- If ban is detected at any stage no further requests will be made.
- You will be notified once a ban is detected
- Based on progress option used (see `--help` option), console is updated and results are displayed as soon as they're available
- Please update these files as needed.
- Always update the files before using this
.
## Author
- [Puru Tuladhar](github.com/tuladhar)
## Contributors
- See [Contributors.md](Contributors.md)