# Mondo connector (`mondo`)

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

Mondo (Austin): vinyl soundtracks, 1/6 & 1/12 scale figures, soft vinyl, screen-printed movie posters. Shopify storefront; product_type Vinyl / 1/6 Scale / 1/12 Scale / Soft Vinyl / Posters.

## Collections → taxonomy
| collection handle | category | brand / franchise / series |
|---|---|---|
| `soundtracks` | `music` | Mondo |
| `mondo-music` | `music` | Mondo |
| `exclusive-colored-vinyl` | `music` | Mondo |
| `non-soundtrack` | `music` | Mondo |
| `new-vinyl-records` | `music` | Mondo |
| `collectibles` | `action_figures` | Mondo |
| `statues` | `action_figures` | Mondo |
| `soft-vinyl-1` | `designer_toys` | Mondo |
| `posters` | `movie_posters` | Mondo |

Rules (first match wins, applied to "title | product_type | tags | collection"):
- `\| (1/6 Scale|1/12 Scale|Figures?|Statues?) \|` → `action_figures` (brand Mondo)
- `\| Soft Vinyl \||\bsoft vinyl\b|\bsofubi\b` → `designer_toys` (brand Mondo)
- `\| (Vinyl|Cassettes?|CDs?) \||\bsoundtrack\b` → `music` (brand Mondo)
- `\| Posters? \||screen ?print|\bposter\b|\bgiclee\b` → `movie_posters` (brand Mondo)

Excluded (regex): `gift card|mystery|\| (Apparel|Pins?|Enamel Pins?|Tiki Mugs?|Accessories|Puzzles?|Books?) \||t-shirt|hoodie|\bshirt\b|\bhat\b|\bcap\b|enamel pin|\bpin set\b|tiki mug|\bmug\b|\btote\b|puzzle|blanket|\bsocks?\b|\bpatch\b|slipmat|\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: apparel & pins, tiki mugs, the "fees-products"/"archive" umbrella collections, wholesale collections.

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