Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/roedesh/superrarebot

Discord bot that shares updates from SuperRare
https://github.com/roedesh/superrarebot

discord discord-py superrare

Last synced: 28 days ago
JSON representation

Discord bot that shares updates from SuperRare

Host: GitHub
URL: https://github.com/roedesh/superrarebot
Owner: roedesh
License: mit
Created: 2021-10-31T19:15:23.000Z (about 3 years ago)
Default Branch: main
Last Pushed: 2021-10-31T19:16:06.000Z (about 3 years ago)
Last Synced: 2024-10-25T06:50:40.510Z (3 months ago)
Topics: discord, discord-py, superrare
Language: Python
Homepage:
Size: 163 KB
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# SuperRareBot

![Example Discord message](screenshot.png?raw=true "Example Discord message")

## Prerequisites

- Python 3.9
- [Poetry](https://python-poetry.org/)
- [Firefox](https://www.mozilla.org/en-GB/firefox/)
- [Gecko Driver](https://github.com/mozilla/geckodriver/releases) is available in your PATH

## Installation

Install dependencies using `poetry install`.

Create an `.env` file in the root of this repository. Here is an example:

```
# Required
DISCORD_BOT_TOKEN = r4EqT6uYIoghdb634GdfgvweFDgrter
DISCORD_CHANNEL_ID = 001122334455667788
DISCORD_SERVER_ID = 887766554433221100
SUPERRARE_ARTIST = bottoproject

# Optional
UPDATE_INTERVAL = 5
```

When you have created your `.env` file, run the bot using `poetry run python main.py`

By default the bot will check for updates every 5 minutes. This can be configured by changing the value of `UPDATE_INTERVAL`.

## How it works

This bot will periodically fetch the latest SuperRare data from an artist of your choice using a headless browser. It will then compare this data to the locally stored data (`db.json`). If there is new data available, messages will be sent to a Discord channel of your choice to notify everyone of updates (new bids, auction ended, etc).

## Why was this created

To notify members of the [Botto](https://botto.com/) Discord when new bids have been placed, auctions had started or ended, or when new pieces have been minted. However, the bot is written in such a way that it can be used for any SuperRare artist.