# Goblin Games NZ connector (goblingames-nz)

• Source: https://goblingames.co.nz · New Zealand TCG specialist: ~190k MTG singles (incl. Alpha/Beta/Unlimited old-school and Secret Lair), 43k English + 38k Japanese Pokémon singles, Yu-Gi-Oh!, One Piece, Flesh and Blood, Star Wars Unlimited, Lorcana and Digimon singles with NM-Mint / Lightly Played / Moderately Played / Heavily Played variants; sealed MTG and Pokémon.
• Country/currency: NZ / NZD · 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 12 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, a titlePattern that extracts name/set/number, and the shop currency. Anything unmapped is skipped, never guessed.

Collections read (12): mtg-singles-in-stock → magic_the_gathering, secret-lair-singles → magic_the_gathering, magic-the-gathering-sealed → magic_the_gathering, pokemon-tcg-single-cards → pokemon, japanese-pokemon-singles → pokemon, pokemon-tcg-sealed-packs → pokemon, yugioh-single-cards → yugioh, one-piece-single-cards → one_piece_card_game, flesh-and-blood-single-cards → flesh_and_blood, star-wars-unlimited-single-cards → star_wars_tcg, disney-lorcana-single-cards → disney_lorcana, digimon-single-cards → digimon_tcg.

# 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/goblingames-nz/*.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 goblingames-nz.