インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Shopee Seller をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
AI で Shopee ショップを操作します。出品とバリエーション、注文、配送と追跡、返品、注文ごとの収益、割引プロモーション、広告の数値を扱い、ご希望に応じて在庫と価格の更新も行えます。
こう聞いてみよう
Shopee Seller のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Shopee Seller をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Shopee Seller + Cursor
AI で Shopee ショップを操作します。出品とバリエーション、注文、配送と追跡、返品、注文ごとの収益、割引プロモーション、広告の数値を扱い、ご希望に応じて在庫と価格の更新も行えます。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
SHOPEE_HOST, SHOPEE_PARTNER_ID, SHOPEE_PARTNER_KEY
ステップ 1 — 認証情報を取得
初回のセットアップは約 15 分で、これに加えて Shopee による新しいアプリの審査期間がかかります。自分の Shopee Open Platform アプリと、ショップのセラーアカウントが必要です。
- open.shopee.com にサインインして開発者登録を済ませ、Console → App List で自分のショップ用のアプリを作成します（例: Seller In House System タイプ）。新しいアプリは公開前に Shopee の審査を受けます。
- アプリの編集画面で、Test Redirect URL Domain と Live Redirect URL Domain に AnythingMCP のアドレスを設定します。AnythingMCP Cloud なら
https://cloud.anythingmcp.com、セルフホストなら自分のサーバーのアドレスです。別のドメインに戻る認可は Shopee に拒否されます。 - アプリの Partner ID を
SHOPEE_PARTNER_IDに、Partner Key をSHOPEE_PARTNER_KEYにコピーします。本番アプリとテストアプリではキーが異なるため、ホストに合ったペアを使ってください。 SHOPEE_HOSTを設定します。本番ショップ（東南アジア、台湾、中南米ほか）はhttps://partner.shopeemobile.com、アプリがブラジルから提供される場合はhttps://openplatform.shopee.com.br、中国本土の開発者はhttps://openplatform.shopee.cn、テストキーとサンドボックスのテストショップにはhttps://openplatform.sandbox.test-stable.shopee.sg（またはhttps://partner.test-stable.shopeemobile.com）です。- コネクターをインストールして開き、Authorize with Provider をクリックします。Shopee では ショップアカウント でサインインし（メインアカウントやマーチャントアカウントは拒否されます）、ショップと認可期間を選んで確定します。続いて
shopee_get_shop_infoを実行すると、ショップ、地域、ステータス、認可の有効期限が表示されます。
トークンは自動で更新されます: アクセストークンの有効期間は約 4 時間で、自動的に更新されます。その元になるリフレッシュトークンは約 30 日有効です。それより長く使われなかったコネクターや、Shopee Seller Centre で認可が取り消されたコネクターは、再度の認可が必要です。コネクターにその旨が表示され、所有者にメールが 1 通届きます。Authorize with Provider をクリックすれば元に戻ります。
Partner Key は AnythingMCP の中にとどまります: すべての呼び出しはこのキーで署名され、キー自体が送信されることはありません。署名の有効期間は 5 分のため、時計がずれたセルフホストのサーバーでは Shopee が error_sign を返します。
読み取れるデータ: ショップと公開プロフィール、名前、SKU、カテゴリー、ステータス、価格、在庫、画像、重量、物流情報を含む出品と、その販売数、閲覧数、いいね、評価、出品のバリエーション（色やサイズなど）とそれぞれの価格と在庫、購入者、商品、金額、支払方法、配送業者、荷物、住所を含む注文、まだ発送していない注文、注文の引き渡し方法（集荷枠と持ち込み拠点）、追跡番号と追跡履歴、物流チャネル、理由、購入者の写真、返金額を含む返品・返金リクエスト、手数料、各種料金、送料、バウチャーを差し引いた注文ごとの収益、割引プロモーション、そして Shopee 広告の残高と CPC 広告の日次実績（表示回数、クリック数、費用、注文数、GMV、ROAS）です。
期間の上限: Shopee では注文と返品を一度に最大 15 日分しか取得できないため、1 か月分なら AI が 2 回に分けて取得し、合計します。広告の数値は 1 回あたり最大 1 か月分、過去 6 か月以内です。
インストール時はオフ: shopee_update_stock と shopee_update_price。どちらも本番のショップを変更します。在庫は上書きされ（注文で引き当て済みの数より少なくはできません）、新しい価格はすぐに反映されます。実施中のプロモーションは独自の価格を保ちます。管理者が意図して有効にし、その場合でも AI は出品やバリエーションごとに変更前と変更後の値を示し、あなたの承認を待ちます。
お金は動きません: 発送、キャンセル、返金、購入者への返信、プロモーションの作成を行うツールはありません。発送の手配、返品の処理、購入者への返信は Shopee Seller Centre で行います。
制限: Shopee はアプリごとに呼び出し回数を制限しています。error_rate_limit や 429 が出たら、AI は 1 分待ってから再試行します。広告ツールにはアプリの Ads 権限が必要です。
よくあるエラー: error_sign や invalid_partner_id は、Partner ID、Partner Key、ホストの組み合わせが合っていないことを示します（本番キーをサンドボックスのホストで使っている場合など）。error_permission はアプリにその API の権限がないこと、error_param はパラメーターの誤りか期間が長すぎることを示します。source_ip_undeclared は、Console でアプリに設定した IP 許可リストに AnythingMCP のアドレスが含まれていないことを示します。
このコネクターは、発送の手配、注文のキャンセル、返品や返金の処理、購入者やチャットへの返信、割引や広告の作成、新しい出品のアップロードは行いません。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — Cursor にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、Cursor を再起動します。
- Cursor → Settings → MCP を開き、
anythingmcpが一覧にあり接続済みであることを確認します。 - チャットを始めましょう。エージェントが
Shopee Sellerのツールを呼び出せるようになりました。
利用可能なツール
| Tool | What it does |
|---|---|
shopee_get_shop_info | Read the authorized shop: shop_name, region, status (NORMAL, BANNED, FROZEN), whether it is cross-border (is_cb), auth_time and expire_time… |
shopee_get_shop_profile | Read the shop's public profile: name, logo, description and invoice issuer |
shopee_list_items | List the shop's listings (item ids with status and update_time), 100 per page at most |
shopee_search_items | Search the shop's listings by name or SKU (an SKU match wins over a name match), or find listings missing attributes |
shopee_get_items | Read up to 50 listings by item id: name, SKU, category, status, price info, stock info (when the listing has no variations), images, weight… |
shopee_get_items_extra_info | Read performance figures for up to 50 listings: sales, views, likes, rating_star and comment_count |
shopee_get_item_models | Read the variations (models) of one listing: tier_variation (the option names, e.g. colour and size) and each model with model_id… |
shopee_update_stock | Set the seller stock of a listing or of its models (up to 50 entries) |
shopee_update_price | Set the original price of a listing or of its models (up to 50 entries), in the shop's currency |
shopee_list_orders | List orders created (or updated) in a time window of at most 15 days, newest first, up to 100 per page |
shopee_get_order_details | Read up to 50 orders: status, buyer, items, amounts, payment method, shipping carrier, packages, recipient address and cancellation details |
shopee_list_orders_to_ship | List the orders waiting to be shipped (status READY_TO_SHIP with a shipping document to arrange), up to 100 per page |
shopee_get_shipping_parameter | Read how an order can be handed over: info_needed per method, the pickup addresses and time slots, and the drop-off branches |
shopee_get_tracking_number | Read the tracking number of a shipped order (available once the shipment is arranged), optionally with first and last mile numbers |
shopee_get_tracking_info | Read the logistics status and the tracking history (time, description) of an order or one of its packages |
shopee_list_logistics_channels | List the shop's logistics channels: id, name, whether each is enabled, fee type, size and weight limits |
shopee_list_returns | List return and refund requests, newest first, up to 100 per page, optionally within a creation or update window of at most 15 days |
shopee_get_return | Read one return request: reason, buyer text and images, items, refund amount, status, due dates and the linked order_sn |
shopee_get_order_income | Read what an order earns the seller (escrow detail): buyer payment, Shopee commission and service fees, shipping fee and rebates, vouchers… |
shopee_list_discounts | List the shop's discount promotions by status, with discount_id, name, start and end time |
shopee_get_ads_balance | Read the shop's current Shopee Ads credit balance |
shopee_get_ads_daily_performance | Read the daily performance of all the shop's CPC ads: impressions, clicks, CTR, expense, orders, GMV and ROAS (direct and broad) |
プロンプトの例
- 「今、発送待ちの注文はどれですか。それぞれの配送業者も教えてください。」
- 「先週の注文から、Shopee の手数料、各種料金、バウチャーを差し引いて実際にいくら稼げましたか。」
- 「今月いちばん売れた出品はどれですか。そのうち在庫切れが近いものも教えてください。」
- 「未処理の返品リクエストを、理由と返金額付きで一覧にしてください。」
- 「過去 14 日間の Shopee 広告はどうでしたか。費用、注文数、ROAS を日ごとに見せてください。」
FAQ
Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。
次のステップ
このガイドは役に立ちましたか?
