Coupang Wing

io.github.groove79由 GitHub 帳號 groove79 發布v0.2.0更新於 Oct 29, 2026

Coupang Wing seller MCP: products, item stock/price, order sheets, ship confirmation. 쿠팡 윙 MCP.

已驗證STDIO僅桌面效率與工作流商業與電商

概覽

AI 產生的概覽

Coupang Wing 賣家 MCP 伺服器，讓助理查詢商品與訂單、調整選項庫存與價格，並將已付款訂單確認為備貨中。

可以做什麼
  • 查詢商品：分頁列出已登錄商品（可依名稱、狀態篩選），並查看單一商品詳情與其選項（vendorItemId、價格、出貨日）
  • 調整選項庫存與價格：設定某個選項的可售數量（0 代表售完）或韓元售價
  • 查詢訂單：依日期區間與狀態（已付款、備貨中、已出貨等）列出訂單，並查看單筆訂單及最新收件地址
  • 確認訂單：將最多 50 筆已付款訂單轉為備貨中，並逐筆回報結果
適用情境
適合 Coupang 賣家讓助理查看商品目錄與新訂單、調整選項庫存或價格，並把已付款訂單處理成備貨中，不必手動開啟 Wing 後台。
執行需求
透過 npx 以 stdio 在本機執行。需要 Coupang Wing Open API 的存取金鑰、密鑰與賣家編號（COUPANG_ACCESS_KEY、COUPANG_SECRET_KEY、COUPANG_VENDOR_ID），於賣家 Wing 帳號申請。請求簽章需要正確的 UTC 系統時間。可選 OKAGENT_API_KEY 與 APPROVAL_TIMEOUT_SEC 以啟用 KakaoTalk 核准。
安裝前請注意
三個寫入工具會更動真實賣家資料：庫存數量、售價，以及訂單確認（README 稱此操作在 API 層面無法復原）。超出 Coupang 允許幅度的改價會被拒絕，除非強制更新。寫入預設需要確認，但 KMCP_WRITE_MODE=direct 會關閉此檢查。伺服器持有賣家 API 憑證，若啟用亦持有 OK Agent 金鑰；訂單資料包含客戶收件地址。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Coupang Wing，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@appmonster/mcp-coupang

MCP server for the Coupang Wing Open API (쿠팡 판매자). Lets an AI agent read products and orders, change item stock/price, and acknowledge paid orders — with every write optionally gated by a human approval (OK Agent).

쿠팡 윙 오픈API용 MCP 서버. 상품·발주서 조회, 옵션 재고/가격 변경, 상품준비중 처리.

Tools

ToolAccessWhat it does
coupang_list_productsread등록 상품 목록 (이름/상태 필터, nextToken 페이징)
coupang_get_productread상품 상세 + 옵션(vendorItemId, 가격, 출고일)
coupang_update_item_quantitywrite옵션 재고 수량 변경 (0 = 품절)
coupang_update_item_pricewrite옵션 판매가 변경
coupang_list_ordersread기간·상태별 발주서 (ACCEPT/INSTRUCT/DEPARTURE/…), 최대 31일
coupang_get_orderread발주서 단건 — 배송 직전 주소 재확인용
coupang_confirm_orderswrite결제완료 → 상품준비중 (최대 50건, 건별 결과)

Setup

  1. Wing → 판매자정보 → 추가판매정보 → OPEN API 키 발급. Access key, Secret key, 그리고 업체코드(A00012345 형태)를 받습니다.
  2. MCP client config:
json
{  "mcpServers": {    "coupang": {      "command": "npx",      "args": ["-y", "@appmonster/mcp-coupang"],      "env": {        "COUPANG_ACCESS_KEY": "…",        "COUPANG_SECRET_KEY": "…",        "COUPANG_VENDOR_ID": "A00012345"      }    }  }}

Human approval for writes (optional, recommended)

Every write tool asks before it runs. By default the agent shows you a preview in the chat and re-calls with a confirm_token once you agree. Add an OK Agent key (free, 200/month) to approve on KakaoTalk instead:

json
"OKAGENT_API_KEY": "ok_…","APPROVAL_TIMEOUT_SEC": "300"

KMCP_WRITE_MODE=direct turns the check off for scripts you fully trust.

Notes

  • Auth is Coupang's CEA HMAC-SHA256 header; the server signs the exact bytes it sends (query string included), so no clock-skew tricks are needed beyond a correct system clock (UTC).
  • Coupang returns HTTP 200 with code: "ERROR" for many business failures — those surface as tool errors with Coupang's message.
  • Order date range is limited to 31 days per call; coupang_list_orders defaults to the last 7 days (KST).
  • Customers can change the delivery address after paying. Call coupang_get_order right before printing a label.

Development

bash
pnpm --filter @appmonster/mcp-coupang test

Tests use an injected fetch; no real network.

來源：packages/coupang/README.md，提交 53af4ba

工具

7

coupang_list_products

List the seller's registered products on Coupang (paged). 쿠팡 윙에 등록된 상품 목록을 조회합니다. Use first to find sellerProductId before reading details or changing stock/price. Needs nothing; optional name/status filter and nextToken for the next page.

輸入參數statuscreatedAtnextTokenmaxPerPagesellerProductName

coupang_get_product

Get one Coupang product with all its items (options): vendorItemId, name, prices, max buy count, shipping lead time. 상품 상세와 옵션(아이템) 목록을 조회합니다. Use to find the vendorItemId that stock/price changes need. Needs sellerProductId.

輸入參數sellerProductId必填

coupang_update_item_quantity

Set the sellable quantity of one Coupang item (option). 0 marks it sold out. 옵션(아이템) 재고 수량을 변경합니다. Use after confirming vendorItemId with coupang_get_product. Needs vendorItemId and the new quantity (absolute, not delta).

輸入參數quantity必填vendorItemId必填confirm_token

coupang_update_item_price

Change the sale price of one Coupang item (option), in KRW. 옵션(아이템) 판매가를 변경합니다. Coupang rejects changes beyond its allowed ratio from the current price unless forceSalePriceUpdate is true. Needs vendorItemId and the new price.

輸入參數price必填vendorItemId必填confirm_tokenforceSalePriceUpdate

coupang_list_orders

List Coupang order sheets (발주서) in a date range by status: ACCEPT=paid, INSTRUCT=preparing, DEPARTURE=shipped, DELIVERING, FINAL_DELIVERY, NONE_TRACKING. Max 31 days per call, 50 per page. 기간·상태별 발주서 목록을 조회합니다. Use to see new paid orders to prepare, or shipments to track. Needs status; dates default to the last 7 days (KST).

輸入參數tofromstatusnextTokenmaxPerPage

coupang_get_order

Get one Coupang order sheet by shipmentBoxId, with the latest receiver address (customers can change it after paying). 발주서 단건을 조회합니다. Use right before shipping to confirm the address, or after coupang_confirm_orders. Needs shipmentBoxId.

輸入參數shipmentBoxId必填

coupang_confirm_orders

Acknowledge paid Coupang orders — moves them from ACCEPT (결제완료) to INSTRUCT (상품준비중). Up to 50 shipmentBoxIds per call; partial failures are reported per id. 발주서를 상품준비중으로 처리합니다. Use after reviewing new orders with coupang_list_orders. Needs shipmentBoxIds. Irreversible from the API.

輸入參數confirm_tokenshipmentBoxIds必填

版本歷史

2
  1. v0.2.0最新Oct 23, 2026
  2. v0.1.0Oct 21, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分