crisefd / mal_wrapper

My Anime List Scrapper

MalScrapper

My Anime List scrapper

Checkout MAL page here

Installation

If available in Hex, the package can be installed by adding mal_scrapper to your list of dependencies in mix.exs:

def deps do
  [
    {:mal_scrapper, "~> 0.1.0"}
  ]
end

Usage

Get top animes

  MalScrapper.get_top_anime <TYPE>

<TYPE> can have take these values: :airing, :upcoming, :tv, :movie, :ova, :special, :bypopularity, :favorite

Output

[
  %{
    details: %{
      aired: "Apr 2009 - Jul 2010",
      episodes: "TV (64 eps)",
      members: "1,533,286 members"
    },
    name: "Fullmetal Alchemist: Brotherhood",
    rank: 1
  },
  %{
    details: %{
      aired: "Apr 2011 - Sep 2011",
      episodes: "TV (24 eps)",
      members: "1,271,215 members"
    },
    name: "Steins;Gate",
    rank: 2
  },
...
]

Get anime by genre

  MalScrapper.get_anime_by_genre <GENRE_NAME>

<GENRE_NAME> cant take these values: :Action, :Adventure , :Cars , :Comedy , :Dementia, :Demons , :Drama , :Ecchi , :Fantasy , :Game , :Harem, :Hentai , :Historical , :Horror , :Josei , :Kids , :Magic, :"Martial Arts", :Mecha , :Military , :Music , :Mystery, :Parody , :Police , :Psychological , :Romance , :Samurai, :School , :"Sci-Fi" , :Seinen , :Shoujo , :"Shoujo Ai", :Shounen, :"Shounen", :"Shounen Ai", :"Slice of Life", :Space, :Sports, :"Super Power", :Supernatural, :Thriller, :Vampire, :Yaoi , :Yuri

Output

[
...
%{
    description: "Yato and Yukine have finally mended their relationship as god and Regalia, and everyone has returned to their daily life. Yato remains a minor and unknown deity who continues taking odd jobs for five...read more.",
    metadata: [
      type: "TV",
      episodes: "13",
      score: "8.38",
      start_date: "10-03-15",
      members: "714,152"
    ],
    name: "Noragami Aragoto"
  },
  %{
    description: "As summer arrives for the students at UA Academy, each of these superheroes-in-training puts in their best efforts to become renowned heroes. They head off to a forest training camp run by UA's pro he...read more.",
    metadata: [
      type: "TV",
      episodes: "25",
      score: "8.61",
      start_date: "04-07-18",
      members: "701,529"
    ],
    name: "Boku no Hero Academia 3rd Season"
  },
  ...
]

Search

  MalScrapper.search <TYPE> <TERM>

<GENRE_NAME> Can take these values: :all :anime :character :person :manga :news :featured :forum :club :user

<TERM> can be any string

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/mal_scrapper.