# GameZilla connector (`gamezilla`)

- Source: https://www.gamezilla.ca · 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)

New Brunswick TCG/anime shop chain. Shopify storefront with per-set MTG collections ('Name [Set]', store-location variants), Gunpla grades, anime figures/statues, Lorcana.

## Collections → taxonomy
| collection handle | category | brand / franchise / series |
|---|---|---|
| `mtg-commander-masters` | `magic_the_gathering` | Magic: The Gathering |
| `mtg-commander-legends-battle-for-baldurs-gat` | `magic_the_gathering` | Magic: The Gathering |
| `mtg-avatar-the-last-airbender` | `magic_the_gathering` | Magic: The Gathering |
| `mtg-foundations` | `magic_the_gathering` | Magic: The Gathering |
| `mtg-final-fantasy-commander` | `magic_the_gathering` | Magic: The Gathering |
| `mtg-commander-legends` | `magic_the_gathering` | Magic: The Gathering |
| `mtg-modern-horizons-3-commander` | `magic_the_gathering` | Magic: The Gathering |
| `mtg-edge-of-eternities` | `magic_the_gathering` | Magic: The Gathering |
| `mtg-aetherdrift` | `magic_the_gathering` | Magic: The Gathering |
| `mtg-final-fantasy` | `magic_the_gathering` | Magic: The Gathering |
| `mtg-dominaria-united` | `magic_the_gathering` | Magic: The Gathering |
| `mtg-double-masters-2022` | `magic_the_gathering` | Magic: The Gathering |
| `mtg-bloomburrow` | `magic_the_gathering` | Magic: The Gathering |
| `mtg-duskmourn-house-of-horror` | `magic_the_gathering` | Magic: The Gathering |
| `gundam` | `gundam` | Bandai / Gundam |
| `gundam-high-grade` | `gundam` | Bandai / Gundam / High Grade |
| `gundam-master-grade` | `gundam` | Bandai / Gundam / Master Grade |
| `gundam-real-grade` | `gundam` | Bandai / Gundam / Real Grade |
| `gundam-perfect-grade` | `gundam` | Bandai / Gundam / Perfect Grade |
| `anime-statue` | `action_figures` | — |
| `one-piece-figures` | `action_figures` | One Piece |
| `dragon-ball-figures` | `action_figures` | Dragon Ball |
| `naruto-figures` | `action_figures` | Naruto |
| `demon-slayer-figures` | `action_figures` | Demon Slayer |
| `disney-lorcana` | `disney_lorcana` | Disney Lorcana |
| `gundam-tcg` | `other_tcg` | Gundam Card Game |

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|\bglue\b|\btools?\b|\bnippers?\b|\bmarkers?\b|\bdecals?\b|action base|display base`

Title pattern: `^(?<name>.+?) \[(?<set>[^\]]+)\]$` (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: model-kit tools/markers/decals, D&D unpainted minis, sale collections, the many small per-set MTG collections not listed (added on demand).

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