The purpose of this bot is to get an Nvidia card. It tries multiple things to do that.
- Currently,
nvidia-snatcheris not capable of purchasing a card for you - Scrapes multiple websites for patterns of being stocked
- API requests are a work in progress (very soon)
- Opens browser when stock is available
- Sends an email to you when stock is avaiable (must have Gmail)
What you may see if you're lucky
2020-09-18T07:06:28.535Z info :: ✖ [nvidia] nvidia founders edition is still out of stock
2020-09-18T07:06:31.241Z info :: ✖ [nvidia] nvidia founders edition is still out of stock
2020-09-18T07:06:34.212Z info :: ✖ [bestbuy] nvidia founder edition is still out of stock
2020-09-18T07:06:39.878Z info :: ✖ [bandh] gigabyte black is still out of stock
2020-09-18T07:06:43.236Z info :: ✖ [bestbuy] gigabyte black is still out of stock
2020-09-18T07:06:43.318Z info :: ↗ trying stores again
2020-09-18T07:06:43.318Z info :: 🚀🚀🚀 [nvidia] nvidia founders edition IN STOCK 🚀🚀🚀
2020-09-18T07:06:43.318Z info :: https://store.nvidia.com/store/nvidia/en_US/buy/productID.5438481700/clearCart.yes/nextPage.QuickBuyCartPage👉 You may get false positives from time to time, so I apologize for that. The library currently waits for all calls to be completed before parsing, but sometimes this can have unknown behavior. Patience is a virtue :)
| Adorama | Amazon | Amazon (CA) | ASUS | B&H | Best Buy | Best Buy (CA) | EVGA | Micro Center | Newegg | Newegg (CA) | Nvidia | Office Depot | PNY | Zotac | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 3070 | ✔ |
||||||||||||||
| 3080 | ✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
| 3090 | ✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
✔ |
Linux, macOS, and Windows are all capable operating systems.
You do not need any computer skills, smarts, or anything of that nature. You are very capable as you have made it this far. Some basic understanding how a terminal, git, and or Node.js is a bonus, but that does not limit you to getting nvidia-snatcher running!
- Node.js 14
- git
- Clone this project
git clone https://github.com/jef/nvidia-snatcher.git - Run
npm install - Copy
.env.exampleto a new file.envand edit the.envfile to your liking using your favorite text editor- More on this in customization
- Run
npm run startto start
At any point you want the program to stop, use Ctrl + C.
👉 Please visit the wiki if you need more help with installation.
The command npm run start:dev can be used instead of npm run start to automatically restart the project when filesystem changes are detected in the src/ folder or .env file.
To customize nvidia-snatcher, make a copy of .env-example as .env and make any changes to your liking. All environment variables are optional.
Here is a list of variables that you can use to customize your newly copied .env file:
| Environment variable | Description | Notes |
|---|---|---|
BROWSER_TRUSTED |
Skip Chromium Sandbox | Useful for containerized environments, default: false |
COUNTRY |
Supported country you want to be scraped | Currently only used by Nvidia, default: usa |
DESKTOP_NOTIFICATIONS |
Display desktop notifications using node-notifier | Default: false |
DISCORD_NOTIFY_GROUP |
Discord group you would like to notify | Can be comma separated, use role ID, E.g.: <@2834729847239842> |
DISCORD_WEB_HOOK |
Discord Web Hook URL | Can be comma separated, use whole webhook URL |
EMAIL_USERNAME |
Gmail address | E.g.: [email protected] |
EMAIL_TO |
Destination Email | Defaults to username if not set. Can be comma separated |
EMAIL_PASSWORD |
Gmail password | See below if you have MFA |
HEADLESS |
Puppeteer to run headless or not | Debugging related, default: true |
IN_STOCK_WAIT_TIME |
Time to wait between requests to the same link if it has that card in stock | In seconds, default: 0 |
LOG_LEVEL |
Logging levels | Debugging related, default: info |
LOW_BANDWIDTH |
Blocks images/fonts to reduce traffic | Disables ad blocker, default: false |
MAX_PRICE |
Maximum price allowed for a match, applies to all cards (does not apply to these sites: Nvidia, Asus, EVGA) | Default: leave empty for no limit, otherwise enter a price (enter whole dollar amounts only, avoid use of: dollar symbols, commas, and periods.) e.g.: 1234 - Cards above 1234 will be skipped. |
MICROCENTER_LOCATION |
Specific MicroCenter location to search | Default : web |
NVIDIA_ADD_TO_CART_ATTEMPTS |
The maximum number of times the nvidia-api add to cart feature will be attempted before failing |
Default: 10 |
NVIDIA_SESSION_TTL |
The time in milliseconds to keep the cart active while using nvidia-api |
Default: 60000 |
OPEN_BROWSER |
Toggle for whether or not the browser should open when item is found | Default: true |
PAGE_TIMEOUT |
Navigation Timeout in milliseconds | 0 for infinite, default: 30000 |
PHONE_NUMBER |
10 digit phone number | E.g.: 1234567890, email configuration required |
PHONE_CARRIER |
Supported carriers for SMS | Email configuration required |
PLAY_SOUND |
Play this sound notification if a card is found | Relative path accepted, valid formats: wav, mp3, flac, E.g.: path/to/notification.wav, free sounds available |
PUSHBULLET |
PushBullet API key | Generate at https://www.pushbullet.com/#settings/account |
PUSHOVER_TOKEN |
Pushover access token | Generate at https://pushover.net/apps/build |
PUSHOVER_USER |
Pushover username | |
PUSHOVER_PRIORITY |
Pushover message priority | |
PAGE_BACKOFF_MIN |
Minimum backoff time between retrying requests for the same store when a forbidden response is received | Default: 10000 |
PAGE_BACKOFF_MAX |
Maximum backoff time between retrying requests for the same store when a forbidden response is received | Default: 3600000 |
PAGE_SLEEP_MIN |
Minimum sleep time between queries of the same store | In milliseconds, default: 5000 |
PAGE_SLEEP_MAX |
Maximum sleep time between queries of the same store | In milliseconds, default: 10000 |
PROXY_ADDRESS |
IP Address or fqdn of proxy server | |
PROXY_PORT |
TCP Port number on which the proxy is listening for connections | Default: 80 |
SCREENSHOT |
Capture screenshot of page if a card is found | Default: true |
SHOW_ONLY_BRANDS |
Filter to show specified brands | Comma separated, e.g.: evga,zotac |
SHOW_ONLY_MODELS |
Filter to show specified models | Comma separated, e.g.: founders edition,rog strix |
SHOW_ONLY_SERIES |
Filter to show specified series | Comma separated, e.g.: 3080 |
SLACK_CHANNEL |
Slack channel for posting | E.g.: update, no need for # |
SLACK_TOKEN |
Slack API token | |
STORES |
Supported stores you want to be scraped | Comma separated, default: nvidia |
SCREENSHOT |
Capture screenshot of page if a card is found | Default: true |
TELEGRAM_ACCESS_TOKEN |
Telegram access token | |
TELEGRAM_CHAT_ID |
Telegram chat ID | |
TWILIO_ACCOUNT_SID |
Twilio Account SID | Can be found on twilio.com/console |
TWILIO_AUTH_TOKEN |
Twilio Auth Token | Can be found on twilio.com/console |
TWILIO_FROM_NUMBER |
Twilio provided phone number to send messages from | Include country code e.g +4401234567890 |
TWILIO_TO_NUMBER |
Mobile number to send SMS to | Include country code e.g +4401234567890 |
TWITTER_CONSUMER_KEY |
Twitter Consumer Key | Generate all Twitter keys at: https://developer.twitter.com/ |
TWITTER_CONSUMER_SECRET |
Twitter Consumer Secret | |
TWITTER_ACCESS_TOKEN_KEY |
Twitter Token Key | |
TWITTER_ACCESS_TOKEN_SECRET |
Twitter Token Secret | |
TWITTER_TWEET_TAGS |
Optional list of hashtags to append to the tweet message | E.g.: #nvidia #nvidiastock |
USER_AGENT |
Custom User-Agent header for HTTP requests | Default: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/78.0.3904.108 Safari/537.36 |
👉 If you have multi-factor authentication (MFA), you will need to create an app password and use this instead of your Gmail password.
👉 You can find your computer's user agent by searching google for "my user agent"
👉 You can test your notification configuration by running
npm run test:notification.
| Stores | Environment variable |
|---|---|
| Adorama | adorama |
| Amazon | amazon |
| Amazon (CA) | amazon-ca |
| Amazon (DE) | amazon-de |
| Amazon (NL) | amazon-nl |
| ASUS | asus |
| B&H | bandh |
| Best Buy | bestbuy |
| Best Buy (CA) | bestbuy-ca |
| EVGA | evga |
| EVGA (EU) | evga-eu |
| Gamestop | gamestop |
| Micro Center | microcenter |
| Newegg | newegg |
| Newegg (CA) | newegg-ca |
| Nvidia | nvidia |
| Nvidia (API) | nvidia-api |
| Office Depot | officedepot |
| PNY | pny |
| Zotac | zotac |
Micro Center stores
| Store name |
|---|
brooklyn |
brentwood |
cambridge |
chicago |
columbus |
dallas |
devin |
duluth |
fairfax |
flushing |
houston |
madison-heights |
marietta |
mayfield-heights |
north-jersey |
overland-park |
parkville |
rockville |
sharonville |
st-davids |
st-louis-park |
tustin |
westbury |
westmont |
yonkers |
| Brand | Model |
|---|---|
asus |
rog strix, rog strix oc, strix, tuf, tuf oc |
evga |
ftw3, ftw3 ultra, xc3 black, xc3, xc3 ultra |
gigabyte |
aorus master, eagle, eagle oc, gaming, gaming oc, vision |
msi |
gaming x trio, ventus 3x, ventus 3x oc |
nvidia |
founders edition |
pny |
dual fan, xlr8, xlr8 rgb |
zotac |
trinity, trinity oc |
| Carrier | Environment variable | Notes |
|---|---|---|
| AT&T | att |
|
| AT&T Prepaid | attgo |
|
| Bell | bell |
|
| Fido | fido |
|
google |
||
| Koodo | koodo |
|
| Mint | mint |
|
| Rogers | rogers |
|
| Sprint | sprint |
|
| Telus | telus |
|
| T-Mobile | tmobile |
|
| Verizon | verizon |
Works with Visible |
| Virgin | virgin |
|
| Virgin (CA) | virgin-ca |
COUNTRY is only used by the nvidia and nvidia-api stores.
| Country | 3080 FE | 3090 FE | Test Card | Notes |
|---|---|---|---|---|
| austria | ✔ |
✔ |
✔ |
|
| belgium | ✔ |
✔ |
✔ |
|
| canada | ✔ |
✔ |
✔ |
|
| czechia | ✔ |
✔ |
✔ |
|
| denmark | ✔ |
✔ |
Missing RTX 3090 | |
| finland | ✔ |
✔ |
Missing RTX 3090 | |
| france | ✔ |
✔ |
✔ |
|
| germany | ✔ |
✔ |
✔ |
|
| great_britain | ✔ |
✔ |
✔ |
|
| ireland | ✔ |
✔ |
✔ |
|
| italy | ✔ |
✔ |
✔ |
|
| luxembourg | ✔ |
✔ |
✔ |
|
| netherlands | ✔ |
✔ |
✔ |
|
| norway | ✔ |
✔ |
✔ |
|
| poland | ✔ |
✔ |
✔ |
|
| portugal | ✔ |
RTX 3080 only | ||
| spain | ✔ |
✔ |
✔ |
|
| sweden | ✔ |
✔ |
✔ |
|
| usa | ✔ |
✔ |
✔ |
Q: What's Node.js and how do I install it? Visit their website and download and install it. Very straight forward. Otherwise, Google more information related to your system needs.
Q: Will this harm my computer? No.
Q: Have you gotten a card yet? YES! 🎉 🚀
Screenshot
Q: Will I get banned from of the stores? Perhaps, but getting a card is a nice outcome.
Q: I got a problem and need help! Join the Discord or file an issue, I'll do my best to get to you. I work a full time job and this is only a hobby of mine.
Q: How do I get the latest code? Take look at this wiki page
Q: Why don't my notifications work? There are probably an issue [that] has already been resolved
Q: I'd love to contribute, how do I do that? Make a pull request! All contributions are welcome.
Q: Why do I have to download all this stuff just to get this bot working? Well, I would rather you didn't either. See #11.
Thanks to the great contributors that make this project possible
Special shout to initial developers: