{"id":17676818,"url":"https://github.com/tuladhar/multi-threaded-google-ban-checker","last_synced_at":"2025-04-17T12:45:52.259Z","repository":{"id":166960879,"uuid":"69097497","full_name":"tuladhar/multi-threaded-google-ban-checker","owner":"tuladhar","description":"Multi-threaded Google Ban Checker","archived":false,"fork":false,"pushed_at":"2020-10-22T04:33:56.000Z","size":40,"stargazers_count":2,"open_issues_count":2,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-29T06:11:19.825Z","etag":null,"topics":["google","hacktoberfest","multi-threading","proxies"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tuladhar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-09-24T11:11:14.000Z","updated_at":"2020-10-22T04:33:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"bbef7c65-a586-4189-a29b-a5d40f24f3b8","html_url":"https://github.com/tuladhar/multi-threaded-google-ban-checker","commit_stats":null,"previous_names":["tuladhar/multi-threaded-google-ban-checker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuladhar%2Fmulti-threaded-google-ban-checker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuladhar%2Fmulti-threaded-google-ban-checker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuladhar%2Fmulti-threaded-google-ban-checker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tuladhar%2Fmulti-threaded-google-ban-checker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tuladhar","download_url":"https://codeload.github.com/tuladhar/multi-threaded-google-ban-checker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249342229,"owners_count":21254251,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["google","hacktoberfest","multi-threading","proxies"],"created_at":"2024-10-24T07:26:50.404Z","updated_at":"2025-04-17T12:45:52.241Z","avatar_url":"https://github.com/tuladhar.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Multi-threaded Google  Ban Checker\n\n\n[![Contributors](https://img.shields.io/github/contributors/tuladhar/multi-threaded-google-ban-checker)](https://github.com/tuladhar/multi-threaded-google-ban-checker/blob/main/Contributors.md)\n[![Issues](https://img.shields.io/github/issues/tuladhar/multi-threaded-google-ban-checker)](https://github.com/tuladhar/multi-threaded-google-ban-checker/issues)\n[![Open Pull Requests](https://img.shields.io/github/issues-pr-raw/tuladhar/multi-threaded-google-ban-checker)](https://github.com/tuladhar/multi-threaded-google-ban-checker/pulls)\n[![Last Commit](https://img.shields.io/github/last-commit/tuladhar/multi-threaded-google-ban-checker)](https://github.com/tuladhar/multi-threaded-google-ban-checker/commits/main)\n[![Stars](https://img.shields.io/github/stars/tuladhar/multi-threaded-google-ban-checker)](https://github.com/tuladhar/multi-threaded-google-ban-checker/stargazers)\n[![Forks](https://img.shields.io/github/forks/tuladhar/multi-threaded-google-ban-checker)](https://github.com/tuladhar/multi-threaded-google-ban-checker/network/members)\n[![Watchers](https://img.shields.io/github/watchers/tuladhar/multi-threaded-google-ban-checker)](https://github.com/tuladhar/multi-threaded-google-ban-checker/watchers)\n[![License](https://img.shields.io/github/license/tuladhar/multi-threaded-google-ban-checker)](https://github.com/tuladhar/multi-threaded-google-ban-checker/blob/main/LICENSE)\n\nNOTE:\nThis is not a Google account, domain or advertisements ban checker\n\n## Table of Contents\n* [Installation](#Installation)\n* [How it works](#How it works?)\n* [Contributing](#Contributing)\n* [Author](#Author)\n* [Contributors](#Contributors)\n\n\n**Usage: main.py [options]**\n\n|   Options    |  Description |\n| ------------ | ------------ |\n|   -d, --debug   |  Print debug information |\n|  -n NUM, --threads  NUM |    set maximum number of threads to use (default: 100)  |\n|  -%, --show-progress-status |    show realtime progress status and a tabular result at the end  |\n|  -R, --realtime |    show realtime results in csv format  |\n\n\n\n# Installation\n\n\n```shell\n$ pip install prettytable requests\n$ git clone https://github.com/tuladhar/multi-threaded-google-ban-checker\n$ cat PROXIES.txt | python main.py --realtime\n```\n\n#### `PROXIES.txt` should be in following format (one proxy per line):\n**NOTE:**\n- Only one unique account can be searched at a time\n\n```markdown\nusername:password@proxy1:port\nusername:password@proxy2:port\n...\n```\n\n#### Google Keywords and User Agents used by the script:\n- `helper/keywords.txt`\n- `helper/useragents.txt`\n\n**NOTE:**\n- Please make sure your username and password exist here before using this\n- Please update these files as needed.\n- Always update the files before using this\n\nHow it works?\n-------------\n\n1. List of proxies (one per line) are read from standard input in following format and randomize internally by the script:\n  ```markdown\n  username:password@proxy1:port\n  username:password@proxy2:port\n  ...\n  ```\n\n2. `X` number of worker threads are created (see `--threads` option)\n\n3. Proxies are distributed among pool of available threads and each thread does the following:\n\n\t1. Each proxy makes 3 requests, retrieving default 10 page per request.\n\t2. First page is requested as normal\n\t3. Google ban is checked (50x), and if not banned then thread waits 40 seconds before using the proxy for another request\n\t4. After 40 seconds wait, second page is requested by adding `\u0026start=10` to query string\n\t5. Repeats step iii.\n\t6. After 40 seconds wait, third page is requested by adding `\u0026start=20` to query string\n\t7. Finally thread returns with result.\n\n\n## Contributing: Getting Started \n* Fork this repository (Click the Form button, top right of this page)\n* Clone your fork down to your local machine\n```markdown\ngit clone https://github.com/your-username/multi-threaded-google-ban-checker.git\n```\n* 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\n* Create a branch for a new feature\n```markdown\ngit checkout -b feature/branch-name\n```\n* Or if its a bugfix to a file\n```markdown\ngit checkout -b bugfix/branch-name\n```\n* Make your changes (choose from the Tasks above!)\n* Commit and Push\n```markdown\ngit add .\ngit commit -m 'commit message'\ngit push origin branch-name\n```\n* Create a New Pull Request from your forked repository ( Click the 'New Pull Request' Button located at the top of your repo)\n* Wait for your PR review and merge approval!\n* __Star this repository__ if you had fun!\n\n\n**NOTE:**\n- If ban is detected at any stage no further requests will be made.\n- You will be notified once a ban is detected\n- Based on progress option used (see `--help` option), console is updated and results are displayed as soon as they're available \n- Please update these files as needed.\n- Always update the files before using this\n.\n\n\n## Author\n- [Puru Tuladhar](github.com/tuladhar)\n\n\n## Contributors\n- See [Contributors.md](Contributors.md)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftuladhar%2Fmulti-threaded-google-ban-checker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftuladhar%2Fmulti-threaded-google-ban-checker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftuladhar%2Fmulti-threaded-google-ban-checker/lists"}