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%

# Cherry Collectables connector (cherrycollectables)

  • Source: https://www.cherrycollectables.com.au · Australia's largest card shop (Melbourne; official Panini NBA distributor): ~390k singles across NBA/NFL/soccer/MLB/NHL/AFL/UFC/F1 sports cards, Pokémon (incl. PSA/CGC/BGS graded slabs), Yu-Gi-Oh!, MTG, One Piece, Digimon, Flesh and Blood, plus sealed boxes. Group breaks are excluded.
  • 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, and the shop currency. Anything unmapped is skipped, never guessed.

Collections read (21): pokemon-singles → pokemon, graded-pkm → pokemon, psa-10 → pokemon, pokemon-booster-boxes → pokemon, magic-the-gathering-singles → magic_the_gathering, ygo-singles → yugioh, one-piece-singles → one_piece_card_game, digimon-singles → digimon_tcg, flesh-and-blood-singles → flesh_and_blood, lorcana → disney_lorcana, nba-singles → basketball_cards, graded-nba-cards → basketball_cards, nfl-singles → football_cards, soccer-singles → soccer_cards, mlb-singles → baseball_cards, nhl-singles → hockey_cards, all-f1 → f1_cards, afl-singles → other_sports_cards, ufc-singles → other_sports_cards, wrestling-singles → other_sports_cards, marvel-singles → non_sport_cards.

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