Supported games and sources

Installed catalog IDs

Use exact game IDs in CSV files, API requests and CLI commands.

ID	Catalog	Principal implemented data paths
mtg	Magic: The Gathering	Scryfall primary catalog; MTGJSON cross-checking
pokemon	Pokémon TCG international	TCGdex; international language coverage
pokemon-asia	Pokémon TCG Asia	TCGdex, Korean dataset, official Japanese/Asian/Korean searches
pokemon-china	Pokémon TCG China	Simplified Chinese dataset
sorcery	Sorcery: Contested Realm	Sorcery catalog API; image-folder import support
riftbound	Riftbound	Riot content API when configured; Riftcodex fallback and official gallery
yugioh	Yu-Gi-Oh! TCG	YGOPRODeck and YGOJSON
yugioh-ocg	Yu-Gi-Oh! OCG	YGOJSON with official Konami gap filling
lorcana	Disney Lorcana	LorcanaJSON

This is implemented integration coverage, not a guarantee that every historical card, language, printing or price exists upstream. One Piece is not a registered provider at this revision.

Languages and regional catalogs

International Pokémon defaults to English, French, German, Italian, Spanish and Portuguese. Asia includes Japanese, Korean, Traditional Chinese, Thai and Indonesian source paths. China covers Simplified Chinese independently. TCGdex language lists and optional official crawlers are configurable.

Yu-Gi-Oh! TCG defaults to English, French, German, Italian, Portuguese and Spanish. OCG includes Japanese, Korean, Chinese scripts and Asian English. A printed language alone may not identify the market; use the actual edition.

Magic uses Scryfall's configured bulk catalog; all_cards preserves broader localized name coverage. default_cards is smaller but reduces non-English matching. Sorcery is declared English-only. Lorcana imports the languages supplied by its integration, including English, French, German and Italian. Riftbound declares English and Simplified Chinese in the reviewed provider.

Supplemental sources

Generic catalog plugins include tcgcsv, tcgapi_eu, apitcg and cardnexus. They fill missing data and market IDs rather than replacing the primary source indiscriminately. Some require keys and have request budgets.

The CardNexus source can add missing printings and CardNexus prices, and can fill Cardmarket/TCGplayer quote gaps. Its integration does not cover all Asian Pokémon markets. Configuring a key does not imply a price for every card.

Price availability

Providers advertise their source capabilities through /api/games; external price plugins can add capabilities. Pokémon China and Yu-Gi-Oh! OCG have no built-in provider price sources in this revision. Displayed support is distinct from a non-null quote for a particular printing.

Optional Riot key

Riftbound works without a Riot key through its fallback paths. Set TCG_APITOKEN_GAMES_RFB_RIOT only for an approved key suitable for the Riftbound endpoint; a generic development key may be refused. Check current Riot portal requirements directly before applying. The repository's docs/riftbound.md gives deployment-specific background, but provider terms and external quotas can change.

Source access and rights

Catalog/image/market data remains subject to the respective source's terms and publisher rights. Source support in Zukan does not grant redistribution rights. In particular, the environment example flags the mainland Chinese Pokémon dataset as non-commercial. Check current upstream licensing before public redistribution or commercial use.

See Configuration reference, Synchronization and Data checks.

Implementation references

• backend/pyproject.toml
• .env.example
• backend/app/games/base.py

Finish codes for CSV and API use

These are the reviewed provider vocabularies. Each printing can support only a subset; query its actual finishes before adjusting stock. Pokémon regional catalogs share the Pokémon vocabulary, and Yu-Gi-Oh! markets share its vocabulary. Rarity and finish are separate fields: for Yu-Gi-Oh!, rarity is represented by the printing while finish distinguishes edition categories.

Provider family	Code	Label
mtg	nonfoil	Standard
mtg	foil	Foil
mtg	etched	Etched foil
pokemon	normal	Standard
pokemon	holo	Holo
pokemon	reverse	Reverse holo
pokemon	first_edition	1st edition
sorcery	standard	Standard
sorcery	foil	Foil
sorcery	rainbow	Rainbow foil
riftbound	normal	Normal
riftbound	foil	Foil
yugioh	unlimited	Unlimited
yugioh	first	1st Edition
yugioh	limited	Limited Edition
lorcana	normal	Normal
lorcana	foil	Foil