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
[!NOTE]
mtg_parserhas been developed with a primary focus on Commander. While it may function with other formats, compatibility is not guaranteed.
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
[!NOTE] As of
mtg_parser="=>0.0.1a50"doesn't provide a default http client anymore.
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
[!IMPORTANT] aetherhub.com requires a Cloudflare-bypass
requestscompatible http client such ascloudscraper.
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
[!IMPORTANT] deckstats.net requires a Cloudflare-bypass
requestscompatible http client such ascloudscraper.
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
[!IMPORTANT] Moxfield.com prohibits scraping their website, as it violates their Terms of Service.
For authorized access, please contact support@moxfield.com to request a custom User-Agent.
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
[!IMPORTANT] mtggoldfish.com requires a Cloudflare-bypass
requestscompatible http client such ascloudscraper.
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.1a57
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.1a57.tar.gz | 16.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mtg_parser-0.0.1a57-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 38.4 kB
Release files / mtg_parser-0.0.1a57.tar.gz
| Download URL | mtg_parser-0.0.1a57.tar.gz |
|---|---|
| Size | 16.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2736740ca48c7fa98882437aee0168c44fd79f62a6da69d5ac40462b36983e2e
|
|
BLAKE2b-256 checksum How to use checksums |
ad0fc7eb9046b03199a48ab1f0252a8e7ab39cf3caaf0306ad1c194415b0ac0f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.14.7 Darwin/23.5.0
|
Release files / mtg_parser-0.0.1a57-py3-none-any.whl
| Download URL | mtg_parser-0.0.1a57-py3-none-any.whl |
|---|---|
| Size | 21.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4f84501ce99bdb7914fb75403252fb9356f203ad6518c510e1ee5bd4129109ed
|
|
BLAKE2b-256 checksum How to use checksums |
57662b4e5e0a750394e94a5573c3299266aea0f90b47ab064a54bb8e800afea1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.14.7 Darwin/23.5.0
|
