CommerceBrowser

Musinsa

musinsa.com

Unofficial Musinsa provider for catalog search, product detail retrieval, order lookup, and shipment tracking.

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

Scope

Targets Musinsa's web or mobile commerce surface rather than a public API. The implementation must handle browsing sessions, search filters, product variants, and post-purchase lookup while being honest about scraping and authentication constraints. Inputs should reflect real shopping terms such as keyword, category, brand, sort, product_id, size, and color.

Expected operations

search-productsSearch productsreadDifficulty: medium

Query Musinsa's catalog search endpoint or page data using keyword and merchandising filters to return a ranked product list with pricing and availability fields.

Inputs

keywordstringrequired

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.

Search keyword entered by the shopper.

categorystringoptional

Optional department or category filter.

outerwear

brandstringoptional

Optional brand filter.

thisisneverthat

sortstringoptional

Sort order such as popularity, newest, or price.

popular

Outputs

productsproduct_idbrandpricereview_countsold_outthumbnail_url

Acceptance

Returns a product list with product_id, brand, price, and sold_out values for the given keyword.
Applies at least one merchandising filter such as category, brand, or sort when supplied.
Does not collapse search results into a generic title-only response.

No account auth required for this operation.

get-product-detailGet product detailreadDifficulty: medium

Fetch the full product page payload for a product_id, including option availability, sizes, colors, images, and review summary data.

Inputs

product_idstringrequired
Product identifier from search results or a deep link.
prod_1182334

Outputs

product_idbrandpricesizecolorreview_count

list-ordersList ordersreadDifficulty: hard

Retrieve the authenticated shopper's order list with page controls and date filters, mirroring the order history area of the app or site.

Inputs

pagenumberoptional
1-based page number for order history.
1
sizenumberoptional
Number of orders per page.
10
from_datedateoptional
Optional lower bound for purchase date filtering.
2024-01-01
to_datedateoptional
Optional upper bound for purchase date filtering.
2024-06-30

Outputs

ordersorder_idorder_statusorder_totalordered_atitem_count

track-shipmentTrack shipmentreadDifficulty: hard

Look up shipment progress for a placed order using the courier or tracking reference to surface delivery milestones and current carrier status.

Inputs

order_idstringrequired
Order identifier for the shipment to inspect.
mu_20240618_8844
tracking_numberstringoptional
Optional carrier tracking number when available.
CJ202406180123

Outputs

order_idcarrier_nametracking_numbershipment_statuscurrent_steplast_updated_at

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

Acceptance

Returns variant-aware detail fields such as size, color, and sold_out for the requested product_id.
Includes review_count and image_urls in addition to basic price information.
Rejects unknown product_id values instead of returning a fabricated placeholder record.

No account auth required for this operation.

Acceptance

Returns only the authenticated user's orders with order_id and order_status.
Honors page and size limits and can filter by ordered_at range.
Includes order_total and item_count for each listed order.

Auth required for this operation.

Acceptance

Returns current shipment step and carrier metadata for a valid order_id.
Uses the carrier tracking number when available and does not require it for every shipment.
Rejects access to shipment details that do not belong to the authenticated user.

Auth required for this operation.