MTG API

Introduction

Hello, this project entails me making a web scrapper for the website MTG Top 8. The website entails a list of the current meta decks used in the different game modes in the popular trading card game, Magic the Gathering (Note that I am going to call these game modes formats from here on out). The data being scrapped is a list of meta decks in the formats of Standard, Modern, Vintage, Legacy, Canadian Highlander, Alchemy, Block, Duel Commander, Explorer, Extended, Highlander, Historic, Pauper, Peasant, and Pioneer. (cEDH web scrapper doesn't work currently without the need of a database to store the information. Look at the github for a guideline on how to create your own version)

Installation

npm install mtg_meta_decks

How to use this library

This library is separated by each of the formats, so if a user wants to access a specific format such as this:

const deck = require('mtg_meta_decks');

async function start(){
    let check = await deck.historic.historic();
    console.log(check);
}
start();

Simply replace historic for the format that you want and historic() for the function that you want to use in the historic file.

Formats and their functions

Each format in the website mtgtop8.com has different versions that a user can access. That is why most of the files in this library have 2 functions to access the data in a given format, one for a default version if you don't care, and one where you can specify which version that you want. Some formats have versions that simply didn't have enough information that I couldn't add it to the list. If this changes please send a github issue or a pull request so that I can fix it. Below you will see a list of all of the formats with links to there functions and the list of versions that are available. I will in the future add links to each version for the user to be able to see it in the original website.

Alchemy
Block
Canadian Highlander
Duel Commander
Explorer
Extended
Highlander
Historic
Legacy
Modern
Pauper
Peasant
Pioneer
Standard
Vintage

Alchemy

Functions available:
{Default} alchemy()
Format Versions:
{Default} All Alchemy Decks: (https://www.mtgtop8.com/format?f=ALCH)

Block

Functions available:
{Default} block()
{Format Version} blockFormat(format)
Format Versions:
{Default Version} khanBlock: (https://www.mtgtop8.com/format?f=BL)
otherBlockEvents: (https://www.mtgtop8.com/format?f=BL&meta=229&a=)
therosBlock: (https://www.mtgtop8.com/format?f=BL&meta=68&a=)
returnToRavnicaBlock: (https://www.mtgtop8.com/format?f=BL&meta=60&a=)
innistradBlock: (https://www.mtgtop8.com/format?f=BL&meta=17&a=)
scarsBlock: (https://www.mtgtop8.com/format?f=BL&meta=18&a=)
allPT: (https://www.mtgtop8.com/format?f=BL&meta=93&a=)

Canadian Highlander

Functions available:
{Default} canadianHighlander()
Format Versions:
{Default} All Canadian Highlander Decks: (https://www.mtgtop8.com/format?f=CHL)

Duel Commander

Explorer

Functions available:
last4Months()
allExplorerDecks()
Format Versions: last4Months: (https://www.mtgtop8.com/format?f=EXP)
allExplorerDecks: (https://www.mtgtop8.com/format?f=EXP&meta=243&a=)

Extended

Highlander

Functions available:
{Default} highlander()
highlanderFormat(format)
Format Versions:
{Default} last24Months: (https://www.mtgtop8.com/format?f=HIGH)
allDecks2014to2017: (https://www.mtgtop8.com/format?f=HIGH&meta=90&a=)
allDecks2005to2013: (https://www.mtgtop8.com/format?f=HIGH&meta=89&a=)
allHighlanderDecks: (https://www.mtgtop8.com/format?f=HIGH&meta=88&a=)
allGP: (https://www.mtgtop8.com/format?f=HIGH&meta=116&a=)

Historic

Functions available:
{Default} historic()
historicFormat(format)
Format Versions:
{Default} last2Months:(https://www.mtgtop8.com/format?f=HI)
all2023Decks:(https://www.mtgtop8.com/archetype?f=HI&meta=248&a=971)
all2022Decks:(https://www.mtgtop8.com/archetype?f=HI&meta=234&a=971)
all2021Decks:(https://www.mtgtop8.com/archetype?f=HI&meta=218&a=971)
allHistoricDecks:(https://www.mtgtop8.com/archetype?f=HI&meta=215&a=971)

Legacy

Modern

Pauper

Peasant

Functions available:
{Default} peasant()
peasantFormat(format)
Format Versions:
{Default} allPeasantDecks: (https://www.mtgtop8.com/format?f=PEA&meta=205&a=)
banlistE7: (https://www.mtgtop8.com/format?f=PEA&meta=225&a=)
banlistE6toE5: (https://www.mtgtop8.com/format?f=PEA&meta=207&a=)
banlistE4: (https://www.mtgtop8.com/format?f=PEA&meta=179&a=)
banlistE3: (https://www.mtgtop8.com/format?f=PEA&meta=124&a=)
banlistE2: (https://www.mtgtop8.com/format?f=PEA&meta=151&a=)
banlistE1: (https://www.mtgtop8.com/format?f=PEA&meta=150&a=)

Pioneer

Standard

Vintage

Github project link: https://github.com/Vince-maple-byte/MTG-API
Npm package: https://www.npmjs.com/package/mtg_meta_decks?activeTab=readme

vince-maple-byte / mtg-api Goto Github PK

mtg-api's Introduction