eSentry

eSentry is a powerful web application designed to monitor eBay for items as requested by the users! It monitors item listings real-time and notifies users of any new listings that meet their filters. eSentry then sends a Telegram message within seconds of the new listing to the user.

Features

eBay Listing Monitoring: Input an eBay item you desire and let eSentry do the rest. It will continuously monitor the search results and notify you of any new listings.
Telegram Notifications: Receive real-time notifications on Telegram whenever there's an update that matches your request.
Customizable Keyword Exclusion: Specify a desired price range, excluded keywords, or the item condition for a more tailored monitoring experience.

How to Setup eSentry Locally

Sidenote: Running locally requires creating your own OAuth 2.0 Client ID, MySQL Database, and Telegram Bot.

Prerequisites

Node.js
Telegram Bot Token
VSCode

Installation

Clone the Repository:

git clone https://github.com/mjw324/eSentry.git

Navigate to the Project Server Directory:
```
cd eSentry/server
```
Install Server Dependencies:
```
npm install
```

Setup Server Environment Variables:

Create a .env file in the root directory.

Add the following variables (note: SCRAPE_REFRESH_RATE is in milliseconds):

   DB_HOST="YOUR_DB_HOST"
   DB_USER="YOUR_DB_USER"
   DB_PASSWORD="YOUR_DB_PASSWORD"
   DB_NAME="YOUR_DB_NAME"
   GOOGLE_CLIENT_ID="YOUR_GOOGLE_CLIENT_ID"
   GOOGLE_CLIENT_SECRET="YOUR_GOOGLE_CLIENT_SECRET"
   TELEGRAM_BOT_TOKEN="YOUR_TELEGRAM_BOT_TOKEN"
   SCRAPE_REFRESH_RATE=10000

Start the Server:
```
npm start
```
Repeat Steps 2 & 3 for the Client
Start the Client

   npm start

Usage

Access the Client Interface: Open your browser and navigate to http://localhost:3000.
Create eBay Monitor: Once logged in, input your desired eBay search parameters and the notification method.
Receive Notifications: Once set up, you'll start receiving notifications for any new listings that match your criteria.

ESentry

Install / Use

README