CommerceBrowser

ZOZOTOWN

zozo.jp

Unofficial ZOZOTOWN scraping provider for fashion search and product detail extraction.

Tier: 🥈 Silver
Reward: ₩150,000
Auth: Browser
Operations: 4
Working now: 0 contributors
Status: Open

Scope

Targets the zozo.jp web surface rather than a public API, so implementations should expect dynamic product cards, pagination, and browser-session behavior. The scope is fashion catalog search and detail lookup with size and color variants.

Expected operations

search-productsSearch fashion itemsreadDifficulty: medium

Search the ZOZOTOWN catalog by keyword, brand, category, size, or color to find fashion listings relevant to a shopping query.

Inputs

keywordstringrequired

Suggested surface — propose changes in your submission if the upstream differs.

Acceptance criteria

Provider scaffolded from the public @apifuse/provider-sdk
All listed operations implemented with Zod/Standard Schema input & output
Each operation declares exactly one of healthCheck or healthCheckUnsupported
Real upstream fixture data included where applicable
bun run check and bun run test pass
Auth, credential, and env-secret behavior documented (no real secrets committed)

Evidence to submit

Workspace repository and main commit link
SDK version/tag and the create command used
Operation list with input/output summaries
Health coverage table per operation
bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace will be prepared after confirmation.

Claiming a bounty requires a GitHub sign-in.

Text query for apparel, shoes, or accessories

brandstringoptional

Filter to a specific fashion brand

NIKE

categorystringoptional

Narrow results to a fashion category

shoes

sizestringoptional

Requested size filter

colorstringoptional

Requested color filter

black

Outputs

productIdbrandpriceJpysizecolorstock

Acceptance

Returns fashion listings with productId, brand, priceJpy, size, color, and stock when those attributes are shown on the listing card.
Honors brand, category, size, and color filters as shopping constraints rather than treating them as loose hints.
Does not invent stock or variant availability if the page only exposes a partial size matrix.

No account auth required for this operation.

get-product-detailGet item detailreadDifficulty: medium

Open a ZOZOTOWN item page by productId and extract the shopper-facing product information, including visible variant and stock data.

Inputs

product_idstringrequired
ZOZOTOWN product identifier from the item page or listing
12345678
sizestringoptional
Optional size variant to inspect
L
colorstringoptional
Optional color variant to inspect
navy

Outputs

productIdbrandpriceJpysizecolorstock

search-by-brandSearch by brandreadDifficulty: medium

Query ZOZOTOWN using a brand-first shopping flow, then refine the results by category or size when the brand has many variants.

Inputs

brandstringrequired
Brand name to search for
adidas
categorystringoptional
Optional category refinement within the brand catalog
tops
sizestringoptional
Optional size filter within the brand catalog
S

Outputs

productIdbrandpriceJpysizecolorstock

list-variant-availabilityList variant availabilityreadDifficulty: medium

Inspect a specific fashion item and enumerate the visible size and color combinations together with their stock state.

Inputs

product_idstringrequired
Item identifier whose variants should be checked
12345678

Outputs

productIdbrandpriceJpysizecolorstock

Acceptance

Returns the requested productId and keeps the chosen size or color variant attached to the detail result.
Includes stock only when the underlying page exposes variant-level availability.
Handles sold-out or hidden-variant pages with a clear domain response instead of a generic parse failure.

No account auth required for this operation.

Acceptance

Returns only items belonging to the requested brand and does not widen the scope to unrelated labels.
Preserves size and color information from the listed variants when available.
Works across multiple pages of brand results without mixing the first page into later pages.

No account auth required for this operation.

Acceptance

Returns the visible variant matrix rather than collapsing all sizes and colors into one synthetic row.
Marks unavailable combinations consistently when the item page shows sold-out states.
Keeps priceJpy anchored to the same product context even when multiple variants are listed.

No account auth required for this operation.