AliExpress MCP サーバー：注文・商品・在庫

💡 インストール不要？cloud.anythingmcp.com に直接アクセスしてください。 サインインし、Connectors → AliExpress Seller をクリックし、アプリキーとシークレットを貼り付け、Authorize をクリックしてショップのセラーアカウントでサインインし、MCP API キーを生成すれば完了です。Docker は不要、git clone も不要、ローカルサーバーも不要です。

AliExpress セラー

あなたの AI に AliExpress ショップを運営させましょう: 注文と配送先住所、自社キャリアによる出荷申告、価格と在庫を持つ商品、カテゴリ、紛争、決済明細。AliExpress オープンプラットフォーム上のあなた自身のセラーアプリを使用します。

セットアップ

必要なもの: AliExpress セラーアカウント、AliExpress オープンプラットフォームの開発者アカウント、そして Seller-inhouse Developer カテゴリのあなた自身のアプリ。AliExpress は開発者プロファイルをレビューし、そのアプリカテゴリを承認する必要があります: 誰も AliExpress の承認を早めることはできず、拒否される可能性もあります。中国の FAQ では、開発者レビューに 2 ～ 5 営業日かかるとされていますが、カテゴリに関しては具体的な時間は示されていません。

1. https://openservice.aliexpress.com にアクセスし、Create Account をクリックします（またはサインインします）。次に、ユーザー ID の下でプロファイルを完成させます。Profile: 開発者タイプを選択し、必要なフィールドに記入し、AliExpress が要求する書類をアップロードします。AliExpress がプロファイルをレビューします。
2. App Console を開き、Create をクリックします。アプリカテゴリのリストで Seller-inhouse Developer に Apply をクリックします（自分用のアプリを構築する AliExpress セラーのため）、Reason フィールドにその理由を書き、OK をクリックします。AliExpress が承認するまでカテゴリは Pending と表示され、その後 Active になります。カテゴリごとに作成できるアプリは 1 つだけです。
3. 承認されたカテゴリで Create App をクリックします。アプリ名を入力し、コールバック URL としてこのサーバーのアドレスの後に /api/iop-auth/callback を付け加えます（AnythingMCP Cloud では: https://cloud.anythingmcp.com/api/iop-auth/callback）、次に Submit をクリックします。
4. APP Overview をクリックし、次にアプリの Manage をクリックします。App Key を ALIEXPRESS_SELLER_APP_KEY にコピーします。Basic Information の下で View をクリックし、App Secret を ALIEXPRESS_SELLER_APP_SECRET にコピーします。
5. 同じページで API Permission Group を確認します: Inactive とマークされたグループは Apply と理由を添えてリクエストする必要があります。その後、API が応答します。
6. App Console, App Management, Auth Management の下で、ショップのセラーアカウントをセラー認証ホワイトリストに入力し、送信します。自己開発したアプリは最大 50 のショップにバインドでき、開発者と法的に関連するショップのみが対象です: 同じ会社、親会社と子会社、同じ親会社、または同じ法的代表者または主要株主です。
7. コネクタページで Authorize をクリックします。AliExpress のサインインページが表示されます: 国を選択し、ショップのセラーアカウントとパスワードを入力し、Sign in And Authorize をクリックします。自分で AnythingMCP に戻ります。

トークンの有効期限: AnythingMCP はアクセストークンとリフレッシュトークンを暗号化して保持し、AliExpress の応答からそれらの有効期限を読み取り（expires_in と refresh_expires_in、秒単位）、自動的にアクセストークンを更新します。更新時には新しいリフレッシュトークンが発行されますが、リフレッシュトークンの終了日は変更されません。その日付に達した場合（または AliExpress が refresh_expires_in 0 と応答した場合）、再度 Authorize をクリックします。Auth Management ページにはアプリの期間が表示されます。AliExpress の中国語ガイドでは、自己開発したセラーアプリのアクセストークンは 365 日、リフレッシュトークンは 730 日とされています。

署名方法: すべての呼び出しは /sync に送信され、method に API 名を含め、さらに app_key、access_token、ミリ秒単位の timestamp、sign_method=sha256 と sign（すべてのパラメータを名前でソートし、App Secret で鍵付けした大文字の HMAC-SHA256）を含みます。シークレットは決して AnythingMCP から出ることはありません。

どこから始めるか

• ショップ: aliexpress_seller_get_seller_profile（セラー ID、国、見積もり通貨、商品数）および aliexpress_seller_get_shop_info（ショップ ID、名前、URL）。
• 注文: aliexpress_seller_list_orders で order_status WAIT_SELLER_SEND_GOODS を指定すると、出荷が必要なものがリストされます; aliexpress_seller_get_order では金額、サブオーダー、追跡情報が得られます; aliexpress_seller_get_order_receipt_info では配送先住所が得られます。
• 自社キャリアによる出荷: aliexpress_seller_list_order_shipping_services ではサブオーダーごとに自社キャリア（DBS）またはプラットフォーム物流で出荷するかが示されます; aliexpress_seller_list_shipment_providers ではプロバイダーコードが得られます; aliexpress_seller_declare_shipment ではキャリアと追跡番号を AliExpress に送信し、費用はかかりません; aliexpress_seller_modify_shipment では修正が可能です（最大 2 回、10 日以内）。aliexpress_seller_list_packages ではパッケージとそのステータスが表示されます。
• プラットフォーム物流（インストール時にオフになっています。ショップのために物流サービスを注文します）: aliexpress_seller_list_seller_addresses でピックアップアドレス、aliexpress_seller_pack_order でパッケージを作成、aliexpress_seller_ship_platform_package で引き渡し、aliexpress_seller_cancel_package でパッケージを取り消します。送り状の印刷は含まれていません: AliExpress はそれを応答内のファイルとして返し、セラーセンターから印刷します。
• 商品: aliexpress_seller_list_products（ステータス別）、aliexpress_seller_get_product（すべての SKU）、aliexpress_seller_update_prices と aliexpress_seller_update_stock（sku_code による）、aliexpress_seller_set_products_online、aliexpress_seller_set_products_offline（オフになっています）。商品の投稿、編集、削除は含まれていません。
• カタログ設定: aliexpress_seller_list_categories、aliexpress_seller_list_publishable_categories、aliexpress_seller_list_freight_templates。
• 紛争: aliexpress_seller_list_disputes と aliexpress_seller_get_dispute は読み取り専用です。aliexpress_seller_accept_dispute_solution はオフになっています: 提案を受け入れることは拘束力があり、バイヤーに返金される可能性があります。
• お金: aliexpress_seller_list_settlement_bills では決済明細がリストされます。コネクタは自ら支払い、返金、引き出しを行うことはありません。

ID とフォーマット

• 注文、サブオーダー、商品、紛争の ID は長い数字です: テキストとして渡し、数字のみを使用します。サブオーダー ID（注文リストの child_id、注文の child_order_list の id）は、出荷ツールが tradeOrderItemId と呼ぶものです。
• 注文時間は 米国太平洋時間 で、yyyy-MM-dd HH:mm:ss と書きます。パッケージと紛争フィルターはミリ秒単位の Unix 時間を取ります。決済期間は YYYY/MM/dd で書かれ、そのリリース日は Unix ミリ秒です。
• 金額は amount（小数点文字列）と currency_code のオブジェクトです; 送信する価格は商品の通貨での小数点文字列です。
• リストは 1 ページ目から: 注文と紛争はページごとに最大 50 件、パッケージは最大 50 件、商品は 100 件未満です。価格と在庫の更新は、最大 20 商品、各商品 200 SKU まで対応します。
• order_status FINISH は完了した注文とクローズされた注文の両方をカバーし、要求されたときのみ返されます。サブオーダーの extend_map にある endReason でそれらを区別します。

応答とエラー: 結果は aliexpress_..._response（アプリ名にアンダースコアを付けたもの）の下にあります。多くの呼び出しは 200 で応答し、自身の判定を含みます: result.success と errorCode、errorMessage（または error_code と error_message）、価格と在庫の更新に対する update_success と update_failed_list。ユーザーに書き込みが成功したことを伝える前に、必ずこれを読み取ってください。ゲートウェイの拒否は error_response と code で返されます: 認証が終了した場合は IllegalAccessToken（AnythingMCP はトークンを一度更新し再試行します）、キーとシークレットが一致しない場合は InvalidAppkey または IncompleteSignature、アプリが API 権限グループを欠いている場合は InsufficientPermission、アプリカテゴリのクォータが使い果たされた場合は呼び出し制限コードが返されます。

前提条件: ALIEXPRESS_SELLER_APP_KEY、ALIEXPRESS_SELLER_APP_SECRET

コネクタをローカルにインストールする

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

http://localhost:3000/connectors/store を開き、AliExpress Seller を選択し、前提条件に記載されている環境変数を貼り付けます。

利用可能なツール

例のプロンプト

• "どの AliExpress 注文が出荷待ちですか？"
• "注文 8187654321098765 の出荷を Cainiao 追跡 LP00123456789012 で宣言します。"
• "どの紛争がオープンで、バイヤーは何を求めていますか？"
• "SKU AE-CASE-14-BLK の在庫を 300 に、価格を 4.99 USD に設定します。"
• "先月の決済明細を表示します。"

次のステップ

• Claude に接続する
• ChatGPT に接続する