Skip to content

Latest commit

 

History

History
95 lines (80 loc) · 3.6 KB

README.md

File metadata and controls

95 lines (80 loc) · 3.6 KB

MyAnimeList-discord-bot

A python bot made to surf MyAnimeList website from discord.

Overview

A discord bot made to surf the MyAnimeList website on discord with the help of the Jikan REST API. View the information about any anime, manga, character etc. using advanced search commands. Look into the pictures of your favourite character from any anime or manga using a single search command. View the anime/manga lists and profile of users.

Planned

Commands Description
+top <type> To view rankings of characters, animes and mangas.

Commands

Search

Commands Description Examples
+anime <name> Get information about an anime. +anime Hyouka, +anime NHK ni Youkoso!
+manga <name> Get information about a manga. +manga attack on titan, +manga Omniscient Reader

Screenshot

anime search

Character

Commands Description Examples
+char <name> Get Information about the requested character. +character Mikasa, +char Oreki
+images <name> Get images for the requested character. +images Mikasa, +im Eru Chitanda

Screenshots

char search char images

User

Command Brief Flags
+user <name> Shows information about an user. manga
reading
plantoread
completed
dropped
onhold
plantowatch
watching

Usage

+user <name> [--manga] [--reading] [--ptr] [--completed] [--dropped] [--onhold] [--ptw] [--watching]

Description

  • Shows detailed information about MyAnimeList user's list or sends you the general profile information about their profile.
  • Use flag --m or --manga to specify if you need manga list of a particular status.
  • For example, if you want to look into completed manga(s) of user wildcyclotron:
+user wildcyclotron --completed --m
  • For flags like --reading or --ptr(or --plantoread), you may or may not pass the --manga because it's obvious that they belong to manga list.
  • The position of flags doesn't matter i.e --dropped --m is same as --m --dropped

Examples

+user wildcyclotron
+user wildcyclotron --watching
+u wildcyclotron --completed 
+u wildcyclotron --onhold
+u wildcyclotron --ptw
+u wildcyclotron --dropped
+u wildcyclotron --completed --m
+u wildcyclotron --dropped --m
+u wildcyclotron --onhold --m
+u wildcyclotron --reading
+u wildcyclotron --ptr

Screenshots

user info user status

Installing

  • Make sure to get Python 3.8 or higher.

  • Set up venv

python3.8 -m venv venv
  • Install dependencies
pip install -U -r requirements.txt
  • To install the development version, do the following:
$ git clone https://github.com/WildCyclotron/MyAnimeList-discord-bot.git

Running

  • Edit main.py and replace the 'Token' with the your bot's actual token.
  • Save your changes and run the main.py file.
python main.py 

DISCLAIMER

Please be respectful towards MyAnimeList's Terms Of Service.