This release is a pre-release and may not be stable for production use.
mtg-parser
mtg_parser is a Python library to download and parse Magic: The Gathering decklists.
It supports the MTGO/MTGA formats as well as the most popular deck building websites.
Table of contents
Installation
The following section covers the installation of mtg_parser.
Before using mtg_parser, you will need:
python>=3.9
To install mtg_parser, simply run one of the following commands in the terminal of your choice:
$ pip install mtg-parser
# or
$ uv add mtg-parser
# or
$ poetry add mtg-parser
Supported Formats
In addition to MTGO and MTGA formats, mtg_parser supports the following websites:
- aetherhub.com
- archidekt.com
- deckstats.net
- moxfield.com
- mtggoldfish.com
- mtgjson.com
- scryfall.com
- tappedout.net
- tcgplayer.com
Known issues
Parsing decklists on some websites require specific configuration.
- The following websites require a Cloudflare-bypass
requestscompatible http client such ascloudscraper: - moxfield.com requires a custom User-Agent (see here)
Usage
QuickStart
To parse a decklist with mtg_parser, you need to provide an HTTP client that implements a requests compatible interface (such as requests or httpx).
import requests
import mtg_parser
cards = mtg_parser.parse_deck(url, requests.Session())
For conveniency, mtg_parser provides an optional HttpClientFacade to facilitate handling of different websites with different http clients.
import cloudscraper
import httpx
import mtg_parser
client_facade = mtg_parser.HttpClientFacade(httpx.Client(timeout=10.0))
client_facade.set_override('aetherhub.com', cloudscraper.create_scraper())
client_facade.set_override('moxfield.com', httpx.Client(
timeout=10.0,
headers={'User-Agent': os.getenv('MOXFIELD_USER_AGENT')},
))
cards = mtg_parser.parse_deck(url, client_facade)
Return format
parse_deck() returns an Iterable[Card] matching the following description
class Card:
name: str
quantity: int
extension: Optional[str]
number: Optional[str]
tags: Iterable[str] = []
cards = mtg_parser.parse_deck(url, http_client)
for card in cards:
print(card)
Parsing MTGO / MTGA
mtg_parser can parse textual decklists in either MTGO or MTGA format
import mtg_parser
decklist = """
1 Atraxa, Praetors' Voice
1 Imperial Seal
1 Lim-Dûl's Vault
1 Jeweled Lotus (CMR) 319
1 Llanowar Elves (M12) 182
3 Brainstorm #Card Advantage #Draw
"""
cards = mtg_parser.parse_deck(deck_list)
Parsing from aetherhub.com
mtg_parser can parse public decks from aetherhub.com
import cloudscraper
import mtg_parser
url = 'https://aetherhub.com/Deck/<deck_name>'
cards = mtg_parser.parse_deck(url, cloudscraper.create_scraper())
Parsing from archidekt.com
mtg_parser can parse public decks from archidekt.com
import requests
import mtg_parser
url = 'https://www.archidekt.com/decks/<deck_id>/'
cards = mtg_parser.parse_deck(url, requests.Session())
Parsing from deckstats.net
mtg_parser can parse public decks from deckstats.net
import cloudscraper
import mtg_parser
url = 'https://deckstats.net/decks/<user_id>/<deck_id>'
cards = mtg_parser.parse_deck(url, cloudscraper.create_scraper())
Parsing from moxfield.com
mtg_parser can parse public decks from moxfield.com
import httpx
import mtg_parser
url = 'https://www.moxfield.com/decks/<deck_id>'
headers = {'user-agent': '<MOXFIELD_USER_AGENT>'}
with httpx.Client(headers=headers) as http_client:
cards = mtg_parser.parse_deck(url, http_client)
Parsing from mtggoldfish.com
mtg_parser can parse public decks from mtggoldfish.com
import cloudscraper
import mtg_parser
url = 'https://www.mtggoldfish.com/deck/<deck_id>'
cards = mtg_parser.parse_deck(url, cloudscraper.create_scraper())
Parsing from mtgjson.com
mtg_parser can parse decks from mtgjson.com
import requests
import mtg_parser
url = 'https://mtgjson.com/api/v5/decks/<deck_name>.json'
cards = mtg_parser.parse_deck(url, requests.Session())
Parsing from scryfall.com
mtg_parser can parse public decks from scryfall.com
import requests
import mtg_parser
url = 'https://scryfall.com/<userid>/decks/<deck_id>/'
cards = mtg_parser.parse_deck(url, requests.Session())
Parsing from tappedout.net
mtg_parser can parse public decks from tappedout.net
import requests
import mtg_parser
url = 'https://tappedout.net/mtg-decks/<deck_id>/'
cards = mtg_parser.parse_deck(url, requests.Session())
Parsing from tcgplayer.com
mtg_parser can parse public decks from either tcgplayer.com or infinite.tcgplayer.com
import requests
import mtg_parser
url = 'https://www.tcgplayer.com/content/magic-the-gathering/deck/<deck_name>/<deck_id>'
# or url = 'https://infinite.tcgplayer.com/magic-the-gathering/deck/<deck_name>/<deck_id>'
cards = mtg_parser.parse_deck(url, requests.Session())
1 maintainer
Metadata
1 maintainer
Release files for mtg_parser 0.0.1a59
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mtg_parser-0.0.1a59.tar.gz | 16.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mtg_parser-0.0.1a59-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 38.4 kB
Release files / mtg_parser-0.0.1a59.tar.gz
| Download URL | mtg_parser-0.0.1a59.tar.gz |
|---|---|
| Size | 16.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d1529fb45b2b2921c1ff182abee2adc6205732ebd6a587aa55d073bf881234bb
|
|
BLAKE2b-256 checksum How to use checksums |
ecedc5fdf9693876c93ddc4d7481aafb4378b070cb93ab6acd9902184d7bc1d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.2 CPython/3.14.7 Darwin/23.5.0
|
Release files / mtg_parser-0.0.1a59-py3-none-any.whl
| Download URL | mtg_parser-0.0.1a59-py3-none-any.whl |
|---|---|
| Size | 21.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5edaf4652b6673343f9078b7c1fc6799a3ebaaaf3f0f8cb8cb4e9bba6f77971f
|
|
BLAKE2b-256 checksum How to use checksums |
791e6384f7d648111e3aaa8d589b0b26d07a353bd6514331be94bf952f733242
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.2 CPython/3.14.7 Darwin/23.5.0
|
