SPB Git forge

spb/rareindex

Public
54commits 1branches 0releases
7.1 MBsize
maindefault branch
10 days agolast push
TypeScript 61.9% HTML 37.2% SQL 0.7%
3.2 KB

# 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.