# Super7 connector (`super7`)

- Source: https://www.super7.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)

Super7 brand store (ReAction, Ultimates!, Kandy Kaiju soft vinyl, G.I. Joe, Godzilla, TMNT, music figures). Shopify storefront; product_type Figures vs Apparel.

## Collections → taxonomy
| collection handle | category | brand / franchise / series |
|---|---|---|
| `movie-action-figures` | `action_figures` | Super7 |
| `pop-culture-figures` | `action_figures` | Super7 |
| `music-action-figures` | `action_figures` | Super7 |
| `comic-figures` | `action_figures` | Super7 |
| `classic-monster-figures` | `action_figures` | Super7 |
| `gi-joe` | `action_figures` | Super7 / G.I. Joe |
| `godzilla` | `action_figures` | Super7 / Godzilla |
| `nba` | `action_figures` | Super7 / NBA |
| `in-stock-thundercats` | `action_figures` | Super7 / ThunderCats |
| `in-stock-reaction` | `action_figures` | Super7 / ReAction |
| `in-stock-ultimates-and-deluxe-figures` | `action_figures` | Super7 / Ultimates! |
| `keshi-figures` | `action_figures` | Super7 / Keshi |
| `kandy-kaiju` | `designer_toys` | Super7 / Kandy Kaiju |

Rules (first match wins, applied to "title | product_type | tags | collection"):
- `\bsoft vinyl\b|\bsofubi\b|kandy kaiju|super shogun` → `designer_toys` (brand Super7)
- `\breaction\b` → `action_figures` (brand Super7) (series ReAction)
- `\bultimates!?\b` → `action_figures` (brand Super7) (series Ultimates!)

Excluded (regex): `gift card|mystery|\| (Apparel|T-Shirts?|Hats?|Accessories|Pins?|Enamel Pins?|Patches?|Socks|Hoodies?|Bags?|Stationery|Stickers?|Prints?|Posters?|Merch|Keychains?|Lanyards?|Pins? Lanyard Set|Books?|Toy Displays?|Home Goods|Drinkware) \||t-shirt|\btee\b|hoodie|sweatshirt|\bhat\b|\bcap\b|beanie|\bsocks?\b|enamel pin|\bpins? set\b|\bpatch\b|sticker|\bkeychain\b|lanyard|\bmug\b|\btote\b|tumbler|display case|acrylic case|pop protector only|art print|\bposter\b|\bzine\b|\bbook\b|\bgame\b|puzzle|blanket|towel|\bwallet\b|backpack|\bshirt\b|advent calendar|\bglassware|\bpint glass`

## 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: apparel & accessories, BFCM/holiday umbrella collections, "pre-order closed" archive, gift guides.

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