Magic card scanner API

const socket = new WebSocket("wss://api.tcggraph.com/v1/scan", [
  "tcggraph.v1",
  `bearer.${process.env.TCGGRAPH_KEY}`,
]);

socket.onopen = () =>
  socket.send(
    JSON.stringify({
      type: "config",
      games: ["magic-the-gathering"],
      minConfidence: 0.92,
      prices: ["cardmarket", "tcgplayer"],
    }),
  );

socket.onmessage = (event) => {
  const frame = JSON.parse(event.data);

  for (const match of frame.matches ?? []) {
    // The printing, not just the card: set, number, language, finish.
    intake.add(match.printing, match.card.prices);
  }

  // Unresolved frames arrive too, and cost nothing.
  for (const miss of frame.unresolved ?? []) showHint(miss.reason);
};

for await (const jpeg of camera.frames()) socket.send(jpeg);

{
  "requestId": "scan_01K5Z8P4XQJ7YB3M",
  "latencyMs": 41,
  "matches": [
    {
      "confidence": 0.9962,
      "billed": true,
      "box": {
        "x": 0.171,
        "y": 0.064,
        "w": 0.658,
        "h": 0.872
      },
      "printing": {
        "id": "mtg_bd8fa327-dd4",
        "language": "en",
        "finish": "holofoil",
        "edition": "unlimited",
        "collectorNumber": "4"
      },
      "card": {
        "id": "mtg_bd8fa327-dd4",
        "game": "magic-the-gathering",
        "name": "Black Lotus",
        "set": {
          "code": "VMA",
          "name": "Vintage Masters"
        },
        "rarity": "Bonus",
        "prices": []
      },
      "alternatives": []
    }
  ],
  "scans": {
    "billed": 1,
    "remaining": 5842
  }
}