MTG Gatherer Search

A simple search for getting card info form search on Gatherer.

What is this?

MTG Gatherer Search is a simple search module that I use in my card database project. It scrapes search results from Magic: The Gathering Gatherer portal for searching cards. It returns a json that contains essential card info: name, mana cost, image url and multiverse id. It's written in JavaSciprt as a module that can be used in Node.js or web frameworks.

Usage

You can install mtg-gatherer-search via npm or yarn or any other Node.js package manager that connects to npm repository.

Install

$ npm i -P mtg-gatherer-search

or with Yarn

$ yarn add mtg-gatherer-search

Import

Once module is installed just import it into your JS file.

const mtgGathererSearch = require('mtg-gatherer-search');

// Or in ES6

import * as mtgGathererSearch from 'mtg-gatherer-search';

Scrape

Now just call the function and get your search results in a json.

const result = await mtgGathererSearch('black');

/*
[
	{
		title: 'Black Lotus',
		mana: {
			Any: 0,
			Red: 0,
			White: 0,
			Green: 0,
			Blue: 0,
			Black: 0,
			Artifact: 0,
			Total: 0
		},
		imageUrl: 'http://gatherer.wizards.com/Handlers/Image.ashx?multiverseid=382866&type=card',
		multiverseId: 382866
	},
	...
]

*/

License

MIT © Dušan Simić