Now shipping 1.0

Walk into your next card show with a plan, not a hope.

mgz-pkmn turns a list of cards you want into a printable binder with thumbnails, market prices, and your negotiation floor. Built for collectors who'd rather show up informed than wing it on convention center Wi-Fi.

Try the live demo View on GitHub 
# 1. Write your want-list
$ cat input/wants.txt
top 5 Mew cards under $50
all Charizard cards | japanese
rest of Surging Sparks

# 2. Run the tool
$ pkmn lookup input/ -o output/cards.xlsx \
    --pdf output/binder.pdf --checklist output/checklist.pdf

→ output/cards.xlsx, binder.pdf, checklist.pdf

Everything you need at the table.

One pipeline, three open data sources, every output format that's useful for prepping a card show.

  • Multi-source pricing

    Layered lookup across pokemontcg.io (TCGPlayer + Cardmarket), TCGdex for international cards, and PriceCharting for region-exclusive products. Always negotiating from the same data the seller sees.

  • Built for want-lists

    Bulk syntax like top:5 Charizard cards or all Pikachu prints, inline price filters, language tokens. Describe what you're hunting, not every card name.

  • Negotiation comps

    Every row carries 80, 85, 90, and 95 percent of market. Your floor and ceiling are on the page when you sit down at the table.

  • See what you're hunting

    Thumbnails embedded directly in the spreadsheet and PDF binder. Recognize the right printing across a glass case at ten feet.

  • Print and go

    xlsx with totals and per-tag sections, PDF binder pages (3×3 standard or 6×4 condensed), set-completion checklist, structured JSON report. Take the formats you actually use.

  • Multilingual

    Japanese, Korean, Simplified and Traditional Chinese, German, French, Spanish, Italian, Portuguese, and more — automatic fallback when a card isn't indexed in English-only sources.

Three steps from idea to show floor.

Designed for the buyer's workflow first — but the same pipeline produces a seller's inventory sheet when you bring binders to the table.

  1. 01

    Write your want-list

    Plain text. One card per line. Use shortcuts like top 5 Mew | base set under $50 or all charizard cards | japanese — the parser does the rest.

  2. 02

    Run the tool

    pkmn lookup input.txt -o cards.xlsx --pdf binder.pdf --checklist checklist.pdf. Or open the web UI and paste your list — same pipeline, no install.

  3. 03

    Walk in informed

    Open the xlsx for live reference, hand the printable binder to the vendor, tick cards off the checklist as you find them. Negotiate from facts.

Where it's going.

Roadmap organized by area — lookup, outputs, cache, web, devops. Speculative ideas live in the full roadmap; the committed work is below.

  • 1.0 — Shipped

    Multi-source lookup, full output suite, web UI, complete release engineering. The defensible 1.0 with no obvious gaps.

    View milestone →
  • 1.1 — In flight

    Polish and on-ramp: starter-issue curation, CITATION.cff, docs troubleshooting, py.typed marker, Discussions visibility. Open to first-time contributors.

    View milestone →
  • 2.0 — Next major

    Structured query DSL, eBay sold-listings, type-aware search, LRU cache with eviction, persistent run history, PyPI + Docker publishing, OpenAPI client codegen.

    View milestone →

Full roadmap (including post-V2 monetization and V3+ proposals) lives in the repo.