pa-0 / pricegram

A Telegram bot that tracks Amazon products and sends alerts about price and availabilty changes

Pricegram is a price tracker bot for Telegram that tracks Amazon products for price and availability changes and sends alerts according to user preferences.

Pricegram's default behaviour is to send price alerts every time the price of a product changes. However, it is possible to set the desired price for each product to only receive an alert when its price matches or goes below the desired one.

Availability alerts are turned off by default but can be enabled on a per-product basis to receive alerts every time its availability changes (e.g. the number of remaining units).

Requirements

• MongoDB

Installation

Pull the Docker image from DockerHub:

docker pull aleg94/pricegram

Run the image in a container providing the following environment variables:

• MONGO_CONNECTION_URI: the URI connection string for MongoDB
• TELEGRAM_BOT_TOKEN: the access token of the Telegram bot
• AVERAGE_POLLING_INTERVAL: the average interval between price and availability checks in seconds (defaults to 2 hours)

docker run --name pricegram -d
  -e MONGO_CONNECTION_URI=<mongo-uri>
  -e TELEGRAM_BOT_TOKEN=<bot-token>
  -e AVERAGE_POLLING_INTERVAL=<interval>
  aleg94/pricegram

Usage

Upon start, the bot presents a welcome message with a brief explanation of the functionalities and the list of available commands to interact with it.

/track

The track command can be used to add a new product to the list of tracked ones. It will ask the user to choose a name for the product and provide a reference to it either by sending its URL or sharing it with Pricegram from the Amazon App.

/list

The list command can be used to manage products that are currently being tracked. After selecting a product from the list, a menu can be used to:

• Set the target price
• Enable or disable availability alerts
• Delete the product

Alerts

Whenever the price or availability of a product changes, an alert is sent according to user preferences. The alert contains a hyperlink to the product page.

Notes

Pricegram is currently compatible with products sold in the following currencies: USD, GBP, EUR, BRL, RUB, ILS, RON.