Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jack-mil/bing-rewards
A script to automate daily Bing rewards points
https://github.com/jack-mil/bing-rewards
automation bing bing-search bot pyautogui reward-points script
Last synced: 6 days ago
JSON representation
A script to automate daily Bing rewards points
- Host: GitHub
- URL: https://github.com/jack-mil/bing-rewards
- Owner: jack-mil
- License: mit
- Created: 2020-05-29T12:05:33.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-03-20T19:29:10.000Z (10 months ago)
- Last Synced: 2024-03-21T19:39:43.085Z (10 months ago)
- Topics: automation, bing, bing-search, bot, pyautogui, reward-points, script
- Language: Python
- Homepage:
- Size: 299 KB
- Stars: 128
- Watchers: 5
- Forks: 20
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Bing-Rewards
### A CLI app to perform Bing searches
Please submit an issue or pull-request if you have an idea for a feature
- [Features](#features)
- [Install](#installation)
- [Usage](#usage)
- [Config](#options)
- [Development](#development--contribution)
## **Features**
* Enter random search queries into your browser a la Auto Hotkey.
* Use a mobile user agent to get mobile points (`--mobile`)
* Configurable number of searches with `--count=`
* Install as self-contained python application with minimal dependecies (`pynput`)
* Fine tune delay and set browser executable with [config](#configuration) at `$XDG_CONFIG_HOME` or `%APPDATA%` on Windows
## **Installation**
### With [`pipx`](https://pipx.pypa.io/stable/) or `pip`
```bash
pipx install bing-rewards
```
Will make the executable `bing-rewards` available on your PATH.
Look below or try the `--help` flag to see detailed usage.
**Recommended**: Use a virtual environment or [`pipx`](https://pypa.github.io/pipx/) to avoid poluting your global package path with executable apps. See: [pipx](https://pypa.github.io/pipx/)
### From releases
Download the latest release wheel and install with pip locally.
## **Dependencies**
- At least Python 3.10
- [pynput](https://github.com/moses-palmer/pynput) (installed automatically). Used to control keypresses and type Bing search URLS.
WARNING: This script *will* take control away from the keyboard while running. **Pynput** performs key presses. i.e., it does not operate headless or in the background.
- `chrome` must be discoverable on the system PATH. [Download Google Chrome](https://www.google.com/intl/en/chrome/).
If your chromium based browser has a different name use the `--exe` flag with an absolute path to the browser executable to use (e.g. `--exe=$(which brave-browser)`). Also see the `"browser-path"` key in the [config](#configuration) file.
- To earn points from searching, you *must* also have logged into [bing.com](https://www.bing.com) with your Microsoft account at least once, to save cookies.
## **Usage**
Complete mobile and desktop daily points
`$ bing-rewards`
Run 10 searches with mobile user-agent in a new window
`$ bing-rewards -m -c10`
`$ bing-rewards --mobile --count=10`
Complete mobile and desktop daily points using specified chrome profile "Profile 1"
`$ bing-rewards --profile "Profile 1"`
Launches Chrome as a subprocess with special flags. Tested on Windows 10 and Linux (Ubuntu + Arch), however it should work on Mac OS as well.
⚠️Known Issue: No other instance of chrome.exe can be open when the script runs. Chrome prevents different user agents in each window. The script will run, but Chrome will not appear as Edge
⚠️Bing has gotten more and more complex with the introduction of the AI tools. Disable as much as you can to make pages load faster. See PR #39 for some modifications you can make to the default search query url parameters that may improve success.
## **Options**
Running with no options will complete mobile and desktop daily search quota.
The following options are available to change the default behavior.
Options supplied at execution time override any config.
| Flag | Option |
| ----------------------- | --------------------------------------------------------------------------------------|
| `-h`, `--help` | Display help and exit |
| `-c`, `--count=N` | Override the number of searches to complete |
| `-d`, `--desktop` | Only use desktop user agent |
| `-m`, `--mobile` | Only use a mobile user agent |
| `-n`, `--dryrun` | Do everything but type the search query |
| `--bing` | Use this flag if Bing is already your default search engine. Bypasses constructing a bing.com URL |
| `--open-rewards` | Open the rewards page at the end of the run |
| `-X`, `--no-exit` | Do not close the browser after completing a search |
| `--load-delay` | Override the time given to Chrome to load in seconds |
| `--search-delay` | Override the time between searches in seconds |
| `--exe EXE` | The full path of the Chrome compatible browser executable (Brave and Chrome tested) |
| `--nowindow` | Don't open a new Chrome window, just type the keys |
| `--profile "Profile N"` | Launches chrome using the specified profile. Otherwise use default. |
| `--ime` | Triggers Windows IME to switch to English input by pressing "shift" |
A config file is also generated in $XDG_CONFIG_HOME or %APPDATA% on Windows
where precise delay modifications can be made. If updates make changes to the default configs, you will have to remove and regenerate the file.
Example config `~/.config/bing-rewards/config.json`
```json
{
"desktop_count": 30,
"mobile_count": 20,
"load_delay": 1.5,
"search_delay": 2,
"search_url": "https://www.bing.com/search?FORM=CHROMN&q=",
"desktop_agent": "Mozilla/5.0 ... ",
"mobile_agent": "Mozilla/5.0 (Windows Phone 10.0; Android 6.0.1) ... ",
"browser_path": "C:\\Program Files (x86)\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
}
```
Delay timings are in seconds.
Note: the format has slightly changed in version >= 3.0, so delete and regenerate accordingly.
## User agents
If interested, the following user agents are passed to Chrome using the `--user-agent` argument.
These are clearly defined at the top of `bing-rewards.py`.
Edge Browser on Windows 10 desktop:
> Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36 Edge/126.0.0.0
Mobile Edge Browser on Pixel 6 phone:
> Mozilla/5.0 (Linux; Android 14; Pixel 6 Build/AP2A.240605.024) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Mobile Safari/537.36 Edge/121.0.2277.138
## Words:
The [keywords](https://www.myhelpfulguides.com/keywords.txt) included in this repo where taken from this site
https://www.myhelpfulguides.com/2018/07/19/bing-rewards-auto-searcher-with-python-3/.
This script provided the original inspiration but has since been complelty rewritten and expanded.
The original author was contacted for the original source of keywords, but declined to respond
## Development & Contribution
This project uses [`hatch`](https://hatch.pypa.io/latest/) as the build backend for dependency management and packaging.
```
pipx install hatch
```
Then, fork the repo, clone and install the project and dependencies with `hatch env create`.
Install the defined pre-commit hooks: `hatch run pre-commit install`
Launch bing-rewards in the editable dev environment: `hatch run bing-rewards --help`
Feel free to open a PR with additional features or fixes.