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%

# Newbury Comics connector (newbury-comics)

  • Source: https://www.newburycomics.com · dealer · US · USD · Shopify storefront
  • Acquisition: public /collections/<handle>/products.json?limit=250&page=N (shared ShopifyStoreConnector adapter wrapped by MarketPinnedShopifyConnector, which adds a localization=US 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)

Boston chain famous for exclusive colored-vinyl variants and signed editions. Shopify storefront; product_type Vinyl/CD/Cassette; catalog numbers in tags.

# Collections → taxonomy

collection handle category brand / franchise / series
vinyl music —
exclusive-vinyl music —
exclusive-indie-vinyl music —
vinyl-singles music —
vinyl-box-sets music —
exclusive-soundtracks-vinyl music —
autographed-vinyl music —
autographed-cds music —
cassettes music —
cds music —

Excluded (regex): gift card|mystery|\| (Apparel|T-Shirts?|Merch|Accessories|Turntables?|Speakers?|Headphones?|Cartridges?|Cables?|Posters?|Digital) \||t-shirt|hoodie|\bshirt\b|\bhat\b|\btote\b|\bmug\b|poster|slipmat|slip mat|cartridge|stylus|turntable|speaker|headphone|\bcable\b|cleaner|cleaning|\bbrush\b|record weight|inner sleeves?|outer sleeves?|\bcrate\b|\bstand\b|\bpin\b|enamel pin|digital (album|download)|\bsocks?\b|\bpatch\b|\bsticker

# 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: merch, "domestic-only"/"test" umbrella collections, label collections (duplicates of the format collections).

# Fixtures & tests

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