SPB Git forge
spboucher.ai ↗

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
View source Raw Blame History

# Card Merchant NZ connector (cardmerchant-nz)

  • Source: https://cardmerchant.co.nz · Auckland TCG store on BinderPOS: ~112k MTG singles (5k in stock), Yu-Gi-Oh!, Flesh and Blood, Riftbound and Grand Archive singles with "Name [Set]" titles and condition variants; sealed MTG, Yu-Gi-Oh!, One Piece, Lorcana, Digimon, Dragon Ball and Star Wars Unlimited.
  • 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 (14): mtg-singles-instock → magic_the_gathering, mtg-sealed → magic_the_gathering, yu-gi-oh-singles → yugioh, yugioh-sealed → yugioh, fab-singles → flesh_and_blood, flesh-and-blood-sealed → flesh_and_blood, riftbound-singles → other_tcg, grand-archive-singles → other_tcg, one-piece-tcg → one_piece_card_game, pokemon → pokemon, disney-lorcana-tcg → disney_lorcana, star-wars-unlimited → star_wars_tcg, digimon → digimon_tcg, dragonball-super → dragon_ball_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/cardmerchant-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 cardmerchant-nz.