https://github.com/3thr3n/games_discount_promotion_service

Checks for discount promotions and pushes these to telegram-group and console
https://github.com/3thr3n/games_discount_promotion_service

Last synced: 10 days ago
JSON representation

Checks for discount promotions and pushes these to telegram-group and console

• Host: GitHub
• URL: https://github.com/3thr3n/games_discount_promotion_service
• Owner: 3thr3n
• License: gpl-3.0
• Created: 2022-01-06T00:24:38.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2022-05-07T21:47:53.000Z (almost 3 years ago)
• Last Synced: 2023-03-10T04:56:29.734Z (almost 2 years ago)
• Language: JavaScript
• Size: 558 KB
• Stars: 5
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Games discount promotions service

This service is an gamestore-api-scraper, currenty for Epicgames, Steam, Gog and Ubisoft.  

It will find any discount on the shop-page. (Demos are excluded)

  - **Epicgames**:  

    Desc: Gets all discounts without filtering  

    Execution Time: ca. 1 min

  - **Steam**:  

    Desc: Gets only discounts which are over the specified threshold in .env-file  

    The API is limited to 100 requests per minute so it takes a while to scrap through.  

    Execution Time: ca. 10-20 min.

  - **Gog**:  

    Desc: Like Steam it takes a while, because of request limits, but the Gog-API is better structured then the Steam-API  

    Execution Time: ca. 5 min

  - **Ubisoft**:  

    Desc: Gets all Games and filters the discounts. These is not done by API, its HTML-Scraping  

    Execution Time: ca. 1-3 min

Default is to write the discount promotions only into the console, but if an `Telegram-Bot-Token` and `ChatID` are supplied it will also send these per telegram to the chatid.  

The service checks also if the discount changed, so it will also send a notification. 

The Epic API provides an enddate to the discount promotion, it will automatically deleted from the DB (Every day at 01:00).

The other shops doesn't provide an enddate, so all games which have discounts are checked.

## How To start

### Creating from scratch

 - Copy the `.env_template` and rename it to `.env` and edit it to your needs

 - Run `npm install`

 - To start in dev-mode, run `npm run dev`

 

To build the docker-image use `docker-compose build`

### Using Docker

 - Copy the `.env_template` and rename it to `.env` and edit it to your needs

 - Run `docker-compose up -d`

### Telegram

If you want an working telegram group or chat you need a `Telegram-Bot-Token` and a `ChatID`. How to setup such thing, tutorials are given in the internet.  

```

# Technical

Telegram has also an request limit for 20 requests per minute.  

Each game which found is send with an delay of 3 seconds.

```