Similar cards

A card's details end with two rows of cards picked by their picture. Same artwork lists other printings of the same illustration: reprints such as Base Set 2, Legendary Collection or Celebrations Classic Collection, Trainer Gallery duplicates, and the same card printed in Japanese. Similar look lists the next closest cards by colour and composition. Tap a card to open its details.

The rows use public catalogue data, so they work signed out and on shared binders. They stay hidden while offline, when the lookup fails and for cards that have no picture fingerprint yet (a card needs a mirrored image first).

Pictures are compared with a DINOv3 fingerprint of each card's image. A neighbour counts as the same artwork only when it shows the same subject (the same Pokédex number, or for Trainers and Energy the same name or illustrator), and its illustrator matches with a similarity of at least 0.78, or the pictures are at least 0.92 similar. Template full arts of different Pokémon can look alike, so they appear under Similar look, never Same artwork.

REST and MCPCopy Anchor Link

GET /app/api/v1/cards/{id}/similar?language=en and MCP get_similar_cards with {"id":"base1-4"} return:

{
  "cardId": "base1-4",
  "language": "en",
  "sameArtwork": [{ "similarity": 0.922, "card": { "id": "base4-4", "name": "Charizard", "…": "…" } }],
  "similarLook": [{ "similarity": 0.805, "card": { "id": "dp3-16", "name": "Raikou", "…": "…" } }]
}

Each card is the same record get_card returns, in the language of the matching print, so Japanese prints come back with Japanese names. similarity is the cosine similarity of the two pictures, from 0 to 1. Both lists are empty when the card has no fingerprint yet, and an unknown card ID returns 404 not_found. Same artwork returns at most 24 cards and Similar look at most 12.

Suggestions for a binder pageCopy Anchor Link

Tapping an empty pocket that isn't kept for a Pokémon or a card opens the card picker. Turn on the sparkle button in its search box to see cards that would fit the page while the search is empty. The choice is remembered on the device, and typing a search shows the usual results. Suggestions need a connection; offline the picker only searches.

Cards that look like several cards on the page come first: each page card's Similar look neighbours (never other printings of the same artwork) add up their similarity. The list is then filled with cards sharing a Pokémon, illustrator, energy type or set with the page, which also covers cards that have no fingerprint yet. Cards already in the binder are left out.

POST /app/api/v1/cards/suggest and MCP suggest_cards take the page's cards and return the same list, at most 60 cards, most alike first:

{ "cardIds": ["base1-4", "base1-2"], "pokemon": [25], "language": "en" }

{ "language": "en", "cards": [{ "id": "base4-12", "name": "Nidoqueen", "…": "…" }] }

pokemon adds Pokédex numbers for pockets kept for a Pokémon without a card. Each card is the record get_card returns. The given cards are never returned; leave out any other cards you already have yourself.