Skip to content

coupang.md

Latest commit

 

History

History
106 lines (82 loc) · 4.2 KB

coupang.md

File metadata and controls

106 lines (82 loc) · 4.2 KB
Raw

Coupang

Mode: 🔐 Browser · Domain: coupang.com

Commands

Command Description
opencli coupang search Search Coupang products with logged-in browser session
opencli coupang product Read full product detail (price, rating, seller, delivery) for a product ID
opencli coupang add-to-cart Add a product to the logged-in account's shopping cart

Usage Examples

# List rocket-shipping mice (rank, product_id, title, price, rating, ...)
opencli coupang search "마우스" --filter rocket --limit 10

# Round-trip: pick a product_id from search and pull full detail
opencli coupang product 7654321

# Pass a full product URL instead of an ID
opencli coupang product --url https://www.coupang.com/vp/products/7654321

# JSON output (any subcommand)
opencli coupang product 7654321 -f json

# Add to cart (write — must be logged in)
opencli coupang add-to-cart 7654321

Output

search

Column Type Notes
rank int 1-based position within this query / page
product_id string Numeric Coupang product id; round-trips into coupang product
title string Product display name
price int | null Current selling price (KRW)
unit_price string Per-unit price label, e.g. (100ml당 1,200원)
rating float | null Average star rating
review_count int | null Number of reviews
rocket string Coupang-rocket badge label (로켓배송 / 로켓와우 / etc.) — empty string if no badge
delivery_type string 무료배송 / 일반배송 / empty
delivery_promise string 오늘도착 / 내일도착 / 새벽도착 / empty
url string Canonical product URL

product

Always returns a single row (or throws):

Column Type Notes
product_id string Numeric Coupang product id, normalised from input
title string | null Product display name; null if upstream did not provide
price int | null Current selling price (KRW)
original_price int | null Pre-discount price
discount_rate int | null Discount percent
rating float | null Average star rating
review_count int | null Number of reviews
seller string | null Vendor / seller name
brand string | null Brand label (when listed)
rocket string | null Coupang-rocket type label
delivery_promise string | null Arrival-window label
image_url string | null Primary product image
url string Canonical product URL

null semantics: a null field means upstream did not expose that field on this product (e.g. some items have no original_price). Failures (login wall, page mismatch, page failed to render) raise typed errors instead of silently returning empty rows — callers should treat any returned row as real data.

add-to-cart

Column Type Notes
ok bool Always true on success (failures throw)
product_id string Coupang product id added
url string Canonical product URL
message string Added to cart

Validation (no silent clamp)

search --limit must be 1..50; out-of-range values throw ArgumentError (no silent clamp to 50). search --page must be a positive integer. search --filter currently only accepts rocket; any other value throws ArgumentError rather than being silently dropped during DOM lookup.

Prerequisites

Notes

  • search and product use the logged-in browser session because Coupang's /np/search JSON endpoint and product pages serve different (and often empty) responses to anonymous traffic.
  • product's extractor tries three sources in order: JSON-LD Product schema, window.__INITIAL_STATE__ / __NEXT_DATA__ bootstrap globals, and finally a DOM fallback. The merged result is what's returned.
  • Authentication failures raise AuthRequiredError; missing/empty results raise EmptyResultError with a helpful hint. No command silently returns [] when login is the actual reason.