# Toy Snowman connector (`toy-snowman`)

- Source: https://www.toysnowman.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)

Canadian collector-toy and TCG e-shop (Hot Toys, S.H.Figuarts, Marvel Legends, Black Series, NECA, Mythic Legions, Gunpla, Warhammer). Shopify storefront.

## Collections → taxonomy
| collection handle | category | brand / franchise / series |
|---|---|---|
| `magic-the-gathering-singles` | `magic_the_gathering` | Magic: The Gathering |
| `pokemon-tcg-singles` | `pokemon` | Pokémon |
| `pokemon-tcg` | `pokemon` | Pokémon |
| `one-piece-tcg` | `one_piece_card_game` | One Piece |
| `riftbound-tcg-ccg` | `other_tcg` | Riftbound |
| `gundam-card-game-gundam-tcg` | `other_tcg` | Gundam Card Game |
| `star-wars-the-black-series` | `action_figures` | Star Wars |
| `marvel-legends` | `action_figures` | Hasbro / Marvel / Marvel Legends |
| `sh-monsterarts-sh-figuarts` | `action_figures` | Bandai / S.H.Figuarts / S.H.MonsterArts |
| `four-horsemen-mythic-legion` | `action_figures` | Four Horsemen Studios / Mythic Legions |
| `mythic-legions` | `action_figures` | Four Horsemen Studios / Mythic Legions |
| `neca` | `action_figures` | NECA |
| `transformers` | `action_figures` | Transformers |
| `godzilla` | `action_figures` | Godzilla |
| `mcfarlane-toys-1` | `action_figures` | McFarlane Toys |
| `threezero` | `action_figures` | threezero |
| `hiya-toys` | `action_figures` | Hiya Toys |
| `gundam` | `gundam` | Bandai / Gundam |
| `lego` | `lego_sets` | LEGO |
| `funko` | `funko` | Funko |
| `warhammer-40k` | `warhammer` | Games Workshop / Warhammer 40,000 |
| `age-of-sigmar` | `warhammer` | Games Workshop / Warhammer Age of Sigmar |

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|display case|acrylic case|\bstand\b|\bcodex\b|\bbattletome\b|rulebook|\bnovel\b|paperback|hardcover`

## 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: paints/hobby supplies, Black Library books/codexes, sale umbrella collections, accessories & supplies for toys.

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