Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SpikeHD/AmazonMonitor
Amazon price checker, item monitor and stock monitor, all shoved into a Discord bot
https://github.com/SpikeHD/AmazonMonitor
amazon discord discord-bot discord-js price-tracker
Last synced: 8 days ago
JSON representation
Amazon price checker, item monitor and stock monitor, all shoved into a Discord bot
- Host: GitHub
- URL: https://github.com/SpikeHD/AmazonMonitor
- Owner: SpikeHD
- License: gpl-3.0
- Created: 2020-04-12T22:11:47.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-05-11T21:41:41.000Z (6 months ago)
- Last Synced: 2024-11-05T07:11:40.473Z (15 days ago)
- Topics: amazon, discord, discord-bot, discord-js, price-tracker
- Language: TypeScript
- Homepage:
- Size: 526 KB
- Stars: 235
- Watchers: 10
- Forks: 39
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
AmazonMonitor
Now updated for Discord.js v14 (and typescript)!
# TODO
* Take advantage of the fact that this kind of link: https://www.amazon.com/gp/aws/cart/add.html?ASIN.1=B073VPS15N
* Will output the prices of ALL items, as well as say which do not have prices currently.
# Description
AmazonMonitor is a self-hosted Discord bot designed for notifying you, or other people, about price drops and restocks on Amazon. It supports setting price limits, watching items from other countries, watching entire search queries and categories, and more.
[FAQ (please read this before creating an issue. Thanks!)](https://github.com/SpikeHD/AmazonMonitor/blob/master/FAQ.md)
# Demo
https://user-images.githubusercontent.com/25207995/226811331-4b86a328-a93c-46da-98b2-737a082d3ea5.mp4
# Jump to:
* [Requirements](#requirements)
* [Configuration](#configuration)
* [prefix](#prefix)
* [token](#token)
* [minutes_per_check](#minutes_per_check)
* [seconds_between_check](#seconds_between_check)
* [url_params](#url_params)
* [guild_item_limit](#guild_item_limit)
* [cache_limit](#cache_limit)
* [required_perms](#required_perms)
* [tld](#tld)
* [auto_cart_link](#auto_cart_link)
* [debug_enabled](#debug_enabled)
* [Using a proxy list](#proxies)
* [Starting the bot](#starting)
* [Commands](#commands)
* [help](#help)
* [search](#search)
* [details](#details)
* [watch](#watch)
* [watchlist](#watchlist)
* [unwatch](#unwatch)
* [Contributing](#contributing)
# Requirements
- [NodeJS v20 or above](https://nodejs.org/en/)
- [Git](https://git-scm.com/downloads)
- [pnpm](https://pnpm.io/installation) (Optional)
- A [bot user](https://discordjs.guide/preparations/setting-up-a-bot-application.html#creating-your-bot). Ensure it has the "Server Members" and "Message Content" intents enabled in the "Bot" page once it is created.
- The bot files, of course
- You can click the green "Code" button near the top of the GitHub page to download the files as a ZIP. Or, if you're already a `git` user, you probably know how to clone, so just do that.
# Configuration
The project comes with an example configuration you can use as a base. To begin configuring the bot:
1. Copy the `config.example.json` file.
2. Rename it to `config.json`.
3. Begin editing in your favorite text editor.
It may be hard to know exactly what each option does, and what you can set them to, so they are all outlined below.
## prefix
This is the character, or characters, that you will begin every command with. Good examples are `$` or `!`.
## token
The token is the login information of the bot. If you don't know how to set up a bot user, refer to [this guide](https://discordjs.guide/preparations/setting-up-a-bot-application.html#creating-your-bot).
## minutes_per_check
The amount of minutes before each check cycle is run. A good number is around 2 or 3.
## seconds_between_check
The amount of second to pause in between each item in the check cycle. This defaults to 5 seconds, which is a perfectly fine number. If you increase this,
make sure you increase the `minutes_per_check` as well, or else check cycles may overlap and cause issues.
## url_params
If you want to include a referral code or something, you can use this option to add as many as you want. You'll notice the curly braces; inside of those is where you add each parameter. An example would be something like this:
```json
"url_params":{
"ref":"my_ref_code",
"tag":"my_tag"
etc...
}
```
which would produce a link that looks like this:
```https://www.amazon.com/dp/B08L5R1CCC/?ref=my_ref_code&tag=my_tag```
## guild_item_limit
The guild item limit is used to control how many items the bot can keep track of at a time. It's hard to judge what a reasonable number is, so just keep it as low as you can.
## cache_limit
This is the cache limit is the amount of items that will be watched in a category or search query. For example, if set to 10, then only the first 10 results will be tracked when watching an item with `-q` and `-c`.
## required_perms
These are individual permissions, not roles, that a user must have in order to run any of the commands. You can find a reference [here.](https://discord.js.org/#/docs/main/stable/class/Permissions?scrollTo=s-FLAGS)
## tld
A TLD, or *Top-Level Domain*, is the little `.com` or `.ca` of a URL. Each regional Amazon site is given a different TLD, so you can set this to your favorite country's TLD and it will grab Amazon results and data from that site. Some examples are:
* `ca` - Canada
* `co.uk` - UK
* `jp` - Japan
\* Just as a heads up, if you run the `details` or `watch` command on an item listed in a different country, it will not convert it to the correct country.
## auto_cart_link
If you're the efficient type, setting this to `true` will make sure that the links in stock/price notifications will bring you to a page that will automatically add the item to your cart.
## custom_chromium_exec
If you are on a platform that does not properly install Chromium when running `npm install`, you can install Chromium manually, and then set that path here. Most users can just leave this blank
## debug_enabled
If set to `true`, the console window will spit out all kinds of information related to what it's doing, in order to give you a better understanding of what's going on in case you're having trouble.
# Proxies
This is optional, but if you'd like to make use of a proxylist, you simply need to create a file named `proxylist.txt` in the main bot folder. Each ip/url should be separated by a new line. Each one should be formatted like so: `username:password@ip:port`. An example of some are listed below in the same format yours should be listed:
```
http://myuser:[email protected]:12345
http://spikehd:[email protected]:8008
http://amazonuser:[email protected]:2318008
etc...
```
# Starting
To start the bot, simply open a terminal and run these commands:
* Set directory to bot directory:
```sh
cd "C:/Path/To/Bot/Folder"
```
* Install the dependencies (you only have to do this once):
```sh
npm install
```
* Run the main file:
```sh
npm run start
```
To restart the bot after a config change:
* Press Ctrl+C
* Start it the same as before:
```sh
npm run start
```
# Commands
Like explained before, commands can only be run with users that have the permissions in the `required_perms` section of the config. All examples assume a prefix of `!`, but, again, you can set it to whatever you want.
## help
* Format: `help`
* Example: `!help`
This will give you some details on each command.
## search
* Format: `search [query]`
* Example: `!search nintendo+switch`
Allows you to search for items matching a query, just like on the website. Additional actions are available once the list of items is returned, but you can refer to the information there.
## details
* Format: `details [Amazon link]`
* Example: `!details https://www.amazon.com/Beats-Studio3-Wireless-Headphones-Collection/dp/B07HYD4VCW/`
Spits out details on an item from Amazon. Useful in conjunction with `search`.
## watch
* Format: `watch -l [Amazon link]` OR `watch -c [Amazon category]` OR `watch -q [search query]`.
* Extra options:
* `-p [price limit]` - Sets a price limit for the item. If the price drops below this, it will notify you.
* `-e [price percentage]` - Set the difference between the stored price and a new detected price as a percentage before it notifies you. For example, setting this to `25` means the new detected price must be 25% lower than the stored price.
* `-d [difference]` - Set the minimum difference between the stored price and a new detected price before it notifies you. Useful for preventing 5-cent differences.
* Examples:
* `!watch -l https://www.amazon.it/dp/B08C76W2WM/`
* `!watch -c https://www.amazon.ca/b/?_encoding=UTF8&node=677244011`
* `!watch -q iphone+12`
* `!watch -l https://www.amazon.co.jp/-/en/dp/B07D1H7CW3/ -p 6000`
* `!watch -q airpods -e 25`
Adds an item, category, or search query to the watchlist.
## watchlist
* Format: `watchlist`
* Example: `!watchlist`
View your watchlist as a numbered list. Useful for `unwatch`.
## unwatch
* Format: `unwatch [item position in watchlist]`
* Example: `!unwatch 2`
Remove an item from your watchlist.
# Contributing
Wanna add stuff? Sweet! Issues, PRs, etc. are all welcome!