Skip to content

hxu296/stock-drop-notifier

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Stock Drop Notifier

stock-drop-notifier

build

Index

About

Stock Drop Notifier will monitor the stock information for an user-specified product on www.newegg.com and send Telegram message for real time stock update. Users can send Telegram command to customize a search filter, spawn new notifiers, and terminate old notifiers. Simply talk to the Telegram bot @StockDropBot to use the service.

Use Case Demo

Use case Screenshot
Add a notifier to monitor all products on newegg that:
  • contain any of the keywords 4080, RTX 4080, 4090, or RTX 4090
  • don't contain any of the keywords mid tower, PC, or ATX to exclude PC cases
  • have a price lower than $1200
add_example
Remove the above-added notifier rm_example
Receive stock notification about RTX 3080 stock_notification

Unique Features

While most other stock informers adopt the naive approach of checking the "add to cart" keyword from webpage, our notifier used a tailored newegg parser to locate the price, dealer, and stock information for an product, which enables more complex search filters and higher information accuracy.

Moreover, our notifier automated the process of manually entering product urls to check on. All you need to do is to give some search words, and the notifier will automatically find product urls based on them.

Finally, features of Stock Drop Notifier can be accessed through a Telegram bot. See command.md for details.

Installation

Note: you don't need to host Stock Drop Notifier to use it. Simply talk to the Telegram bot @StockDropBot to use the service.

Installation Option 1: Docker

  1. Receive and copy your telegram bot token from @BotFather.
  2. Make sure you have Docker installed on your machine.
  3. Run the following command to start the bot.
    git clone https://github.com/hxu296/stock-drop-notifier.git
    cd stock-drop-notifier
    docker build -t stock-drop-notifier .
    docker run -d -e TELEGRAM_BOT_TOKEN="your_token" stock-drop-notifier
  1. You can now talk to your Telegram bot using commands from command.md.

Installation Option 2: Bare-metal

  1. Receive and copy your telegram bot token from @BotFather.
  2. Make sure your host machine has a Unix-like system with Python 3.6+ installed.
  3. Run the following commands to set up the environment.
   git clone https://github.com/hxu296/stock-drop-notifier.git
   cd stock-drop-notifier
   pip3 install -r requirements.txt
   pip3 install python-telegram-bot --upgrade
  1. To start the bot, run python3 run.py -m from the project root directory and paste your bot token according to the instruction.
  2. You can now talk to your Telegram bot using commands from command.md.

Project Architecture

architecture

About

Customizable stock notifier for Newegg and Bestbuy as an interactive Telegram Chat Bot.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published