# Games Portal connector (gamesportal)

• Source: https://gamesportal.com.au · Mitcham (Victoria) game store on BinderPOS: ~47k in-stock MTG singles plus One Piece, Lorcana, Digimon and Flesh and Blood singles with "Name [Set]" titles and Near Mint / Lightly Played / Moderately Played / Heavily Played (Foil) condition variants; sealed MTG, Lorcana, One Piece, Star Wars Unlimited, Gundam and hololive products.
• 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 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): magic-singles-instock → magic_the_gathering, sealed-magic-products → magic_the_gathering, one-piece-ccg-singles → one_piece_card_game, one-piece-card-game → one_piece_card_game, disney-lorcana-singles → disney_lorcana, disney-lorcana-sealed → disney_lorcana, digimon-singles → digimon_tcg, flesh-and-blood-singles → flesh_and_blood, star-wars-unlimited-sealed → star_wars_tcg, dragon-ball-super-fusion-world-sealed → dragon_ball_tcg, gundam-card-game-sealed → other_tcg, hololive-card-game-sealed → other_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/gamesportal/*.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 gamesportal.