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%
3.2 KB

# Big B Comics connector (big-b-comics)

  • Source: https://www.bigbcomics.com · dealer · CA · CAD · Shopify storefront
  • Acquisition: public /collections/<handle>/products.json?limit=250&page=N (shared ShopifyStoreConnector adapter wrapped by MarketPinnedShopifyConnector, which adds a localization=CA cookie so Shopify Markets never geo-converts prices; no store-specific code)
  • Records: listing (asking prices, one per variant; out-of-stock variants → ended)
  • Refresh: every 12 h (ACTIVE→NORMAL boundary, large catalogue) · history: none (listings only)

Ontario comic-shop chain. Shopify storefront; CGC slabs titled 'Series Year #issue - CGC 9.8 - $price'; vintage comics by character; toys and trading cards.

# Collections → taxonomy

collection handle category brand / franchise / series
cgc-graded-comics comics —
vintage-comics comics —
comics comics —
ratio-variants comics —
marvel-comics marvel_comics Marvel
vintage-spider-man marvel_comics Marvel
vintage-x-men marvel_comics Marvel
dc-comics dc_comics DC
vintage-batman dc_comics DC
indie-comics independent_comics —
vintage-star-wars comics Star Wars
trading-cards non_sport_cards —
pokemon-cards pokemon Pokémon
funko-pops funko Funko
mcfarlane-toys action_figures McFarlane Toys
super7-reaction-figures action_figures Super7 / ReAction
hasbro-toy-group action_figures Hasbro
banpresto-toys action_figures Banpresto

Rules (first match wins, applied to "title | product_type | tags | collection"):

  • ^(?=[\s\S]*\b(marvel|spider-?man|x-men|avengers|wolverine|hulk|deadpool|iron man|captain america|fantastic four|daredevil|venom|punisher)\b)[\s\S]*\| (comics|vintage-comics|cgc-graded-comics|ratio-variants)$ → marvel_comics (franchise Marvel)
  • ^(?=[\s\S]*\b(dc comics|batman|superman|wonder woman|justice league|the flash|green lantern|aquaman|detective comics|action comics|harley quinn|joker|nightwing|swamp thing)\b)[\s\S]*\| (comics|vintage-comics|cgc-graded-comics|ratio-variants)$ → dc_comics (franchise DC)

Excluded (regex): gift card|sleeves?|deck box|binder|playmat|toploader|top loader|storage box|dice|tokens? only|bundle of|mystery|bags? (and|&) boards|\bmylar|comic bags|backing boards|supplies|graphic novel|\btpb\b|trade paperback|hardcover|omnibus|\bmanga\b

Title pattern: ^(?<name>[^#]+?) (?:\d{4} )?#(?<number>\d+[A-Za-z]?) (name / set / number)

# Access & compliance

See accessNotes in meta.json: robots.txt verified 2026-09-08 (standard Shopify rules, products.json paths allowed), honest UA, 1 req / 1.5 s, listings only, no personal data. Not fetched: graphic novels/manga/TPB collections (books, not collectibles), pre-orders, supplies.

# Fixtures & tests

data/fixtures/big-b-comics/ — live captures (pnpm tsx connectors/api/_g3-shops-na-lib/capture.ts big-b-comics), trimmed single-product payloads incl. a sold-out variant and a graded item. pnpm vitest run connectors/api/big-b-comics · live probe: pnpm tsx connectors/api/_g3-shops-na-lib/probe.ts big-b-comics.