Inventory Hunter
This bot helped me snag an RTX 3070... hopefully it will help you get your hands on your next CPU, GPU, or game console.
Requirements
You will also need one of the following:
- Discord Webhook URL
- Slack Webhook URL
- Telegram Webhook URL and Chat ID
- SMTP relay to send automated emails
Quick Start
For instructions specific to Windows, please see this guide instead: Instructions for Windows
These steps should work on any supported Docker platform, but they have been specifically tested on Raspberry Pi OS with Docker already installed.
-
Clone this repository and pull the latest image from Docker Hub:
pi@raspberrypi:~ $ git clone https://github.com/EricJMarti/inventory-hunter pi@raspberrypi:~ $ cd inventory-hunter pi@raspberrypi:~/inventory-hunter $ docker pull ericjmarti/inventory-hunter:latest -
Create your own configuration file based on one of the provided examples:
-
Start the Docker container using the provided
docker_run.bashscript, specifying the required arguments.If using Discord or Slack, the format of your command will look like this:
$ ./docker_run.bash -c <config_file> -a <discord_or_slack> -w <webhook_url> # Discord example: pi@raspberrypi:~/inventory-hunter $ ./docker_run.bash -c ./config/newegg_rtx_3070.yaml -a discord -w https://discord.com/api/webhooks/...If using an SMTP relay, the format of your command will look like this:
$ ./docker_run.bash -c <config_file> -e <email_address> -r <relay_ip_address> # SMTP example: pi@raspberrypi:~/inventory-hunter $ ./docker_run.bash -c ./config/newegg_rtx_3070.yaml -e [email protected] -r 127.0.0.1
Getting New Code
- First identify any running container names related to inventory-hunter
$ docker ps - Stop and remove all containers related to inventory-hunter
$ docker stop CONTAINER_NAME $ docker rm CONTAINER_NAME - Pull repo updates
$ git pull - Rerun the docker_run.bash command to start containers back up with updates.
$ ./docker_run.bash -c <config_file> -a <discord_or_slack> -w <webhook_url>
Configuring Alerters
If you are interested in configuring multiple alerters or would like to keep your alerter settings saved in a file, you can configure inventory-hunter's alerting mechanism using a config file similar to the existing scraper configs.
-
Create a file called alerters.yaml in the config directory.
-
Configure the alerters you would like to use based on this example:
--- alerters: discord: webhook_url: https://discord.com/api/webhooks/XXXXXXXXXXXX... mentions: - XXXXXXXXXXXXXXX - XXXXXXXXXXXXXXX telegram: webhook_url: https://api.telegram.org/botXXXXXXXXXXXXXXXXXXXX/sendMessage chat_id: XXXXXXXX email: sender: [email protected] recipients: - [email protected] - [email protected] relay: 127.0.0.1 password: XXXXXXXXXX # optional slack: webhook_url: https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX mentions: - XXXXXXXXXXXXXXX - XXXXXXXXXXXXXXX ... -
Add this config file to your run command:
pi@raspberrypi:~/inventory-hunter $ ./docker_run.bash -c ./config/newegg_rtx_3070.yaml -q ./config/alerters.yaml
How it works
The general idea is if you can get notified as soon as a product becomes in stock, you might have a chance to purchase it before scalpers clear out inventory. This script continually refreshes a set of URLs, looking for the "add to cart" phrase. Once detected, an automated alert is sent, giving you an opportunity to react.
FAQ
How is this different from existing online inventory trackers?
Before developing inventory-hunter, I used several existing services without any luck. By the time I received an alert, the product had already been scalped. This bot alerts faster than existing trackers for several reasons:
- it runs on your own hardware, so no processing time is spent servicing other users
- you get to choose which products you want to track
- you are in control of the refresh frequency
What if inventory-hunter gets used by scalpers?
I sure hope this doesn't happen... 2020 and 2021 are bad enough already. My hope is that inventory-hunter levels the playing field a bit by giving real customers a better opportunity than they had previously. Serious scalpers will continue using automated checkout bots, and it is up to online retailers to combat this malarkey.
Do I really need Docker?
No, but I highly recommend it. If you know your way around python and pip/conda, then you should be able to replicate the environment I created using Docker.
![[Question] Windows friendly tutorial for noobs?](https://avatars.githubusercontent.com/u/75212578?v=4)
![[QUESTION] Issues getting this to work.](https://avatars.githubusercontent.com/u/63825253?v=4)
![[Question] Is there a way to test?](https://avatars.githubusercontent.com/u/64270171?v=4)
5 Nov 26, 2021
7 Jan 3, 2023
1.5k Jan 6, 2023
3 Sep 10, 2021
3 Dec 21, 2021
9 Apr 15, 2022
471 Dec 24, 2022
5 Feb 19, 2022
0 Sep 13, 2022
3 Feb 4, 2022
18 Nov 24, 2021
8 Oct 6, 2022
4 Oct 21, 2022
1 Jan 1, 2022
16 Nov 24, 2022
3 Jan 19, 2022
46 Dec 26, 2022
48 Dec 19, 2022