# 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`.