# Wizard's Tower connector (`wizards-tower`)

- Source: https://www.kanatacg.com · dealer · CA · CAD · Shopify storefront
- Acquisition: public `/collections/<handle>/products.json?limit=250&page=N` (shared `ShopifyStoreConnector` adapter wrapped by `MarketPinnedShopifyConnector`, which adds a `localization=CA` cookie so Shopify Markets never geo-converts prices; no store-specific code)
- Records: `listing` (asking prices, one per variant; out-of-stock variants → `ended`)
- Refresh: every 12 h (ACTIVE→NORMAL boundary, large catalogue) · history: none (listings only)

Ottawa MTG/Lorcana/board-game store. Shopify storefront with one singles collection per MTG set (title '(SET)' suffix, NM/SP/MP variants).

## Collections → taxonomy
| collection handle | category | brand / franchise / series |
|---|---|---|
| `commander-legends-singles` | `magic_the_gathering` | Magic: The Gathering |
| `commander-masters-singles` | `magic_the_gathering` | Magic: The Gathering |
| `double-masters-singles` | `magic_the_gathering` | Magic: The Gathering |
| `commander-legends-battle-for-baldurs-gate-singles` | `magic_the_gathering` | Magic: The Gathering |
| `avatar-the-last-airbender-singles` | `magic_the_gathering` | Magic: The Gathering |
| `edge-of-eternities-singles` | `magic_the_gathering` | Magic: The Gathering |
| `adventures-in-the-forgotten-realms-singles` | `magic_the_gathering` | Magic: The Gathering |
| `dominaria-united-singles` | `magic_the_gathering` | Magic: The Gathering |
| `bloomburrow-singles` | `magic_the_gathering` | Magic: The Gathering |
| `duskmourn-house-of-horror-singles` | `magic_the_gathering` | Magic: The Gathering |
| `aetherdrift-singles` | `magic_the_gathering` | Magic: The Gathering |
| `double-masters-2022-singles` | `magic_the_gathering` | Magic: The Gathering |
| `dominaria-remastered-singles` | `magic_the_gathering` | Magic: The Gathering |
| `core-set-2021-singles` | `magic_the_gathering` | Magic: The Gathering |
| `30th-anniversary-edition-singles` | `magic_the_gathering` | Magic: The Gathering |
| `disney-lorcana-tcg` | `disney_lorcana` | Disney Lorcana |
| `board-games` | `board_games` | — |

Excluded (regex): `gift card|sleeves?|deck box|binder|playmat|toploader|top loader|storage box|dice|tokens? only|bundle of|mystery|buylist|submission|event ticket|\bentry\b|tournament|store credit|pre-?release event|supplies|card savers?|\brepack|bulk lot|\blot of\b|\bpaints?\b|primer|brushes|online (pack|code)|digital code|code card|unused digital|ptcgo|ptcg live`

Title pattern: `^(?<name>.+?) \((?<set>[A-Z0-9]{2,6})\)$` (name / set / number)

## Access & compliance
See `accessNotes` in meta.json: robots.txt verified 2026-09-08 (standard Shopify rules, products.json paths allowed), honest UA, 1 req / 1.5 s, listings only, no personal data. Not fetched: card-game supplies, dice, modelling supplies, sale umbrella collections, events.

## Fixtures & tests
`data/fixtures/wizards-tower/` — live captures (`pnpm tsx connectors/api/_g3-shops-na-lib/capture.ts wizards-tower`), trimmed single-product payloads incl. a sold-out variant.
`pnpm vitest run connectors/api/wizards-tower` · live probe: `pnpm tsx connectors/api/_g3-shops-na-lib/probe.ts wizards-tower`.