# Toy Tokyo connector (`toy-tokyo`)

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

NYC's Toy Tokyo: Funko exclusives, Medicom BE@RBRICK, KAWS, sofubi, Banpresto/Bandai/NECA/Mezco figures. Shopify storefront; product_type FUNKO / MEDICOM TOY / Action & Toy Figures.

## Collections → taxonomy
| collection handle | category | brand / franchise / series |
|---|---|---|
| `funko` | `funko` | Funko |
| `pop-animation` | `funko` | Funko |
| `pop-anime` | `funko` | Funko |
| `pop-disney` | `funko` | Funko |
| `pop-television` | `funko` | Funko |
| `pop-marvel` | `funko` | Funko |
| `pop-games` | `funko` | Funko |
| `pop-dc` | `funko` | Funko |
| `pop-star-wars` | `funko` | Funko |
| `pop-movies` | `funko` | Funko |
| `pop-heroes` | `funko` | Funko |
| `pop-pokemon-1` | `funko` | Funko |
| `pop-icons` | `funko` | Funko |
| `pop-toy-tokyo` | `funko` | Funko |
| `pop-soda` | `funko` | Funko |
| `pop-rocks-1` | `funko` | Funko |
| `medicom-toy` | `designer_toys` | Medicom Toy |
| `be-rbricks` | `designer_toys` | Medicom Toy / BE@RBRICK |
| `1000-be-rbrick` | `designer_toys` | Medicom Toy / BE@RBRICK |
| `100-be-rbrick` | `designer_toys` | Medicom Toy / BE@RBRICK |
| `vcd` | `designer_toys` | Medicom Toy / VCD |
| `kaws` | `designer_toys` | KAWS |
| `sofubi` | `designer_toys` | — |
| `vinyl` | `designer_toys` | — |
| `action-figures` | `action_figures` | — |
| `banpresto` | `action_figures` | Banpresto |
| `bandai` | `action_figures` | Bandai |
| `neca` | `action_figures` | NECA |
| `mezco` | `action_figures` | Mezco Toyz |
| `star-wars` | `action_figures` | Star Wars |
| `godzilla-1` | `action_figures` | Godzilla |

Rules (first match wins, applied to "title | product_type | tags | collection"):
- `\bfunko\b|\bpop!` → `funko` (brand Funko)
- `be@rbrick|bearbrick|be-rbrick` → `designer_toys` (brand Medicom Toy) (series BE@RBRICK)
- `\bkaws\b` → `designer_toys` (brand KAWS)
- `\bsofubi\b|\bsoft vinyl\b` → `designer_toys`

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`

## 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: accessories/apparel/enamel pins/keychains/plush, gift and holiday umbrella collections, NTWRK drops.

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