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

# Kapow Toys connector (kapowtoys)

  • Source: https://www.kapowtoys.co.uk · UK action-figure specialist (WooCommerce): Hot Toys, NECA, Mezco One:12, Marvel Legends, Star Wars Black Series, Masters of the Universe, TMNT, G.I. Joe, McFarlane, Medicom MAFEX, Transformers Masterpiece and 3rd-party Transformers, Gunpla and busts/statues.
  • Country/currency: GB / GBP · type: dealer · engine: api (WooCommerce Store API (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 24 h (NORMAL class) · historical depth: none (no sold archive).

# How it works

Metadata-only connector: index.ts instantiates the shared WooCommerceStoreConnector 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 (18): hot-toys → action_figures, marvel-hot-toys → action_figures, neca → action_figures, mezco → action_figures, marvel-legends-1 → action_figures, black-series-6-inch → action_figures, masters-of-the-universe-1 → action_figures, teenage-mutant-ninja-turtles → action_figures, g-i-joe → action_figures, mcfarlane → action_figures, medicon-mafex → action_figures, masterpiece → action_figures, 3rd-party-transformers → action_figures, busts-statues → action_figures, godzilla → action_figures, gundam → gundam, good-smile-company → action_figures, funko → funko.

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