Naver Commerce

本地服务

appmonster.co.kr商业与营销06 天前更新

代码仓库访问官网

关于 Naver Commerce

Naver Commerce 是通过 Naver Commerce API 操作 Naver Smart Store 的 MCP 服务，面向店铺运营者及需要处理商品、订单、咨询和库存的 Agent。它也支持上传商品图片和创建商品。

主要功能

01查询和查看商品
02读取订单与客户咨询
03更新商品库存
04上传图片并创建商品
05写入工具带审批提示

适用场景

01查看近期 Smart Store 订单
02检查客户咨询
03调整库存数量
04准备并创建商品列表

MCP 相关

它将 Naver Commerce API 操作作为工具提供给 MCP 客户端，涵盖读取和写入。写入工具标记为具有破坏性，并支持接入外部审批步骤。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "groove79-mcp-naver-commerce": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-naver-commerce"
      ],
      "env": {
        "NAVER_COMMERCE_CLIENT_ID": "<NAVER_COMMERCE_CLIENT_ID>",
        "NAVER_COMMERCE_CLIENT_SECRET": "<NAVER_COMMERCE_CLIENT_SECRET>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>",
        "KMCP_WRITE_MODE": "<KMCP_WRITE_MODE>"
      }
    }
  }
}

启动命令npx -y @appmonster/mcp-naver-commerce

需要配置的环境变量

NAVER_COMMERCE_CLIENT_IDApplication client id from apicenter.commerce.naver.com

NAVER_COMMERCE_CLIENT_SECRET密钥Application client secret (used as bcrypt salt)

OKAGENT_API_KEY密钥OK Agent key (free at okagent.kr) — writes then wait for your OK on KakaoTalk. Unset: writes ask for confirmation in the chat first.

KMCP_WRITE_MODEapproval | confirm | direct (default: approval if OKAGENT_API_KEY is set, else confirm)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@appmonster/mcp-naver-commerce0.3.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
page	integer	否	页码，从 1 开始
size	integer	否	每页项目数（最多 500）
productName	string	否	部分商品名称匹配
originProductNos	array	否	指定的原始商品编号
channelProductNos	array	否	指定的渠道商品编号
productStatusTypes	array	否	按状态筛选。SALE = 在售，OUTOFSTOCK = 售罄

详细介绍

@appmonster/mcp-naver-commerce

适用于 Naver Commerce API（Smart Store）的 MCP 服务。让 Claude、Cursor、ChatGPT 和任何 MCP 客户端都能用韩语或英语列出商品、读取订单、回答“有新订单吗？”以及更改库存。

适用于 네이버 커머스 API（스마트스토어）的 MCP 服务。Agent 可以直接处理商品、库存、订单和客户咨询。

安装

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "naver-commerce": {
      "command": "npx",
      "args": ["-y", "@appmonster/mcp-naver-commerce"],
      "env": {
        "NAVER_COMMERCE_CLIENT_ID": "your-client-id",
        "NAVER_COMMERCE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Cursor（.cursor/mcp.json）——在 "mcpServers" 下使用相同代码块。

Claude Code：

claude mcp add naver-commerce -e NAVER_COMMERCE_CLIENT_ID=... -e NAVER_COMMERCE_CLIENT_SECRET=... -- npx -y @appmonster/mcp-naver-commerce

前往 커머스API센터 → 애플리케이션 등록，获取凭据。密钥用作 bcrypt 盐值，绝不会离开你的设备。

工具

工具	访问权限	功能
`naver_list_products`	读取	分页列出商品并应用筛选条件（`POST /v1/products/search`）
`naver_get_product`	读取	获取渠道商品详情，包括选项和库存（`GET /v2/products/channel-products/{no}`）
`naver_update_stock`	写入	更改库存。无选项的商品：获取渠道商品 → 更改 `stockQuantity` → 整体更新 `PUT /v2/products/channel-products/{no}`（Naver 没有仅更新库存的 API）。有选项的商品：`PUT …/option-stock`
`naver_list_orders`	读取	列出自指定时间以来有变更的订单及其详情（`last-changed-statuses` → `query`）
`naver_list_inquiries`	读取	列出指定日期范围内的客户一对一咨询（`GET /v1/pay-user/inquiries`）
`naver_upload_images`	写入	将图片（URL/base64）上传到 Naver，获取用于创建商品的托管 URL（`POST /v1/product-images/upload`）
`naver_create_product`	写入	创建商品和 Smart Store 渠道商品（`POST /v2/products`）。接受来自日本桥接工具的 `jp_listing_draft` 格式；设置 `statusType: SUSPENSION`（或 `WAIT`）可在销售前审核——Naver 会忽略创建时设置的状态并直接上架，因此该工具会隐藏渠道商品，随后将其更新为 판매중지，并返回实际状态

写入工具带有 destructiveHint: true，因此客户端可以在运行前征求确认。createServer({ approveWrite }) 可用于接入外部审批步骤。

示例提示词

“显示昨天以来新付款的订单”
“将‘모자’商品的库存改为 0”（会先征求确认，因为这是写入操作）
“有没有尚未回复的客户咨询？”

安全

凭据仅来自环境变量；除 api.commerce.naver.com 外，不会存储或发送到任何地方。
令牌缓存在内存中，并在过期前 60 秒刷新。
错误会原样返回 Naver 的 code/message，以便 Agent 说明问题所在。

开发

pnpm install && pnpm -F @appmonster/mcp-naver-commerce build && pnpm -F @appmonster/mcp-naver-commerce test

已验证线上运行（2026-10-21）

在真实的 Smart Store 上验证：naver_upload_images（PNG → shop-phinf URL）、使用 statusType: SUSPENSION 调用 naver_create_product → 读取状态，结果为 status: SUSPENSION, displayStatus: SUSPENSION → 删除。已将验证结果纳入工具：创建时会拒绝 WAIT（会映射为 SUSPENSION）；必须提供 deliveryInfo.deliveryCompany（택배사代码，默认值为 CJGLS）；创建时传入的状态会被忽略（商品会显示为 SALE），因此需要后续更新。可随时重新运行检查：node scripts/create-probe.mjs（创建一个 판매중지 商品并将其删除）。