Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/coskundeniz/bing-ad-clicker-premium
Ad Clicker Premium for Bing
https://github.com/coskundeniz/bing-ad-clicker-premium
2captcha bing-ads bing-search multiprocessing python rotating-proxy selenium
Last synced: 15 days ago
JSON representation
Ad Clicker Premium for Bing
- Host: GitHub
- URL: https://github.com/coskundeniz/bing-ad-clicker-premium
- Owner: coskundeniz
- License: apache-2.0
- Created: 2024-10-01T10:16:35.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-10-27T14:17:04.000Z (21 days ago)
- Last Synced: 2024-10-27T16:16:41.993Z (21 days ago)
- Topics: 2captcha, bing-ads, bing-search, multiprocessing, python, rotating-proxy, selenium
- Language: Python
- Homepage: https://www.adclicker.pro/
- Size: 1.1 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Ad Clicker Premium for Bing
This command-line tool clicks ads for a certain query on Bing search using [undetected_chromedriver](https://github.com/ultrafunkamsterdam/undetected-chromedriver) package. Supports proxy, running multiple simultaneous browsers, ad targeting/exclusion, and running in loop.
* Additional Features in Premium
* Single config file for all options
* Desktop UI for configuration and run
* Clear cache and cookies on browser exit
* External file for user agents
* Set browser window size
* Shift browser windows by random offsets
* Set opening URL based on the proxy country
* Set browser language based on the proxy country
* Random scrolls and mouse movements on pages
* Click non-ad links with domain filtering or in random
* Custom click order between ad and non-ad links
* Set min/max waiting range for ad and non-ad pages
* Limit max scroll on the search results page
* Use custom collected cookies
* Set the running interval time
* Summary of statistics
* Click on the top shopping ads up to 5
* 2captcha integration
* Telegram notification
* Generate daily click report
* Open found links on Android device
* Hooks for extending the tool with custom behavior
* Requires Python 3.9 to 3.11
* Requires the latest Chrome version
## 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`
* To be able to use `pyautogui` for random mouse movements,
* MacOS needs the `pyobjc-core` and `pyobjc` modules installed (in that order)
* You must install tkinter on Linux.
* `sudo apt install python3-tk python3-dev`
* Windows does not have additional dependency.
See [here](https://github.com/coskundeniz/ad_clicker/wiki/Setup-for-Windows) for setup on Windows.
## 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.
* Run `python ad_clicker.py` for a single run with single browser.
* Run `python run_ad_clicker.py` for a single run with multiple browsers.
* Run `python run_in_loop.py` for running in loop with either single or multiple browsers.
* Run `python gui.py` for opening ui to configure/run.
* Run `python ad_clicker.py --report_clicks` for generating click report.
* Run `python ad_clicker.py --report_clicks --date` for generating click report for the given date in DD-MM-YYYY format.
* Run `python ad_clicker.py --report_clicks --excel` for generating click report and writing results to an Excel file.
* Example report
### Config Options
All options can be set in the `config.json` file in the project directory.
The followings are the default values in the config file.
```json
{
"paths": {
"query_file": "/home/coskun/queries.txt",
"proxy_file": "/home/coskun/proxies.txt",
"user_agents": "user_agents.txt",
"filtered_domains": "domains.txt"
},
"webdriver": {
"proxy": "",
"auth": true,
"incognito": false,
"country_domain": false,
"language_from_proxy": false,
"ss_on_exception": false,
"window_size": "",
"shift_windows": false
},
"behavior": {
"query": "",
"ad_page_min_wait": 10,
"ad_page_max_wait": 15,
"nonad_page_min_wait": 15,
"nonad_page_max_wait": 20,
"max_scroll_limit": 0,
"check_shopping_ads": true,
"excludes": "",
"random_mouse": false,
"custom_cookies": false,
"click_order": 5,
"browser_count": 2,
"multiprocess_style": 1,
"loop_wait_time": 60,
"running_interval_start": "00:00",
"running_interval_end": "00:00",
"2captcha_apikey": "",
"hooks_enabled": false,
"telegram_enabled": false,
"send_to_android": false
}
}
```
* **query_file**: File path to read queries to search. Used with `run_ad_clicker.py` and `run_in_loop.py`. Put a query for each line.
* **proxy_file**: File path to read proxies. Put a proxy for each line.
* **user_agents**: File path to read user agents. Default value is `user_agents.txt`.
* **filtered_domains**: File path to read domains to filter for clicking non-ad links. Default value is `domains.txt` in the project directory. If you don't want to filter non-ad domains, simply leave the `domains.txt` file empty and 3 links will be randomly selected.
* **proxy**: Use the given proxy with `ad_clicker.py`. The `proxy_file` and `proxy` parameters can not have a value at the same time.
* **auth**: Use proxy with username and password. If this is `true`, your proxies should be in `username:password@host:port` format
* **incognito**: Run in incognito mode. Note that the proxy extension is not enabled in `incognito` mode.
* **country_domain**: Set opening URL based on the proxy country.
* **language_from_proxy**: Set browser locale language based on the proxy country.
* **ss_on_exception**: Enable taking screenshot in case of an exception.
* **window_size**: Set browser window size as `width,height` px.
* **shift_windows**: Shift browser windows by randomly selected x,y offsets.
* If you are using a display zoom other than 100%, use this together with `window_size` option.
* If a custom `window_size` is given, it is used to determine a new widthxheight for the window. Otherwise, screen resolution is used.
* **query**: Search query. The `query_file` and `query` parameters can not have a value at the same time.
* A query like "wireless speaker@amazon#ebay # mediamarkt" searches for "wireless speaker" and click links that include the given filter words in url or title.
* 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.
* **ad_page_min_wait**: Number of minimum seconds to wait on the ad page. The value is randomly selected between the min/max ranges.
* **ad_page_max_wait**: Number of maximum seconds to wait on the ad page. The value is randomly selected between the min/max ranges.
* **nonad_page_min_wait**: Number of minimum seconds to wait on the non-ad page. The value is randomly selected between the min/max ranges.
* **nonad_page_max_wait**: Number of maximum seconds to wait on the non-ad page. The value is randomly selected between the min/max ranges.
* **max_scroll_limit**: Number of maximum scrolls on the search results page. It will scroll until the end of the page by default(0).
* **check_shopping_ads**: Enable checking and clicking shopping ads seen on top up to 5 if exists. It is more likely to see shopping ads if you use residential proxies.
* **excludes**: Exclude the ads that contain given words in url or title.
* A value like "amazon.com,mediamarkt.com,for 2022,Soundbar" click links except the ones containing the given words in url or title.
* Separate multiple exclude items with comma.
* **random_mouse**: Enable random mouse movements on pages.
* **custom_cookies**: Use custom collected cookies. They should be put into `cookies.txt` file in the project directory.
* **click_order**: Click order for ad and non-ad links found
* 1: click all non-ad links first, then click ad links
* 2: click all ad links first, then non-ad links
* 3: click 1 non-ad, then 1 ad, then all remaining non-ads, finally all remaining ads
* 4: click 1 non-ad, then 1 ad on each round
* 5: shuffle ad and non-ad links and click whichever order is created (default)
* **browser_count**: Maximum number of browsers to run concurrently. Used with `run_ad_clicker.py` and `run_in_loop.py`.
* If the value is 0, the number of cpu cores is used.
* **multiprocess_style**: Style of the multiprocess run. Used with `run_ad_clicker.py` and `run_in_loop.py`.
* 1: different query on each browser (default)
* e.g. First, queries in the file are shuffled. Then, 5 browsers search the first 5 queries from the file.
* 2: same query on each browser
* 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.
* If *multiprocess_style* is 1, queries read from the file are shuffled.
* **loop_wait_time**: Wait time between runs in seconds. Default is 60. Used with `run_in_loop.py`.
* **running_interval_start**: Running interval start in "HH:MM" format. Used with `run_in_loop.py`.
* If the current time is outside of the interval, it waits the start time to run again.
* **running_interval_end**: Running interval end in "HH:MM" format. Used with `run_in_loop.py`.
* Difference between start and end time must be at least 10 minutes.
* If both start and end is "00:00"(default), no interval check is done.
* **2captcha_apikey**: API key for 2captcha service.
* Note that this is a 3rd party service, so you need to [register with it](https://2captcha.com/?from=18906047) to get an API key.
* **hooks_enabled**: Enable hooks for extending the tool with custom behavior.
* You can implement the functions in the `hooks.py` module as your need.
* Any errors coming from your custom implementation will be in your responsibility.
* Installing additional 3rd-party packages used in your implementation is in your responsibility.
* **telegram_enabled**: Enable Telegram notifications.
* You will get a message like below.
* There is a limit of 2048 characters. If the length of the message exceeds this, it will be truncated.
* **send_to_android**: Send links to open on connected Android mobile device. Used with `run_ad_clicker.py` and `run_in_loop.py`.
* Note that mobile device must be connected to the same wireless network or directly via USB cable for one of these usages.
* If you have less devices(n) than browsers you run, first n browsers will be assigned to n devices.
* ADB setup steps
1. Open your phone’s **Settings**.
2. Scroll down to **About phone**.
3. Find **Build number** (usually under Software Information).
4. Tap Build number 7 times. You should see a message like "You are now a developer!"
5. Go back to Settings, and you will now see a **Developer options** menu.
6. Open **Developer options** and enable **USB Debugging**.
7. Install ADB on your computer
* `sudo apt install adb`
* See [here](https://www.xda-developers.com/install-adb-windows-macos-linux/) or [here](https://www.howtogeek.com/125769/how-to-install-and-use-abd-the-android-debug-bridge-utility/) for Windows.
8. Verify installation
* `adb version`
9. Connect your phone to your computer via USB.
* When prompted on your device, select Allow USB Debugging.
10. Check if ADB recognizes your device by running `adb devices`.
* If you see your device’s ID, the connection is successful.
* You can also use ADB wirelessly without a USB cable.
1. Connect your phone to your computer via USB and enable USB Debugging as explained before.
2. Run the following command.
* `adb tcpip 5555`
3. Disconnect the USB cable and find the phone’s IP address (Settings > About phone > Status).
4. Connect ADB to your phone wirelessly.
* `adb connect :5555`
* Watch an example run
[](https://youtu.be/SL92brQUBwA)
### Enable Telegram Notification
Apply the following steps for once to enable Telegram notifications.
1. Create your own Telegram bot using the [BotFather](https://t.me/BotFather).
2. Set `TELEGRAM_TOKEN` environment variable with your own token received from the BotFather. You can see the instructions to set environment variables [here for Linux](https://phoenixnap.com/kb/linux-set-environment-variable), [here for Windows](https://phoenixnap.com/kb/windows-set-environment-variable), and [here for Mac](https://phoenixnap.com/kb/set-environment-variable-mac).
3. Run `python ad_clicker.py --enable_telegram`
4. Open [https://t.me/]()
5. Send `/start` command.
6. End script by pressing CTRL+C.
## Execution Example
[Watch recording of an execution](https://youtu.be/V82uyaDeW1g)
## FAQ
Which are the supported platforms?
You can run the tool on Linux(recommended) and Windows.
Does it have a UI?
Yes, it has a desktop ui. This is a command-line tool but it just requires a simple command to start. All options can be set in a config file easily.
What kind of proxies are supported?
It supports IPv4 http proxies.
How many browsers can I run simultaneously?
It depends on your configuration and system properties. You can run as much as your number of cpu cores. I recommend (cpu core - 1) as maximum.
How many clicks does it make per minute/hour?
It depends on your configuration.
Can I send hundreds of clicks in a few minutes?
No, you can't. The goal of the tool is to become as close as possible to human behavior.
What happens if there is captcha shown?
The tool has 2captcha integration. If you register for a 2captcha account, captcha is solved using it.
What should I do if I need customization or support?
Please see the support section below.
## Support
[https://coskundeniz.github.io/ad_clicker](https://coskundeniz.github.io/ad_clicker)
If you benefit from this tool, please give a star and consider donating using the sponsor links([patreon](https://patreon.com/pythondoctor), [ko-fi](https://ko-fi.com/coskundeniz)) or the following crypto addresses.
* ETH: 0x461c1B3bd9c3E2d949C56670C088465Bf3457F4B
* USDT: 0x1a4f06937100Dc704031386667D731Bea0670aaf