Mcp Shopee

io.github.codespar由 GitHub 帳號 codespar 發布v0.2.0-alpha.3更新於 Nov 10, 2026

MCP server for Shopee — LatAm marketplace Partner API v2 (orders, products, shipping, returns)

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

概覽

AI 產生的概覽

讓助理透過 Shopee 合作夥伴 API v2 管理賣家店鋪：訂單、商品、物流、退貨、促銷與買家聊天。

可以做什麼
將 Shopee 開放平台合作夥伴 API v2 包裝成 22 個工具，涵蓋店鋪資訊、訂單列表與詳情、安排出貨、取消訂單、物流單號與寄件標籤 PDF。也支援商品管理（列表、詳情、新增、更新、刪除、改庫存與改價）、退貨退款（列表、確認、接受買家方案）、店鋪層級折扣與組合促銷，以及在賣家聊天中傳送文字或貼圖訊息給買家。
適用情境
適合經營 Shopee 店鋪的賣家或代營運團隊，讓助理讀取訂單與商品資料、調整庫存或價格、安排出貨、處理退貨請求或草擬買家訊息。主要面向拉丁美洲市場的電商營運；README 提到可與另一個 Mercado Libre 伺服器搭配，供同時在兩個平台銷售的商家使用。
執行需求
透過 npm 套件 @codespar/mcp-shopee 以 stdio 在本機執行（需要 Node.js）；另有 HTTP 模式供伺服器對伺服器測試。需要 Shopee 開放平台應用憑證：SHOPEE_PARTNER_ID、SHOPEE_PARTNER_KEY、SHOPEE_SHOP_ID 與 SHOPEE_ACCESS_TOKEN，以及選用的 SHOPEE_ENV 用來選擇沙箱或正式環境。access_token 來自 Shopee 的商家授權 OAuth 流程，每 4 小時過期；以 refresh_token 更新並不在本伺服器範圍內。需要能連線至 Shopee 的 API 端點。
安裝前請注意
需要密鑰 SHOPEE_PARTNER_KEY 與 SHOPEE_ACCESS_TOKEN，用於簽章與授權每個請求，請勿寫入日誌或共用設定。多個工具會更動真實店鋪資料：ship_order、cancel_order、update_product_stock、update_product_price、add_item、update_item、delete_item、confirm_return、accept_return_offer、add_discount、add_bundle_deal 與 send_chat_message 都會作用於線上店鋪，部分操作難以復原。README 提醒此套件為 alpha 版本，部分端點內容（尤其是 ship_order 的取件/投遞物件與物流管道細節）在正式使用前應對照 Shopee 最新文件確認。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

@codespar/mcp-shopee

MCP server for Shopee — the Shopee Open Platform Partner API v2.

Shopee is one of the two marketplaces where LatAm merchants concentrate the bulk of their online GMV (dominant in Brazil, rapidly expanding across the region). Paired with @codespar/mcp-mercadolibre, this package gives agents full reach across LatAm's major ecommerce marketplaces — each has its own seller ecosystem, so merchants typically operate on both.

Tools (22)

ToolPurpose
get_shop_infoGet basic information about the authorized Shopee shop (shop_name, region, status, auth expiry).
list_ordersList orders within a time window, optionally filtered by order_status.
get_order_detailGet full detail for one or more orders by order_sn (comma-separated, up to 50).
ship_orderArrange shipment for an order — either request pickup, drop off, or pass a tracking number depending on the...
cancel_orderCancel an order that has not yet shipped.
list_productsList items (products) in the shop with optional status filter.
get_product_detailGet detailed base info for up to 50 items by item_id.
update_product_stockUpdate stock levels for an item (or its models/variants).
update_product_priceUpdate prices for an item (or its models/variants).
get_shipment_listList orders currently in shipment (status SHIPPED or in-transit).
get_return_listList return/refund requests on the shop, optionally filtered by status and time window.
confirm_returnConfirm (accept) a buyer-initiated return request by return_sn.
add_itemCreate a new product (item) in the shop.
update_itemUpdate an existing product.
delete_itemDelete an item (product) from the shop by item_id.
get_shipping_parameterFetch the required shipping parameters for an order before calling ship_order.
get_tracking_numberGet the tracking number (and courier info when available) for a shipped order.
download_shipping_documentRequest the shipping label / air waybill PDF for one or more orders.
accept_return_offerAccept the buyer's return offer (proposed solution) for a return_sn, ending negotiation in the buyer's favor.
add_discountCreate a new shop-level discount (promotion) with a time window.
add_bundle_dealCreate a bundle-deal promotion (e.g.
send_chat_messageSend a text or sticker message to a buyer in Shopee's seller chat.

Install

bash
npm install @codespar/mcp-shopee@alpha

Environment

bash
SHOPEE_PARTNER_ID="2001234"        # partner_id (integer) from Shopee Open PlatformSHOPEE_PARTNER_KEY="..."           # partner_key (secret) for HMAC signingSHOPEE_ACCESS_TOKEN="..."          # merchant access_token (4h lifetime; refresh via refresh_token)SHOPEE_SHOP_ID="123456789"         # shop_id (integer) from authorization flowSHOPEE_ENV="production"            # or "sandbox"

Authentication

Shopee uses partner-signed requests. For shop-level endpoints the signature is:

base_string = partner_id + api_path + timestamp + access_token + shop_idsign        = hex(HMAC_SHA256(partner_key, base_string))

partner_id, timestamp, access_token, shop_id, and sign are attached as URL query parameters on every request. The signing helper (src/index.ts) handles this on each call.

The access_token is obtained via the merchant authorization OAuth flow on Shopee Open Platform; it expires every 4 hours. Refresh it using the refresh_token (30-day lifetime) — that exchange lives outside this MCP's scope, typically in a separate token-management service.

Run

bash
# stdio (default — for Claude Desktop, Cursor, etc)npx @codespar/mcp-shopee
# HTTP (server-to-server testing)MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-shopee

Base URLs

  • Production: https://partner.shopeemobile.com/api/v2
  • Sandbox: https://partner.test-stable.shopeemobile.com/api/v2

Select with SHOPEE_ENV.

Status

0.1.0-alpha.1 — Shopee's Partner API documentation portal requires developer registration, so some endpoint payloads and field-level contracts (especially around ship_order pickup/dropoff objects and logistics channel specifics) should be validated against the live docs before production use. The signing recipe and base-URL selection are implemented to spec.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

來源：packages/ecommerce/shopee/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.0-alpha.3最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分