Giter VIP home page Giter VIP logo

snkrs-bot's Introduction

PLEASE READ!

This is a Selenium bot for buying a given sneaker from the Nike Snkrs website ON RELEASE DAY. It will not work for sneakers that are past their release day (or later in the release day). Please note that this script was written with the US site in mind, so Nike sites for other countries will likely cause problems. This is because the purchase page changes to where the buy button redirects to a seperate checkout page (as opposed to a direct buy popup during release). It is a commandline script written solely in python. Please run with python 3.7. There are 6 selenium drivers in the bin directory for both Chrome and Firefox on Linux, MacOS, and Winows. The drivers for other operating systems need to be installed from the instructions below. I have found the Firefox driver for MacOS works best.

Ideally, some pieces (or all?) of this could be replaced with direct Nike API requests instead of Selenium. However, I've found that Nike APIs are not very straightforward.

Getting started

There are a few requirements to run the bot. First, you'll need to install Python 3.7 or greater. The instructions below show you how to do this in several operating systems

Next, we have provided the web drivers for MacOS, Linux, and Windows, but if they're not there, or you want something more up-to-date than the included drivers, you'll need to download them yourself with the instructions below

Finally, the program is run from the terminal (command line), so you should familiarize yourself with running python programs from the terminal here

Downloading python

This needs to be Python version 3.7 or up

MacOS

  • From Python's official website here
  • If you have brew installed, you can just run the coommand brew install python3

Linux

  • From Python's official website here
  • Using the package manager for your system. With Ubuntu, this command is sudo apt install python3-dev

Windows

  1. The selenium webdrivers for your chosen browser

Installing the web drivers

  • The drivers for most browsers can be found on selenium's site here, although at the moment, only Firefox and Chrome are supported

  • NOTE: There are already webdrivers for Chrome and Firefox, for MacOS, Linux, and Windows, which will be loaded if no other webdriver is specified manually

Usage

  1. Make sure that you have done all the Pre-installation requirements in the Getting Started section above

  2. Clone this repository's source code

    1. If you have git installed, this can be done as easily as git clone https://github.com/alexschimpf/Snkrs-Bot
    2. Otherwise, download the zipped source code and unzip it
  3. Navigate to the project's code

    • cd path/to/downloaded/project
  4. Install all the Python dependencies by running

  • pip install -r requirements.txt
  1. Run the bot
    • Replace all the fields in the command below with the options that you want, and any of the configuration options listed below
    python3 main.py --username [email protected] --password abc123 --url <your-shoes-url> --shoe-size 6 --driver-type chrome

Configuration options

Here is a list and description of the different arguments to use for the script:

--username

  • Username for login

--password

  • Password for login

--url

  • URL for desired shoe
  • Size parameter can also be passed in (for example: https://www.nike.com/launch/t/kobe-5-protro-bruce-lee?size=11). In this case, --shoe-size and --shoe-type will be ignored
  • DO NOT pass in size parameter with url on releases with "Additional Size Ranges" (i.e. children's shoes on same page) as it can lead to unexpected results

--shoe-size

  • Self-explanatory

--shoe-type

  • Men's (M), Women's (W), Youth (Y) or Child (C)
  • For special releases (i.e. Air Presto), can pass in XXS, XS, S, M, L or XL. You do not need to pass in shoe size

--cvv

  • Card Verification Value for your stored credit card
  • May not be needed in some cases (for example, if you have previously purchased a release with a stored credit card)

--shipping-option

  • STANDARD, TWO_DAY or NEXT_DAY

--shipping-address

  • If given, the bot will attempt to add a new shipping address in some scenarios
  • In some cases, checkout will not proceed without adding a new shipping address. If you are unsure, include it
  • Must be in this format: '{"first_name":"John", "last_name":"Doe", "address":"1313 Mockingbird Lane", "apt":"", "city":"Long Beach", "state":"CA", "zip_code":"90712", "phone_number":"9999999999"}'

--login-time

  • If given, the bot will pause until a specific time before it logs in (can be any datetime format)

--release-time

  • If given, the bot will pause until a specific time before it purchase the sneaker (can be any datetime format)

--screenshot-path

  • If given, the bot will take a screenshot of the page after purchasing and save it at the given file path (may be useful for debugging)

--html-path

  • If given, the bot will take the page source after purchasing and save it at the given file path (may be useful for debugging)

--page-load-timeout

  • This is used to limit the page load time (in seconds), which can be useful when the page is still loading, but the UI is nevertheless useable. This is pretty much a necessity as I've noticed Nike's pages hang all the time. I'd recommend using 1-3 seconds for this.

--driver-type

  • Should be 'firefox' or 'chrome' (the OS will be determined for you)
  • Defaults to Firefox if nothing is specified

--webdriver-path

  • If specified, will use the specified driver instead of the defaults
  • NOTE: The driver should match the browser specified in the --driver-type option (defaults to Firefox)

--headless

  • This will run the driver in headless mode, which should make the bot quicker

--select-payment

  • If you already have your payment options pre-saved on your Nike account, DO NOT use this. If for some reason you don't have it pre-saved (even though it will cost the bot more time) the bot will select the first payment option it finds.

--purchase

  • If this argument is given, the bot WILL attempt to purchase the shoe so USE WITH CAUTION!

--num-retries

  • If the bot fails for some reason, it will retry any number of times or until successful

--dont-quit

  • Prevent browser from closing. Please note, if you are passing the --purchase parameter, it may be necessary to pass this parameter in

snkrs-bot's People

Contributors

alexschimpf avatar alfredog1976 avatar ericruiz-developer avatar nickyboy89 avatar dependabot[bot] avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.