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。在应用类别列表中点击 Apply 选择 Seller-inhouse Developer（为自己使用而构建应用的 AliExpress 卖家），在 Reason 字段中写明你需要它的原因，然后点击 OK。该类别在 AliExpress 批准之前显示为 Pending，然后变为 Active。每个类别只能创建一个应用。
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，后者是所有按名称排序的参数的 HMAC-SHA256 大写，使用 App Secret 作为密钥。密钥永远不会离开 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 进行更正（最多两次，在十天内）。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 包括已完成和已关闭的订单，仅在请求时返回。endReason 在其子订单的 extend_map 中区分它们。

响应和错误：结果位于 aliexpress_..._response（API 名称带下划线）。许多调用返回 200，并在内部携带自己的裁决：result.success 及 errorCode 和 errorMessage（或 error_code 和 error_message），update_success 及 update_failed_list 用于价格和库存更新。在告知用户写入成功之前，始终先读取它。网关的拒绝以 error_response 形式返回，带有 code：IllegalAccessToken 表示授权已结束（AnythingMCP 会更新令牌一次并重试），InvalidAppkey 或 IncompleteSignature 表示密钥和密钥不匹配，InsufficientPermission 表示应用缺少 API 权限组，以及调用限制代码表示应用类别的配额已用完。

先决条件：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 美元。”
• “显示上个月的结算报表。”

下一步

• 连接到 Claude
• 连接到 ChatGPT