AliExpress MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on AliExpress: 8 typed functions through one MCP server. No AliExpress API key needed.
- Site
- aliexpress.us
- Functions
- 8
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for AliExpress alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/aliexpressOne MCP server for AliExpress and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
getProductFetches detailed product information including the price of every variant (size, color, etc.), shipping cost and delivery days to the ship-to…Arguments
Name Type Required idstringThe numeric product id from a search row's id, or an /item/<id>.html url.Yes Returns
aliexpressProductDetailinterface aliexpressProductDetail { id: string; title: string; price?: number; original_price?: number; currency?: string; images: string[]; /** SKU dimensions, e.g. { name: "Color", values: ["black", "white"] }. */ variants: { name: string; values: string[] }[]; /** Every SKU with its OWN price, e.g. { options: { Color: "black", Length: "1m" }, price: 1.09 }. * `price` above is only the page's selected SKU. */ skus: { sku_id: string; options: Record<string, string>; price?: number; original_price?: number; currency?: string; stock?: number; available: boolean }[]; shipping: { ship_to: string; ship_from?: string; fee?: number; currency?: string; carrier?: string; delivery_days_min?: number; delivery_days_max?: number }[]; properties: { name: string; value: string }[]; rating?: number; review_count?: number; store?: { name: string; url?: string; positive_rate?: string }; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aliexpress/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aliexpress.getProduct({ id: "<id>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aliexpress.getProduct({"id": "<id>"}))curl -X POST https://api.bowmark.ai/v1/sites/aliexpress/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"<id>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aliexpress.getProduct({ id: "<id>" });getStoreFetches a seller's store info.Arguments
Name Type Required idstringA seller id, or the store url a product's own store.url field returns.Yes Returns
aliexpressStoreInfointerface aliexpressStoreInfo { id: string; /** AliExpress's own internal shop id, distinct from the seller id. */ shopId?: string; name: string; logoUrl?: string; /** "available", "closed" (on vacation), etc, the site's own word. */ status?: string; followerCount?: number; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aliexpress/getStoreCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aliexpress.getStore({ id: "2678280160" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aliexpress.getStore({"id": "2678280160"}))curl -X POST https://api.bowmark.ai/v1/sites/aliexpress/getStore \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"2678280160"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aliexpress.getStore({ id: "2678280160" });listCartLists items in the CALLER's own AliExpress shopping cart.Arguments
None.
Returns
aliexpressCartItem[]interface aliexpressCartItem { product_id: string; title?: string; price?: number; currency?: string; quantity: number; image_url?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aliexpress/listCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aliexpress.listCart();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aliexpress.listCart())curl -X POST https://api.bowmark.ai/v1/sites/aliexpress/listCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aliexpress.listCart();listCategoriesLists AliExpress's own category navigation menu.Arguments
Name Type Required tabstringThe id of a top-level category (from a call with no tab) to get that category's own second- and third-level subcategories.No Returns
aliexpressCategory[]interface aliexpressCategory { id: string; platform_category_id?: string; name: string; icon_url?: string; subcategories?: aliexpressCategory[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aliexpress/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aliexpress.listCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aliexpress.listCategories())curl -X POST https://api.bowmark.ai/v1/sites/aliexpress/listCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aliexpress.listCategories();listOrdersLists the CALLER's own AliExpress orders, 10 a page.Arguments
Name Type Required pagenumber1-based page of the caller's order history, 10 orders a page.No Returns
aliexpressOrder[]interface aliexpressOrder { order_id: string; status?: string; created_at?: string; total?: number; currency?: string; store_name?: string; items: { product_id?: string; title?: string; quantity?: number; image_url?: string }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aliexpress/listOrdersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aliexpress.listOrders();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aliexpress.listOrders())curl -X POST https://api.bowmark.ai/v1/sites/aliexpress/listOrders \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aliexpress.listOrders();listWishlistLists products in the CALLER's own AliExpress wishlist.Arguments
Name Type Required pagenumber1-based page of the caller's wishlist.No Returns
aliexpressWishlistItem[]interface aliexpressWishlistItem { product_id: string; title?: string; price?: number; currency?: string; image_url?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aliexpress/listWishlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aliexpress.listWishlist();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aliexpress.listWishlist())curl -X POST https://api.bowmark.ai/v1/sites/aliexpress/listWishlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aliexpress.listWishlist();searchSearches AliExpress's product catalog by keyword, returning matching products with price, shop name, rating, and shipping information.Arguments
Name Type Required querystringYes Returns
aliexpressProduct[]interface aliexpressProduct { id: string; title: string; /** The card's own price in the page currency (USD), sale price when there is one. Never a * stand-in 0: a result whose price could not be read is left out of the list. */ price: number; /** Always "", AliExpress's search card does not carry the seller's name. */ shop_name: string; rating?: number; shipping_free?: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aliexpress/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aliexpress.search({ query: "phone case" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aliexpress.search({"query": "phone case"}))curl -X POST https://api.bowmark.ai/v1/sites/aliexpress/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"phone case"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aliexpress.search({ query: "phone case" });
addToCartAdds one variant (productId + skuId from getProduct) to the CALLER's own AliExpress cart.Arguments
Name Type Required productIdstringThe product id a search row or getProduct returns.Yes skuIdstringOne variant's id, getProduct's sku list carries it.Yes quantitynumberDefault 1.No Returns
aliexpressAddToCartResultinterface AliexpressCheckoutAccount { site: string; hint: string; signedInAs?: string; signInUrl?: string; } interface AliexpressCheckoutItem { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string; } // prices are decimal strings interface AliexpressCheckoutSummary { items: AliexpressCheckoutItem[]; total: string | null; currency: string; } /** Where to finish: open url, signed in as account. Bowmark never pays. status is ready_to_checkout, needs_login or unavailable (reason + detail say why). */ interface AliexpressCheckoutHandoff { status: "ready_to_checkout" | "needs_login" | "unavailable"; url: string; urlKind?: "carries_items" | "signed_in_cart" | "product_page"; account: AliexpressCheckoutAccount; summary: AliexpressCheckoutSummary | null; reason?: string; detail?: string; expiresAt?: string; warnings: string[]; } interface aliexpressAddToCartResult { cart_line_id?: string; cart_count?: number; checkout?: AliexpressCheckoutHandoff; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aliexpress/addToCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aliexpress.addToCart({ productId: "<productId>", skuId: "<skuId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aliexpress.addToCart({"productId": "<productId>", "skuId": "<skuId>"}))curl -X POST https://api.bowmark.ai/v1/sites/aliexpress/addToCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"productId":"<productId>","skuId":"<skuId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aliexpress.addToCart({ productId: "<productId>", skuId: "<skuId>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/aliexpress/<function> - OpenAPI
/v1/sites/aliexpress/openapi.json