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%
2.6 KB

# Martian Toys connector (martian-toys)

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

Philadelphia designer-toy shop and producer (vinyl toys, artist customs, blind boxes, Pop Mart, Superplastic, tokidoki). Shopify storefront; product_type "vinyl toy".

# Collections → taxonomy

collection handle category brand / franchise / series
designer-toys designer_toys —
designer-vinyl designer_toys —
blind-boxes designer_toys —
customs designer_toys Custom
urban-toys designer_toys —
martian-exclusives designer_toys Martian Toys
all-martian-toys designer_toys Martian Toys
pop-mart designer_toys Pop Mart
super-plastic designer_toys Superplastic
tokidoki designer_toys tokidoki
kozik designer_toys Frank Kozik
3d-retro designer_toys 3DRetro
madl designer_toys MAD*L

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: merch/shirts/prints/stickers/pins, event umbrella collections (NYCC, DCon…), "the vault"/"all" umbrella collections.

# Fixtures & tests

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