Important
If you are multi-accounting and abusing the service for which this is intended - DO NOT COMPLAIN ABOUT BANS!!!
Caution
Use it at your own risk, M$ may ban your account (and I would not be responsible for it)
Do not run more than one account at a time.
Do not use more than one phone number per 5 accounts.
Do not redeem more than one reward per day.
Group Chat - Telegram (pay attention to captchas - helps prevent spam)
Original bot by @charlesbel - refactored/updated/maintained by @klept0 and a community of volunteers.
-
Install requirements with the following command :
pip install -r requirements.txt
Upgrade all required with the following command:
pip install --upgrade -r requirements.txt
-
Make sure you have Chrome installed
-
(Windows Only) Make sure Visual C++ redistributable DLLs are installed
If they're not, install the current "vc_redist.exe" from this link and reboot your computer
-
Edit the
accounts.json.sample
with your accounts credentials and rename it by removing.sample
at the end.The "totp" field is not mandatory, only enter your TOTP key if you use it for 2FA (if ommitting, don't keep it as an empty string, remove the line completely).
The "proxy" field is not mandatory, you can omit it if you don't want to use proxy (don't keep it as an empty string, remove the line completely).
- If you want to add more than one account, the syntax is the following:
[ { "username": "Your Email 1", "password": "Your Password 1", "totp": "0123 4567 89ab cdef", "proxy": "http://user:pass@host1:port" }, { "username": "Your Email 2", "password": "Your Password 2", "totp": "0123 4567 89ab cdef", "proxy": "http://user:pass@host2:port" } ]
-
Run the script:
python main.py
-
(Windows Only) You can set up automatic execution by generating a Task Scheduler XML file.
If you are a Windows user, run the
generate_task_xml.py
script to create a.xml
file. After generating the file, import it into Task Scheduler to schedule automatic execution of the script. This will allow the script to run at the specified time without manual intervention.To import the XML file into Task Scheduler, see this guide.
-v/--visible
to disable headless-l/--lang
to force a language (ex: en)-g/--geo
to force a searching geolocation (ex: US)https://trends.google.com/trends/ for proper geolocation abbreviation for your choice. These MUST be uppercase!!!
-p/--proxy
to add a proxy to the whole program, supports http/https/socks4/socks5 (overrides per-account proxy in accounts.json)(ex: http://user:pass@host:port)
-cv/--chromeversion
to use a specific version of chrome(ex: 118)
-da/--disable-apprise
disables Apprise notifications for the session, overriding config.yaml. Useful when running manually as opposed to on a schedule.-t/--searchtype
to only dodesktop
ormobile
searches,(ex: --searchtype=mobile)
- Bing searches (Desktop and Mobile) with current User-Agents
- Complete the daily set automatically
- Complete punch cards automatically
- Complete the others promotions automatically
- Headless Mode - not recommended at all
- Multi-Account Management
- Session storing
- 2FA Support
- Notifications via Apprise - no longer limited to Telegram or Discord
- Proxy Support (3.0) - they need to be high quality proxies
- Logs to CSV file for point tracking
Fork this repo and:
- if providing a bugfix, create a pull request into master.
- if providing a new feature, please create a pull request into develop. Extra points if you update the CHANGELOG.md.
- Complete "Read To Earn" (30 pts)
- Setup flags for mobile/desktop search only
- Setup flags to load config / save data in working directory
- Provide Windows Task Scheduler config