Scanner webcam de cartes Magic (communes / unco, VO ou VF, foil ou non, NM) puis export du stock vers TCG Powertools, qui met les cartes en vente sur Cardmarket (0,20 € par défaut, prix modifiable au scan).
| Étape | Outil |
|---|---|
| Capture | Webcam dans le navigateur (interface locale FastAPI) |
| Détection + redressement de la carte | OpenCV (contour du bord noir, agrandi jusqu'au bord extérieur sur les cartes noires, perspective -> 630×880) ; si le bord se fond dans l'ombre, la carte est retrouvée par son texte (titre + ligne du bas lus sur l'image entière, remise droite si la carte est couchée) |
| Lecture du nom / numéro / code d'édition | RapidOCR (PaddleOCR en ONNX, gère les accents) |
| Identification | Recherche floue du nom VO et VF dans la base Scryfall (all_cards), puis choix de l'impression : symbole d'édition + cadre (comparaison avec les images Scryfall), numéro de collection, code d'édition (cadres récents), cohérence de langue |
| Référentiel Cardmarket | Fichiers publics products_singles et price_guide (S3 Cardmarket) + slugs officiels des extensions lus sur cardmarket.com |
| Mise en vente | Export CSV vers TCG Powertools |
Une impression = la fiche anglaise Scryfall (qui porte le cardmarket_id). L'inventaire est une ligne par
(impression, langue, état, prix, foil) avec une quantité : scanner deux fois la même carte incrémente la quantité.
Python 3.12 ou plus récent.
python -m venv .venv
.\.venv\Scripts\activate
pip install -e ".[dev]"
magicscanner import # ~400 Mo Scryfall + catalogue Cardmarket (quelques minutes)
magicscanner sync-expansions # slugs officiels des extensions (ouvre Chrome, sert aux liens Cardmarket)Relancer import de temps en temps pour les nouvelles éditions (puis sync-expansions si une extension est sortie).
Les prix tendance se mettent à jour tout seuls au lancement du serveur (en arrière-plan, si le guide a plus de 6 h),
et à la demande depuis l'interface (bouton « Prix tendance ↻ »).
magicscanner serveOuvre http://127.0.0.1:8765. Choisir la webcam (la caméra virtuelle Elgato est écartée par défaut). Sous l'aperçu : zoom, « Cadrer », ↻ (tourne l'aperçu de 90°), « Autofocus » (relance la mise au point), « Figer le focus » (la verrouille) et « Relancer » (le flux). Dans l'aperçu : molette = zoom, glisser = déplacer la vue, clic = centrer ici. Zoomé, seule la zone affichée (plus une marge) est analysée : le tapis, la boîte et les cartes voisines ne gênent plus la détection. Sans zoom, la reconnaissance reçoit l'image entière.
Carte en paysage : poser la carte couchée, titre vers la gauche de l'image, et mettre l'aperçu à 90° (↻). La rotation indique aussi au serveur le sens attendu de la carte (détection plus rapide et plus fiable) ; titre à droite, elle est quand même reconnue grâce à une relecture à 180°, un peu plus lente. Une carte posée dans l'autre sens que l'aperçu (↻ oublié) est en général trouvée quand même, sauf une carte droite petite dans une image non zoomée avec l'aperçu tourné : son contour ressemble alors au cadre d'une illustration couchée (zoomer ou remettre l'aperçu droit).
| Touche | Action |
|---|---|
Espace |
scanne la carte (elle est ajoutée au stock immédiatement) |
Échap / Retour arrière |
annule le dernier scan ; chaque appui remonte d'un scan |
+ / « Encore une » |
ajoute un exemplaire de plus de la dernière carte (même impression, langue, finition, prix) sans la scanner |
1–9 / clic |
corrige : remplace par une autre impression proposée |
L |
bascule VO / VF |
F |
coche / décoche « Foil » |
/ |
recherche manuelle par nom (VO ou VF) si la reconnaissance échoue (barre en haut de page) |
Foil et prix : la case « Foil » et le champ « Prix » (0,20 € par défaut, MS_PRICE) s'appliquent aux scans suivants,
et à la dernière carte scannée si on les change juste après. Un foil, ou une carte à un autre prix, forme sa propre ligne
de stock. Une impression qui n'existe pas dans la finition scannée n'est jamais choisie (foil-only pour une carte non-foil
et inversement).
Édition fixée : pour un paquet d'une seule édition, le champ « Édition » (touche E, nom ou code de l'édition) limite
la reconnaissance aux cartes de cette édition, avec leurs noms VO comme VF. C'est plus rapide (seules ses impressions sont comparées)
et il y a moins de confusions possibles. Une carte d'une autre édition glissée dans le paquet est quand même reconnue si son nom est lu nettement
mieux, mais elle est signalée en orange (« hors de l'édition fixée »). Un clic sur l'édition de la carte scannée (ligne
« Édition » de la fiche) la fixe directement ; un second clic la libère. Le choix est mémorisé ; ✕ revient à toutes les éditions.
Un cadre orange = confiance faible ou choix ambigu entre deux impressions (autre produit Cardmarket) : à vérifier. Le prix tendance Cardmarket (foil si la case est cochée) est affiché ; si elle dépasse le prix de vente de plus du seuil réglable (champ « Alerte + », 0,50 € par défaut, mémorisé dans le navigateur), il passe en rouge et une alarme sonore retentit. « Prix tendance ↻ » retélécharge le guide des prix Cardmarket (mis à jour chaque nuit).
Export TCG Powertools : le bouton « Export Powertools (N) » télécharge un CSV (format de example-import.csv)
des cartes scannées depuis le dernier export, puis les marque comme exportées. Les cartes sans identifiant Cardmarket
sont laissées de côté (signalé dans la barre d'état). /api/export?everything=true réexporte tout le stock sans rien marquer.
Lien Cardmarket : le bouton « Lien Cardmarket » ouvre la fiche de la carte (en français, avec les filtres vendeurs/langues/état
de CM_BROWSE_QUERY dans config.py) dans un nouvel onglet. Le lien passe par l'identifiant du produit
(/Magic/Products?idProduct=…), que Cardmarket redirige vers la vraie fiche : les slugs ne suivent pas de règle fiable
(Akroma-s-Memorial mais Lorans-Escape, LimDuls-Cohort, Plains-V-1). Une URL déjà connue dans la table cm_urls passe
avant ; sans identifiant Cardmarket, le slug le plus probable est reconstruit (/Magic/Products/Singles/<Extension>/<Carte>).
En ligne de commande :
magicscanner status
magicscanner export inventaire.csvCes cartes sont identiques à leur impression d'origine (même cadre, même numéro, même code d'édition) à un détail
près : l'étincelle de Planeswalker dans la bordure noire, en bas à gauche. Le symbole ne dit pas laquelle des deux
(The List, Mystery Booster, Mystery Booster 2…) : Scryfall les regroupe dans la même édition (plst) et c'est
l'identifiant Cardmarket de la carte qui donne l'extension où elle se vend (autre extension, donc autre prix).
Le détecteur (list_symbol.py) cherche cette étincelle par reconnaissance de forme
dans une petite zone fixe. S'il la voit, l'impression plst est privilégiée ; sinon, c'est l'impression d'origine.
Quand une carte existe en plusieurs versions plst (ex. Extract from Darkness : 2X2-210 et E01-84), c'est le code
d'édition et le numéro d'origine imprimés sur la carte qui départagent (« 2X2 » ou « E01 »).
L'écran de scan affiche un badge avec l'extension réelle (« Mystery Booster », « The List »…), la ligne « Vendue dans »
et ce que la caméra a vu (« étincelle vue / douteuse / pas d'étincelle »). Sur des images dégradées comme une webcam,
99 % des cartes à étincelle sont détectées pour 0 % de fausses alertes. Si une carte est mal classée, 1–9 permet
de choisir l'autre impression.
Scryfall ne donne pas l'identifiant Cardmarket d'environ 1 carte plst sur 5. magicscanner import retrouve celui de
583 d'entre elles par le nom, uniquement quand c'est sans équivoque (un seul produit de ce nom dans The List / Mystery
Booster / Mystery Booster 2, pas déjà pris, une seule carte concernée). Les ~570 autres sont reconnues mais ne sont pas
exportées (comptées comme « sans identifiant Cardmarket » dans la barre d'état).
Limite : l'étincelle n'a été validée que sur des images simulées, pas encore sur une vraie carte.
Jetons : Scryfall ne donne pas l'identifiant Cardmarket de plus de la moitié des jetons (et en donne parfois un d'une
autre extension : tmh2 pointait vers War of the Spark). Chaque édition de jetons (type token : t*, mais aussi s*,
w*, p* selon l'édition) est rattachée à l'extension Cardmarket « <Édition>: Tokens » ou « <Édition>: Extras », lue par
son code et non par le vote des cartes. import retrouve ensuite l'identifiant par le nom (« Treasure Token (…) » ; les
emblèmes, donjons et « The Monarch » se vendent sous leur nom complet), selon la même règle : un seul produit de ce nom,
pas déjà pris, une seule carte concernée. Homonymes (deux « Clue », deux « Food »…) : quand le nom ne suffit pas, l'idProduct est déduit du numéro de collection,
mais seulement si la preuve est vérifiable. On prend la carte déjà liée la plus proche (produit de la même extension) ;
le décalage idProduct - numéro est appliqué, et confirmé par la carte liée de l'autre côté quand elle existe (une seule
ancre suffit en bord d'extension, sans confirmation) ; le produit visé doit porter le nom de la carte et ne pas être déjà
pris. Cela couvre aussi les jetons dont Scryfall donne un produit d'une autre extension (tmh2 n°6-8), sauf si leur nom se
vend aussi dans une extension sœur.
Les donjons (type « Dungeon ») sont exclus de cette règle : ils existent aussi en version oversized chez Cardmarket, le produit à leur position n'est pas sûr.
Jeton imprimé au dos d'une autre carte (« Goblin Token (R 1/1) // Dungeon of the Mad Mage ») : sans produit simple de
ce nom, il est lié au produit double face dont une face est ce jeton, uniquement s'il n'y en a qu'un dans l'extension et qu'un seul jeton de l'édition porte ce nom
(libre ; un produit déjà pris par une autre carte compte quand même, donc le doute bloque). Limites : des homonymes dont les deux ancres
se contredisent, ou sans ancre, restent sans identifiant ; une édition dont les cartes se vendent dans deux extensions sœurs
(ex. tdmu : « Dominaria United: Extras » et « Commander: … Extras ») ne rattache pas un nom présent dans les deux. Un lien fait par le nom disparaît au import
suivant (Scryfall réécrit l'identifiant) puis est refait avec l'extension à jour.
magicscanner/
cli.py commandes (import, sync-expansions, serve, status, export)
config.py chemins, prix, Chrome, URLs des sources (surcharge MS_*)
db.py schéma SQLite et connexion
inventory.py stock : scans, annulation, correction, suivi des exports
powertools.py export CSV pour TCG Powertools
catalog/ données de référence
scryfall.py import des éditions et des cartes (bulk all_cards, VO + VF)
cardmarket.py import du catalogue et des prix Cardmarket, rattachement éditions -> extensions
lookup.py Catalog : recherche floue des noms, impressions, fiche d'affichage
recognition/ image webcam -> impression
detect.py localisation et redressement de la carte (contours)
card_rect.py détection de secours : rectangle aux proportions de carte dont les bords sont les mieux soutenus
(carte collée à la paroi de la boîte, pile de cartes, bord noir peu visible)
ocr.py RapidOCR + extraction du titre, du numéro, du code d'édition, de la langue ;
position de la carte déduite de son titre quand les contours échouent
visual.py comparaison avec les images Scryfall (cadre, symbole d'édition)
list_symbol.py détection de l'étincelle « The List » (gabarit dans assets/)
scoring.py score d'une impression candidate (poids réglables en tête de fichier)
recognizer.py pipeline complet (contours -> OCR ; à défaut, carte localisée par son texte)
market/ site cardmarket.com
urls.py variantes d'URL produit, lien de navigation filtré
browser.py Chrome réel piloté en CDP (lecture des slugs d'extensions)
expansions.py liste officielle des extensions
web/ interface de scan
app.py API FastAPI
static/ index.html, style.css, js/ (main, camera, preview, tools, edition, view, api, sound, dom)
tests/ pytest ; tests/fixtures contient de vraies photos webcam (régressions de détection)
pytest # tout
pytest -m "not integration" # sans la base importée
ruff check . # lintMS_PRICE (0.20, prix par défaut du champ « Prix »), MS_KEEP_SCANS (low : photos gardées seulement pour les scans à vérifier ; none ou all), MS_CHROME (chemin chrome.exe), MS_CDP_PORT (9222),
MS_WINDOW (left,top,width,height de la fenêtre Chrome, 40,40,1500,1000), MS_DATA (dossier data/).
- Rééditions à illustration et cadre identiques : départagées surtout par le symbole d'édition et le numéro
de collection ; vérifier visuellement et corriger avec
1–9si besoin. - Cartes split / aventure / à faces multiples (dont les cartes à bascule de Kamigawa) : le nom lu est celui de la première face.
- Certaines cartes n'ont pas de fiche française chez Scryfall (ex. les cartes à bascule de Champions of Kamigawa) : leur nom VF est alors absent de la base et la carte risque d'être confondue avec un nom voisin (« Adepte de sang » lu « Orateur de sang »). Les noms connus sont ajoutés à la main dans
MISSING_FR_NAMES(lookup.py). - Les images de référence Scryfall sont mises en cache en 366 px (~46 Ko) : suffisant pour départager les éditions.
- Vérifier le numéro de collection quand le choix est ambigu : le pied de carte est souvent illisible pour l'OCR.
- Carte posée sur une pile dont les bords dépassent : son bord noir se confond avec la tranche des cartes du dessous. Elle est alors repérée par son cadre coloré, mais pas une carte noire (cadre noir lui aussi), ni une pile en éventail : celles-là sont retrouvées par le texte (~1,5 s de plus). Taper la pile pour l'aligner évite le problème.
- La localisation par le texte (carte à bord noir perdu dans l'ombre, ou nom mal lu parce que le contour retenu laisse le bandeau du titre dehors : le nom le mieux lu des deux est gardé) exige un titre et une ligne du bas lisibles, et une carte à peu près droite ; elle ajoute ~2,5 s au scan concerné. Comme la ligne du bas est incertaine (cartes à bascule : nom retourné), plusieurs positions de carte sont essayées jusqu'à ce que le nom soit reconnu.
- Les images de scans ratés sont gardées (20 dernières) dans
data/scans/failed/pour diagnostic, et celles des scans dont la carte a dû être retrouvée par son texte (secours lent) dansdata/scans/slow/. - Scan lent : la console de
magicscanner serveaffiche une ligne par scan avec le temps de chaque étape (attentedu verrou,contours,lectureOCR,texte= localisation par le texte,impressions= comparaison visuelle), la taille de l'image analysée et le zoom.
Si cet outil vous est utile, vous pouvez m'offrir un café pour m'aider à continuer de construire et d'améliorer des projets.