mcp-shopee

@codespar/mcp-shopee

Shopee 向け MCP サーバー — Shopee Open Platform Partner API v2 です。

Shopee は、LatAm の販売事業者がオンライン GMV の大部分を占める 2 つのマーケットプレイスの 1 つです（ブラジルで圧倒的なシェアを持ち、地域全体で急速に拡大しています）。@codespar/mcp-mercadolibre と組み合わせることで、このパッケージは LatAm の主要な e コマースマーケットプレイス全体をエージェントが利用できるようにします。それぞれ独自の販売者エコシステムがあるため、販売事業者は通常、両方で販売を行っています。

ツール（22）

ツール	用途
get_shop_info	認証済みの Shopee ショップの基本情報（shop_name、region、status、auth expiry）を取得します。
list_orders	指定した期間内の注文を一覧表示します。必要に応じて order_status で絞り込めます。
get_order_detail	order_sn を指定して、1 件以上の注文の詳細を取得します（カンマ区切り、最大 50 件）。
ship_order	注文の配送を手配します。集荷依頼、持ち込み、または追跡番号の指定を行います（状況に応じて...
cancel_order	発送前の注文をキャンセルします。
list_products	任意のステータスフィルターを指定して、ショップの商品を一覧表示します。
get_product_detail	最大 50 件の item_id を指定して、商品の基本情報を詳しく取得します。
update_product_stock	商品（またはそのモデル／バリエーション）の在庫数を更新します。
update_product_price	商品（またはそのモデル／バリエーション）の価格を更新します。
get_shipment_list	現在配送中（ステータスが SHIPPED または輸送中）の注文を一覧表示します。
get_return_list	任意のステータスと期間を指定して、ショップへの返品／返金リクエストを一覧表示します。
confirm_return	return_sn を指定して、購入者が開始した返品リクエストを承認します。
add_item	ショップに新しい商品を登録します。
update_item	既存の商品を更新します。
delete_item	item_id を指定して、ショップから商品を削除します。
get_shipping_parameter	ship_order の呼び出し前に、注文に必要な配送パラメーターを取得します。
get_tracking_number	発送済み注文の追跡番号（利用可能な場合は配送業者情報も）を取得します。
download_shipping_document	1 件以上の注文の配送ラベル／航空貨物運送状 PDF をリクエストします。
accept_return_offer	return_sn の返品について、購入者の返品提案（提示された解決策）を承認し、購入者に有利な形で交渉を終了します。
add_discount	期間を指定して、ショップ単位の新しい割引（プロモーション）を作成します。
add_bundle_deal	バンドル割引プロモーションを作成します（例：
send_chat_message	Shopee の販売者向けチャットで購入者にテキストまたはステッカーメッセージを送信します。

インストール

npm install @codespar/mcp-shopee@alpha

環境変数

SHOPEE_PARTNER_ID="2001234"        # partner_id (integer) from Shopee Open Platform
SHOPEE_PARTNER_KEY="..."           # partner_key (secret) for HMAC signing
SHOPEE_ACCESS_TOKEN="..."          # merchant access_token (4h lifetime; refresh via refresh_token)
SHOPEE_SHOP_ID="123456789"         # shop_id (integer) from authorization flow
SHOPEE_ENV="production"            # or "sandbox"

認証

Shopee では、パートナー署名付きリクエストを使用します。ショップ単位のエンドポイントでは、署名は次のとおりです。

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

partner_id、timestamp、access_token、shop_id、sign は、すべてのリクエストで URL クエリパラメーターとして付与されます。署名ヘルパー（src/index.ts）が各呼び出しでこの処理を行います。

access_token は、Shopee Open Platform の販売事業者向け OAuth 認証フローで取得します。有効期限は 4 時間です。refresh_token（有効期間 30 日）を使って更新してください。この交換処理はこの MCP の対象外で、通常は別のトークン管理サービスで行います。

実行

# 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

ベース URL

• 本番環境：https://partner.shopeemobile.com/api/v2
• サンドボックス： https://partner.test-stable.shopeemobile.com/api/v2

SHOPEE_ENV で選択します。

ステータス

0.1.0-alpha.1 — Shopee の Partner API ドキュメントポータルを利用するには開発者登録が必要です。そのため、一部のエンドポイントのペイロードとフィールドレベルの仕様（特に ship_order の集荷／持ち込みオブジェクトや配送チャネルの詳細）については、本番環境で使用する前に最新のドキュメントで確認してください。署名の手順とベース URL の選択は仕様に沿って実装されています。

エンタープライズ

エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT