npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

mtg_meta_decks

v1.0.5

Published

Find the most recent meta decks based on the information of the website mtgtop8.com

Downloads

9

Readme

MTG API

black_lotus

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

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

Functions available: {Default} duelCommander() duelCommanderFormat(format) Format Versions: {Default} last3Months: (https://www.mtgtop8.com/format?f=EDH) lastMonths: (https://www.mtgtop8.com/format?f=EDH&meta=115&a=) lastMajorEvents: (https://www.mtgtop8.com/format?f=EDH&meta=130&a=) last12Months: (https://www.mtgtop8.com/format?f=EDH&meta=209&a=) all2023Decks: (https://www.mtgtop8.com/format?f=EDH&meta=252&a=) all2022Decks: (https://www.mtgtop8.com/format?f=EDH&meta=233&a=) all2021Decks: (https://www.mtgtop8.com/format?f=EDH&meta=216&a=) all2020Decks: (https://www.mtgtop8.com/format?f=EDH&meta=198&a=) all2019Decks: (https://www.mtgtop8.com/format?f=EDH&meta=181&a=) all2018Decks: (https://www.mtgtop8.com/format?f=EDH&meta=166&a=) all2017Decks: (https://www.mtgtop8.com/format?f=EDH&meta=146&a=) all2016Decks: (https://www.mtgtop8.com/format?f=EDH&meta=122&a=) all2015Decks: (https://www.mtgtop8.com/format?f=EDH&meta=99&a=) all2014Decks: (https://www.mtgtop8.com/format?f=EDH&meta=129&a=) majorEvents: (https://www.mtgtop8.com/format?f=EDH&meta=196&a=) allCommanderDecks: https://www.mtgtop8.com/format?f=EDH&meta=56&a=)

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

Functions available: {Default} extended() extendedFormat(format) Format Versions: {Default} allDecks: (https://www.mtgtop8.com/format?f=EX) lorwyn: (https://www.mtgtop8.com/format?f=EX&meta=20&a=) timeSpiral: (https://www.mtgtop8.com/format?f=EX&meta=112&a=) mirrodin: (https://www.mtgtop8.com/format?f=EX&meta=111&a=) onSlaught: (https://www.mtgtop8.com/format?f=EX&meta=21&a=) invasion: (https://www.mtgtop8.com/format?f=EX&meta=23&a=) tempest: (https://www.mtgtop8.com/format?f=EX&meta=7&a=) iceAge: (https://www.mtgtop8.com/format?f=EX&meta=41&a=) allPT: (https://www.mtgtop8.com/format?f=EX&meta=94&a=)

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

Functions available: {Default} legacy() legacyFormat(format) Format Versions: {Default} last2Months: (https://www.mtgtop8.com/format?f=LE) majorEvents4months: (https://www.mtgtop8.com/format?f=LE&meta=188&a=) liveTournaments: (https://www.mtgtop8.com/format?f=LE&meta=72&a=) all2023Decks: (https://www.mtgtop8.com/format?f=LE&meta=245&a=) all2022Decks: (https://www.mtgtop8.com/format?f=LE&meta=237&a=) all2021Decks: (https://www.mtgtop8.com/format?f=LE&meta=219&a=) all2020Decks: (https://www.mtgtop8.com/format?f=LE&meta=199&a=) all2019Decks: (https://www.mtgtop8.com/format?f=LE&meta=182&a=) all2018Decks: (https://www.mtgtop8.com/format?f=LE&meta=164&a=) all2017Decks: (https://www.mtgtop8.com/format?f=LE&meta=143&a=) all2016Decks: (https://www.mtgtop8.com/format?f=LE&meta=117&a=) all2015Decks: (https://www.mtgtop8.com/format?f=LE&meta=100&a=) all2014Decks: (https://www.mtgtop8.com/format?f=LE&meta=81&a=) all2013Decks: (https://www.mtgtop8.com/format?f=LE&meta=80&a=) all2012Decks: (https://www.mtgtop8.com/format?f=LE&meta=6&a=) all2011Decks: (https://www.mtgtop8.com/format?f=LE&meta=61&a=) majorEventsDecks: (https://www.mtgtop8.com/format?f=LE&meta=27&a=) allDecks: (https://www.mtgtop8.com/format?f=LE&meta=16&a=)

Modern

Functions available: {Default} modern() modernFormat(format) Format Versions: {Default} last2Months: (https://www.mtgtop8.com/format?f=MO) last2Weeks: (https://www.mtgtop8.com/format?f=MO&meta=54&a=) lastMajorEvents: (https://www.mtgtop8.com/format?f=MO&meta=57&a=) liveTournaments: (https://www.mtgtop8.com/format?f=MO&meta=57&a=) all2023Decks: (https://www.mtgtop8.com/format?f=MO&meta=246&a=) all2022Decks: (https://www.mtgtop8.com/format?f=MO&meta=236&a=) all2021Decks: (https://www.mtgtop8.com/format?f=MO&meta=220&a=) all2020Decks: (https://www.mtgtop8.com/format?f=MO&meta=200&a=) all2019Decks: (https://www.mtgtop8.com/format?f=MO&meta=183&a=) all2018Decks: (https://www.mtgtop8.com/format?f=MO&meta=163&a=) all2017Decks: (https://www.mtgtop8.com/format?f=MO&meta=142&a=) all2016Decks: (https://www.mtgtop8.com/format?f=MO&meta=118&a=) all2015Decks: (https://www.mtgtop8.com/format?f=MO&meta=101&a=) all2014Decks: (https://www.mtgtop8.com/archetype?f=MO&meta=79&a=189) all2013Decks: (https://www.mtgtop8.com/archetype?f=MO&meta=77&a=189) all2012Decks: (https://www.mtgtop8.com/archetype?f=MO&meta=76&a=189) all2011Decks: (https://www.mtgtop8.com/format?f=MO&meta=78&a=) allModernDecks: (https://www.mtgtop8.com/format?f=MO&meta=44&a=) allPt: (https://www.mtgtop8.com/format?f=MO&meta=92&a=)

Pauper

Functions available: {Default} pauper() pauperFormat(format) Format Versions: {Default} last2Months: (https://www.mtgtop8.com/format?f=PAU) last4Months: (https://www.mtgtop8.com/format?f=PAU&meta=127&a=) liveTournaments: (https://www.mtgtop8.com/format?f=PAU&meta=185&a=) all2023Decks: (https://www.mtgtop8.com/format?f=PAU&meta=251&a=) all2022Decks: (https://www.mtgtop8.com/format?f=PAU&meta=239&a=) all2021Decks: (https://www.mtgtop8.com/format?f=PAU&meta=224&a=) all2020Decks: (https://www.mtgtop8.com/format?f=PAU&meta=223&a=) all2019Decks: (https://www.mtgtop8.com/format?f=PAU&meta=186&a=) all2018Decks: (https://www.mtgtop8.com/format?f=PAU&meta=170&a=) all2017Decks: (https://www.mtgtop8.com/format?f=PAU&meta=169&a=) all2016Decks: (https://www.mtgtop8.com/format?f=PAU&meta=168&a=) allPauperDecks: (https://www.mtgtop8.com/format?f=PAU&meta=110&a=)

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

Functions available: {Default} pioneer() pioneerFormat(format) Format Versions: {Default} last2Months: (https://www.mtgtop8.com/format?f=PI) last2Weeks: (https://www.mtgtop8.com/format?f=PI&meta=194&a=) all2023Decks: (https://www.mtgtop8.com/format?f=PI&meta=247&a=) all2022Decks: (https://www.mtgtop8.com/format?f=PI&meta=235&a=) all2021Decks: (https://www.mtgtop8.com/format?f=PI&meta=222&a=) all2020Decks: (https://www.mtgtop8.com/format?f=PI&meta=202&a=) all2019Decks: (https://www.mtgtop8.com/format?f=PI&meta=201&a=) allPioneer: (https://www.mtgtop8.com/format?f=PI&meta=191&a=)

Standard

Functions available: {Default} standard() standardFormat(format) Format Versions: {Default} standardLast2Months: (https://www.mtgtop8.com/format?f=ST) standardLast2Weeks: (https://www.mtgtop8.com/format?f=ST&meta=50&a=) standardLargeEventsLast2Months: (https://www.mtgtop8.com/format?f=ST&meta=46&a=) standardPlayersTourOnline: (https://www.mtgtop8.com/format?f=ST&meta=210&a=) standardAll2023Decks: (https://www.mtgtop8.com/format?f=ST&meta=250&a=) standardAll2022Decks: (https://www.mtgtop8.com/format?f=ST&meta=249&a=) standard2020to2021: (https://www.mtgtop8.com/format?f=ST&meta=217&a=) standard2018To2019: (https://www.mtgtop8.com/format?f=ST&meta=175&a=) standard2019To2020: (https://www.mtgtop8.com/format?f=ST&meta=187&a=) standard2017To2018:(https://www.mtgtop8.com/format?f=ST&meta=161&a=) standard2016To2017: (https://www.mtgtop8.com/format?f=ST&meta=128&a=) standard2015To2016: (https://www.mtgtop8.com/format?f=ST&meta=133&a=) standard2014To2015: (https://www.mtgtop8.com/archetype?f=ST&meta=114&a=12) standard2013To2014: (https://www.mtgtop8.com/archetype?f=ST&meta=86&a=12) standard2012To2013: (https://www.mtgtop8.com/archetype?f=ST&meta=75&a=12) standard2011To2012: (https://www.mtgtop8.com/archetype?f=ST&meta=74&a=12) standard2010To2011: (https://www.mtgtop8.com/archetype?f=ST&meta=45&a=12) allStandard: (https://www.mtgtop8.com/archetype?f=ST&meta=58&a=12) allWorlds: (https://www.mtgtop8.com/archetype?f=ST&meta=97&a=12) allProTour: (https://www.mtgtop8.com/archetype?f=ST&meta=91&a=12) allGrandPrix: (https://www.mtgtop8.com/archetype?f=ST&meta=96&a=12)

Vintage

Functions available: {Default} vintage() vintageFormat(format) Format Versions: {Default} last4Months: (https://www.mtgtop8.com/format?f=VI) last2Months: (https://www.mtgtop8.com/format?f=VI&meta=82&a=) liveTournaments: (https://www.mtgtop8.com/format?f=VI&meta=83&a=) all2023Decks: (https://www.mtgtop8.com/format?f=VI&meta=244&a=) all2022Decks: (https://www.mtgtop8.com/format?f=VI&meta=238&a=) all2021to2020Decks: (https://www.mtgtop8.com/format?f=VI&meta=221&a=) all2019to2018Decks: (https://www.mtgtop8.com/format?f=VI&meta=167&a=) all2017to2015Decks: (https://www.mtgtop8.com/format?f=VI&meta=148&a=) all2014to2011Decks: (https://www.mtgtop8.com/format?f=VI&meta=15&a=) allMajorEvents: (https://www.mtgtop8.com/format?f=VI&meta=40&a=) allDecks: (https://www.mtgtop8.com/format?f=VI&meta=14&a=)

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