Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/coskundeniz/ad_clicker

Google Ads clicker
https://github.com/coskundeniz/ad_clicker

bing-ads google-ads multiprocessing python rotating-proxy search selenium tor undetected-chromedriver

Last synced: 1 day ago
JSON representation

Google Ads clicker

Host: GitHub
URL: https://github.com/coskundeniz/ad_clicker
Owner: coskundeniz
License: gpl-3.0
Created: 2021-04-24T13:14:01.000Z (over 3 years ago)
Default Branch: main
Last Pushed: 2024-07-22T08:50:42.000Z (4 months ago)
Last Synced: 2024-07-22T10:39:56.532Z (4 months ago)
Topics: bing-ads, google-ads, multiprocessing, python, rotating-proxy, search, selenium, tor, undetected-chromedriver
Language: Python
Homepage: https://coskundeniz.github.io/ad_clicker/
Size: 12.9 MB
Stars: 142
Watchers: 10
Forks: 59
Open Issues: 0
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

# ad_clicker

### Use [premium version](https://github.com/coskundeniz/google-ad-clicker-premium) for more features and better stability.

---

This command-line tool clicks ads for a certain query on Google search using [undetected_chromedriver](https://github.com/ultrafunkamsterdam/undetected-chromedriver) package. Supports proxy, running multiple simultaneous browsers, ad targeting/exclusion, and running in loop.

> You can find the premium versions [here for Google](https://github.com/coskundeniz/google-ad-clicker-premium) and [here for Bing](https://github.com/coskundeniz/bing-ad-clicker-premium).

Old version of the tool can be found in the `old_version` branch.

* Requires Python 3.9 to 3.11
* Requires the latest Chrome version

[Related post on Medium](https://python.plainenglish.io/google-ads-clicker-with-python-selenium-and-tor-a6ff8078da2a)

## How to setup

Run the following commands in the project directory to install the required packages.

* `python -m venv env`
* `source env/bin/activate`
* `python -m pip install -r requirements.txt`

See [here](https://github.com/coskundeniz/ad_clicker/wiki/Setup-for-Windows) for setup on Windows.

See [here](https://github.com/coskundeniz/ad_clicker/wiki/Creating-and-running-Docker-image) for creating the Docker image manually.

## How to run

* You need to see `(env)` at the beginning of your command prompt that is showing virtual environment is activated.

* Before running the below commands for the first time, run `python ad_clicker.py -q test` once and end it by pressing CTRL+C after seeing the browser opened.

```
usage: python ad_clicker.py [-h] [-q QUERY] [-e EXCLUDES] [-l MAX_SCROLL_LIMIT] [--headless] [-p PROXY] [-pf PROXY_FILE] [--auth] [--incognito]

optional arguments:
-h, --help show this help message and exit
-q QUERY, --query QUERY Search query
-l MAX_SCROLL_LIMIT, --max_scroll_limit MAX_SCROLL_LIMIT Number of maximum scrolls on the search results page
--headless Use headless browser (not recommended)
-p PROXY, --proxy PROXY Use the given proxy in ip:port format
-pf PROXY_FILE, --proxy_file PROXY_FILE Select a proxy from the given file
--auth Use proxy with username and password. If this is passed,
proxy parameter should be in "username:password@host:port" format
-e EXCLUDES, --excludes EXCLUDES Exclude the ads that contain given words in url or title
--incognito Run in incognito mode. Disables proxy usage.
-qf QUERY_FILE, --query_file QUERY_FILE Read queries to search from the given file (valid for multiprocess run)
-bc BROWSER_COUNT, --browser_count BROWSER_COUNT Maximum number of browsers to run concurrently (valid for multiprocess run)
-ms MULTIPROCESS_STYLE, --multiprocess_style MULTIPROCESS_STYLE Style of the multiprocess run. (valid for multiprocess run)
1: different query on each browser (default)
2: same query on each browser
```

`python ad_clicker.py -q [-e EXCLUDES] [-l MAX_SCROLL_LIMIT] [--headless] [-p PROXY] [-pf PROXY_FILE] [--auth] [--incognito]`

### Examples

```
"~/" represents home folder on Linux/Mac. If you use Windows, don't use it.
If you put your files into project directory, you can just specify the file name,
otherwise you should give the full path.
```

* Search for "wireless keyboard" with the default 4 seconds visit time on clicked ad pages.

* `python ad_clicker.py -q "wireless keyboard"`

* Search for "wireless keyboard" with maximum scroll set to 5.

* `python ad_clicker.py -q "wireless keyboard" -l 5`

* By default(0), it will scroll until the end.

* Search for "wireless keyboard" using headless browser.

* `python ad_clicker.py -q "wireless keyboard" --headless`

* Search for "wireless keyboard" using the given proxy without authentication.

* `python ad_clicker.py -q "wireless keyboard" -p host:port`

* Search for "wireless keyboard" using the given proxy with authentication.

* `python ad_clicker.py -q "wireless keyboard" --auth -p username:password@host:port`

* Search for "wireless keyboard" using a proxy from the given file.

* `python ad_clicker.py -q "wireless keyboard" -pf ~/proxies.txt`

* Search for "wireless speaker" and click links that include the given filter words in url or title.

* `python ad_clicker.py -q "wireless speaker@amazon#ebay # mediamarkt"`

* Spaces around "@" and "#" are ignored, so both "wireless speaker@amazon#ebay" and
"wireless speaker @ amazon # ebay" take "wireless speaker" as search query and "amazon" and "ebay"
as filter words.

* If you will give a target domain as filter word, don't use "http" or "www" parts in it. Use like "[email protected]" or even "query@domainname". Keep it as short as possible to get a match.

* Search for "wireless speaker" and click links except the ones containing the given words in url or title.

* `python ad_clicker.py -q "wireless speaker" -e "amazon.com,mediamarkt.com,for 2022,Soundbar"`

* Separate multiple exclude items with comma.

* Run browser in `incognito` mode.

* `python ad_clicker.py -q "wireless speaker" --incognito`

* Note that the proxy extension is not enabled in *incognito* mode.

* Run multiple browsers by taking queries and proxies with authentication from the given files.

* `python run_ad_clicker.py -qf ~/queries.txt --auth -pf ~/proxies.txt`

* You can see example queries in `sample_queries.txt` file.

* Run multiple browsers by taking queries and proxies with authentication from the given files and pass exclude words.

* `python run_ad_clicker.py -qf ~/queries.txt --auth -pf ~/proxies.txt -e "amazon.com,mediamarkt.com,for 2022"`

* Run multiple browsers by taking queries and proxies without authentication from the given files with 5 browsers.

* `python run_ad_clicker.py -qf ~/queries.txt -pf ~/proxies.txt -bc 5`

* If -bc(--browser_count) option is not given, the number of cpu cores is used.

* Run multiple browsers by taking queries and proxies from the given files using alternative multiprocess style.

* `python run_ad_clicker.py -qf ~/queries.txt -pf ~/proxies.txt -ms 2`

* **1**: each browser instance gets a different query from file (default) (e.g. 5 browsers search the first 5 queries from the file.
After they are completed, second group of 5 browsers search the next 5 queries from the file and so on)
* **2**: multiple browser instances get the same query (e.g. 5 browsers search the first query from file. After
they are completed, second group of 5 browsers search the second query and so on)

* If the number of queries or proxies are less than the number of browsers to run, they are cycled.

![Multiprocess Run](assets/ad_clicker_multiprocess.gif)

* Run the tool in loop.

* `python run_in_loop.py -qf ~/queries.txt -pf ~/proxies.txt --auth`

* Query and proxy files are required for this command.
* Default wait time between runs is 60 seconds.

* Run the tool in loop with given number of browser instances.

* `python run_in_loop.py -qf ~/queries.txt -pf ~/proxies.txt --auth -bc 4`

* Run the tool in loop with given number of browser instances and maximum scroll set to 10.

* `python run_in_loop.py -qf ~/queries.txt -pf ~/proxies.txt --auth -bc 4 -l 10`

* Run the tool in loop with given number of browser instances and 2 minutes wait between runs.

* `python run_in_loop.py -qf ~/queries.txt -pf ~/proxies.txt --auth -bc 2 -wt 120`

* Wait time parameter should be in seconds.

* Run the tool in loop with given number of browser instances and pass exclude words.

* `python run_in_loop.py -qf ~/queries.txt -pf ~/proxies.txt --auth -bc 2 -e "amazon.com,mediamarkt.com,for 2022"`

* Run the tool in loop using alternative multiprocess style.

* `python run_in_loop.py -qf ~/queries.txt -pf ~/proxies.txt --auth -ms 2`

### How to run Docker image on Linux

* If you want to use the prebuilt image from DockerHub, you can use the following command.
* `docker pull codenineeight/ad_clicker_docker`

* Run the following command on your host machine once.
* `xhost local:docker`

* Create a volume for the input files
* `docker volume create ad_clicker_files`

* Add your queries and proxies files to the created volume
* `docker run -v ad_clicker_files:/data -v :/mnt/host alpine cp /mnt/host/queries.txt /data/`
* `docker run -v ad_clicker_files:/data -v :/mnt/host alpine cp /mnt/host/proxies.txt /data/`

* Check if the files are copied successfully

`docker run --rm -v ad_clicker_files:/data alpine ls -l /data`

```sh
-rw-r--r-- 1 root root 165 Apr 1 09:25 proxies.txt
-rw-r--r-- 1 root root 216 Apr 1 09:25 queries.txt
```

* You can pass the arguments as before after the image name(in this case codenineeight/ad_clicker_docker)

* `docker run --rm -it --net=host -e DISPLAY=$DISPLAY -v ad_clicker_files:/data codenineeight/ad_clicker_docker run_ad_clicker.py -qf /data/queries.txt --auth -pf /data/proxies.txt -bc 2`

* `docker run --rm -it --net=host -e DISPLAY=$DISPLAY codenineeight/ad_clicker_docker ad_clicker.py -q "wireless keyboard" -p username:password@host:port --auth`

---

## Support & Premium Version

[https://coskundeniz.github.io/ad_clicker](https://coskundeniz.github.io/ad_clicker)

If you benefit from this tool, please consider donating using the sponsor links or the following crypto addresses.

* ETH: 0x461c1B3bd9c3E2d949C56670C088465Bf3457F4B
* USDT: 0x1a4f06937100Dc704031386667D731Bea0670aaf