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%
2.2 KB

# Good Games connector (goodgames)

  • Source: https://www.goodgames.com.au · Australian games retailer chain (Sydney): sealed Pokémon, MTG, Yu-Gi-Oh!, One Piece, Digimon, Flesh and Blood, Lorcana, Star Wars Unlimited; Panini sports boxes; anime figures, action figures, Funko, blind boxes, Gunpla and plush. EAN barcodes appear in SKUs.
  • Country/currency: AU / AUD · type: dealer · engine: api (Shopify storefront products.json (public JSON))
  • Records: listing only (dealer asking prices; never sales — SPEC §111). One listing per variant (condition / size / finish), out-of-stock variants kept as ended.
  • Refresh: every 24 h (NORMAL class) · historical depth: none (no sold archive).

# How it works

Metadata-only connector: index.ts instantiates the shared ShopifyStoreConnector adapter; everything source-specific lives in meta.json config: collections → taxonomy slug (with brand/franchise/series), title/tag rules (first match wins), an exclude regex for accessories/apparel/events, and the shop currency. Anything unmapped is skipped, never guessed.

Collections read (17): pokemon → pokemon, magic-the-gathering → magic_the_gathering, yu-gi-oh → yugioh, one-piece-card-game → one_piece_card_game, digimon → digimon_tcg, flesh-blood → flesh_and_blood, dragonball-super → dragon_ball_tcg, disney-lorcana-tcg → disney_lorcana, star-wars-unlimited → star_wars_tcg, gundam-card-game → other_tcg, sports-cards → other_sports_cards, funko → funko, anime-figure → action_figures, action-toy-figures → action_figures, blind-boxes → designer_toys, gundam → gundam, plush → plush.

# Access & compliance

See accessNotes in meta.json (robots findings, endpoints, rate limit, what is not fetched). Host policy: connectors/domains.d/g4-shops-intl.json.

# Fixtures & tests

data/fixtures/goodgames/*.json are live captures made with connectors/api/_g4-shops-intl-lib/capture.ts (trimmed payloads, expectations derived from the live record). index.test.ts runs the framework fixture suite, the g4 store invariants and a mapping unit test on titles observed live. Live probe: pnpm tsx connectors/api/_g4-shops-intl-lib/smoke.ts goodgames.