ShopPyBot

Python scripts that build on Selenium to automate the purchase and monitoring of the availability of limited goods.

Project maintained by thezoid Hosted on GitHub Pages — Theme by mattgraham

ShopPyBot

A Python based system to 1) attempt to purchase an item from a link; and 2) check the availability of a list of items. This project takes advantage of the systems provided through Selenium in order to interact with shop web pages. This (as of writing) does not integrate with any shop APIs.

Supported sites

Requirements

Best Buy

Amazon

How to Use

  1. Make sure you have all the listed requirements above installed on your machine.
    • Windows users can execute the supplied installDependencies.ps1 script to walk through the requirements setup process
  2. Customize settings.json to include all of your appropriate information. Use the tables below if you are unsure of what values you should use.
  3. Run bot.py or bot-availCheck.py through your favorite method
    • NOTE: It is recommended to run this through the command line to more easily observe any output that may come up

To make the population of links for the availability check easier to process, modify data.csv such that each line is a pair of item name, link to BestBuy item. Once you have all your new items accounted for, run processor.ps1 to generate new content in out.json. Copy and paste the contents of the data array inside of out.json to the items array in the available settings.json section.

Customization

Before putting the bot to work, you need to configure settings.json so that the scripts will function correctly. Be sure not to commit or otherwise save your sensitive information in a public place (email, password, cvv, etc.). Non-GPU items from BestBuy should work but it is not guranteed.

OOtB the availability bot has a long list of RTX 30 series cards available on Best Buy; however, you will need to check the validity of this list to ensure your checks are up to date.

Debug

Key Description Default
loggingLevel Set the level of logging in the bot script such that
<ul><li>0 = SILENT</li><li>1 = ERROR</li><li>2 = WARNING</li><li>3 = INFO</li></ul>		 3
testMode Set to false to allow purchases to trigger, otherwise leave to true true
alertType The media type the alert file currently is. Must be mp3 or wav wav


App

Key Description Default
timeout The timeout used in the Selenium driver for actions 10
amz_email* your email for your Amazon account N/A
amz_pwd* your password for your Amazon account N/A
bb_email* your email for your Best Buy account N/A
bb_password* your password for your Best Buy account N/A
bb_cvv* your security code for your Best Buy saved payment method N/A
item a link to the item of which you want to automate purchasing N/A
queueExists represents whether the item being purchased is part of a queue system - queue system requires manual input for final checkout true


**If you update these in your settings, please do not commit it to your local repository! I do not take responsibility for any PII that may leak through your commits!*

Available

Key Description Default
timeout The timeout used in the Selenium driver for actions 10
items A list of items to check for availability. Must be presented as {"name":"item name","link":"link to the item"} N/A


Changing the Alert Sound

The included alert sound can be changed to any other .wav file. Simply put the new .wav. file in the sounds folder and rename it to alert.wav. The process is similar if you would like to use a .mp3 instead. Be sure to change the debug value alertType to either mp3 or wav. No other types are supported at this time.

Support

No support is currently provided.

Credits

wav Alert sound - NenandSimic