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 分