## AntCheckBot

AntCheckBot is a versatile, multilingual Discord bot that monitors the availability of ant species in numerous online shops and automatically notifies you as soon as your desired species become available.  
The bot uses the [AntCheck API](https://antcheck.info/api) and offers extensive management, blacklist, shop rating, and statistics features[1].

[Invite Bot](https://discord.com/oauth2/authorize?client_id=1359846733059850442&permissions=2147601408&integration_type=0&scope=bot)  
[Join Test Server](https://discord.gg/cYtz52MXph)

---

## **Features & Commands**

### **Notifications & Management**

- `/notification` – Set up a notification for an ant species in specific regions (with validation, personal shop blacklist, and optional "force" mode).
- `/delete_notifications` – Delete multiple notifications by their ID.
- `/history` – View your notifications, grouped by status (active, completed, expired).
- `/testnotification` – Test private message notifications.
- **Personal Shop Blacklist:**  
  - `/usersetting blacklist_add shop:<Shopname>` – Add a shop to your blacklist  
  - `/usersetting blacklist_remove shop:<Shopname>` – Remove a shop from your blacklist  
  - `/usersetting blacklist_list` – View your blacklist  
  - `/usersetting shop_list` – View all available shops (including ratings and region filter)

### **Statistics, System & Shop Ratings**

- `/stats` – Shows statistics about active, completed, expired, and deleted notifications as well as the top 5 most requested species (admin/mod only).
- `/system` – Displays uptime, database integrity, total number of notifications, and shop data file status (admin/mod only).
- **Shop Ratings:** Shop ratings are automatically imported from Google Sheets and displayed.

### **Languages & Settings**

- `/startup` – Set the language & default channel for the server (admin/mod only).
- `/usersetting` – Manage your personal settings: language, shop blacklist, and more.

### **Additional Admin Commands**

- `/reloadshops` – Reload shop data (admin/mod only).

### **Help**

- `/help` – Lists all available commands and their descriptions.

---

## **Automated Tasks**

- **Regular Availability Checks:** All active notifications are checked every 5 minutes, and notifications are sent when available (your blacklist is respected).
- **Daily Cleanup:** Notifications older than one year are archived and you are notified.
- **Shop Data Reload:** Shop data is automatically updated every hour.
- **Shop Ratings Sync:** Ratings are imported from Google Sheets every 48 hours.
- **Automatic Bot Status Display:** Uptime, server, and user count are shown live in the bot status.

---

**AntCheckBot** is open source, supports English, German, and Esperanto, and can easily be invited to your server!

[AntCheck API](https://antcheck.info/api) | [Invite Bot](https://discord.com/oauth2/authorize?client_id=1359846733059850442&permissions=2147601408&integration_type=0&scope=bot) | [Test Server](https://discord.gg/cYtz52MXph)

AntCheckBot

AntCheckBot is a Python-based Discord bot that monitors the availability of ant colonies on various online stores and sends notifications.

التصويت لـAntCheckBot

هل ترغب في دعمنا؟