# Total Cards connector (totalcards)

• Source: https://www.totalcards.net · Large UK trading-card retailer (Newton Aycliffe, since 2012): Pokémon (English + Japanese) and Magic singles, sealed TCG products, Funko, figures and comics.
• Country/currency: GB / GBP · 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): pokemon-single-cards → pokemon, pokemon-japanese-single-cards → pokemon, pokemon-sealed-products → pokemon, magic-the-gathering-single-cards → magic_the_gathering, lorcana-single-cards → disney_lorcana, one-piece-single-cards → one_piece_card_game, digimon-single-cards → digimon_tcg, dragon-ball-super-single-cards → dragon_ball_tcg, final-fantasy-single-cards → final_fantasy_tcg, star-wars-unlimited → star_wars_tcg, cardfight-vanguard-single-cards → other_tcg, funko-pop → funko, figures → action_figures, comic-books → comics.

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