AliExpress MCP Server

AliExpress product data inside Claude, ChatGPT, Cursor and your own code: search products, compare prices and orders, check shipping to your market, read buyer reviews. Hosted and read-only. No AliExpress login, no cookies, nothing to install.

Built from a real product search run on 2 November 2026.

Quick start · Agent setup · Tools · Prompts · Client setup · API · Pricing · FAQ

AliExpress MCP is a hosted AliExpress MCP server that connects your AI assistant to AliExpress, also written Ali Express and known in Chinese as 速卖通. Ask in plain words: your assistant searches products by keyword, opens product links you already have, or lists a whole store, and returns prices, exact order counts, ratings, every variant's price and stock, seller details, shipping options and delivery times for the country you sell to, plus buyer reviews when you want them. Results come back as structured rows it can sort, filter, compare and summarise, which is what dropshippers, product researchers and Shopify, TikTok Shop and Amazon sellers need for picking and checking products. Developers can call the same tool as an AliExpress API.

Why AliExpress MCP

• No AliExpress account and no app keys. No login, no cookies, no browser extension, and no affiliate or dropshipping app to register and wait on.

• Nothing to install. Add one URL and sign in with Apify. Works in claude.ai and ChatGPT too, not only in desktop apps.

• Any market, per request. 63 delivery countries, 44 currencies and 17 languages. The country changes the catalogue, prices, VAT and delivery times, so you see what your buyers see.

• The numbers that decide a product. Exact order counts (not only "10,000+ sold"), rating and review count, discount, every variant with its own price and stock, seller feedback, and each shipping option with cost, delivery window and measured delivery times.

• Three ways in. Keyword search with sort and filters, product links for tracking known items, and whole stores for checking a supplier or a competitor.

• Made for assistants. A bundled skill teaches your assistant the inputs that work, how to set the market and how to read the results, and long requests keep running while it checks back.

• Pay per result. Plus a small start fee per run, billed to your own Apify account. No subscription; try it on Apify's free plan.

Related MCP server: Taobao MCP Bridge

How it works

flowchart LR
    A["Your AI assistant<br/>Claude · ChatGPT · Cursor · VS Code"] -->|"remote MCP URL<br/>Apify sign-in"| B["AliExpress MCP server<br/>hosted on Apify"]
    B --> C["Keyword search"]
    B --> D["Product links"]
    B --> E["Whole stores"]
    C --> F["Product rows<br/>price · orders · variants · shipping · reviews"]
    D --> F
    E --> F
    F -->|"sort · filter · compare · summarise"| A

Each request starts a run on your Apify account. Your assistant waits for it, reads the rows, and answers in plain language. Go deeper in a second request: search a niche, then pass the best products' links back with reviews turned on, or open the store behind a strong seller.

Quick start

1. Create a free Apify account if you do not have one.

2. Add the server to your assistant. Click a button above, or follow the steps for your client below.

3. Sign in with Apify when your assistant asks, then ask a question such as "Find phone stands under $5 on AliExpress with four stars and up, most orders first, and show price, orders and shipping to the US."

About the Apify sign-in page. Apify notes that your assistant "was registered dynamically and wasn't verified by Apify" and asks for full API access. Every assistant that signs in this way sees that notice; it lets your assistant start runs on your account. You can remove the access at any time on your Apify Console integrations page.

Server URL, for any client that accepts a remote MCP server:

https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,zen-studio/aliexpress-scraper

Set up with your AI agent

Paste this repository's URL into Claude Code, Codex, Cursor or another agent and ask it to set up AliExpress. The steps below are written so your agent can follow them.

For AI agents installing this server:

1. This is a hosted remote MCP server (streamable HTTP). There is nothing to download or build. It needs a free Apify account and an Apify sign-in (OAuth) in the user's browser; do not ask for an API token unless the sign-in fails.

2. Server name aliexpress, server URL:

   https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,zen-studio/aliexpress-scraper

3. Add it with the client's own command:

   • Claude Code: claude plugin marketplace add zen-studio-labs/aliexpress-mcp, then claude plugin install aliexpress@aliexpress-mcp (adds the server and the AliExpress skill).

   • Codex: codex mcp add aliexpress --url "<server URL>", then codex mcp login aliexpress.

   • VS Code: code --add-mcp '{"name":"aliexpress","type":"http","url":"<server URL>"}'.

   • Cursor and other clients: add {"mcpServers": {"aliexpress": {"url": "<server URL>"}}} to the client's MCP config file (Cursor: ~/.cursor/mcp.json).

4. Ask the user to complete the sign-in. In Claude Code they run /mcp, select aliexpress and choose Authenticate; other clients open the Apify sign-in page themselves. A client restart may be needed before the tools appear.

5. Check it works without starting a paid run: call fetch-actor-details for zen-studio/aliexpress-scraper and confirm it returns the input reference. The first real request is the user's own; keep it small (for example "maxResults": 5).

6. Before real requests, read the AliExpress skill: it explains how long runs work, how to set the market and which inputs return good results.

Tools

All five are one tool, aliexpress-scraper; your assistant picks the inputs, and one run can mix keywords, product links and stores. The tool is read-only. It never orders, adds to cart, messages sellers or posts reviews.

The Store page lists every field.

Example prompts

Dropshipping product research

• Find the 30 best-selling LED strip lights on AliExpress under $10 with four stars and up, and rank them by orders per review.

• Which pet hair removers on AliExpress have the most orders? Show price, orders, rating and the store selling each.

Price and stock tracking

• Check today's price and stock for each variant of these products: https://www.aliexpress.com/item/1005006439988253.html

• Compare the price of this product in the US, Germany and Brazil, each in its local currency.

Suppliers and competitors

• List every product in this store with price and orders, top sellers first: https://www.aliexpress.com/store/1105246100

• For the top five sellers of magnetic phone holders, compare store feedback, positive rate and years open.

Shipping and local warehouses

• Find phone cases that ship from a US warehouse and arrive within 7 days, and show the shipping cost.

• Which of these products ship free to the UK, and how long does delivery take?

Buyer reviews

• Read 100 reviews with photos for this product and list the complaints that come up most.

• Summarise what buyers in France say about this product, in English.

Other markets and languages

• Busca soportes para móvil en AliExpress España por menos de 5 €, ordenados por pedidos, con precios en euros.

• Procure suportes de celular no AliExpress Brasil até R$ 30, com preço em reais e prazo de entrega.

Tip: name the country you sell to. Your assistant then sets the matching market, currency and language, because a product's price, VAT and delivery time differ by country.

Client setup

1. Open Settings > Connectors and select Add custom connector.

2. Name it AliExpress and paste the server URL above.

3. Select Connect and sign in with Apify.

4. In a chat, enable the AliExpress connector from the tools menu.

The connector syncs between claude.ai and Claude Desktop. Custom connector availability depends on your Claude plan. For better results, also add the AliExpress skill: download aliexpress-skill.zip and upload it under Skills in Claude's settings.

Plugin (server plus the AliExpress skill, recommended):

/plugin marketplace add zen-studio-labs/aliexpress-mcp
/plugin install aliexpress@aliexpress-mcp

Server only:

claude mcp add --transport http aliexpress "https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,zen-studio/aliexpress-scraper"

Then sign in: run /mcp, select the aliexpress server and choose Authenticate. Until you do, /mcp lists the server as not authenticated and may say its tools could not be fetched; both clear once you sign in.

Click Install in Cursor above, or add examples/cursor-mcp.json to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project). Cursor asks you to sign in with Apify on first use.

Click Install in VS Code above (VS Code Insiders), or add examples/vscode-mcp.json to .vscode/mcp.json. Start the server from the MCP view and sign in with Apify when prompted. Use the tools in Copilot Chat agent mode.

1. Open ChatGPT Plugins, select +, then Add custom MCP server.

2. Name it AliExpress, paste the server URL above, and choose OAuth authentication.

3. Confirm, create the plugin, and sign in with Apify.

4. In a new chat, type @ and select AliExpress.

Business, Enterprise and Edu workspaces may need an admin to enable custom servers. See OpenAI's custom MCP server guide.

codex mcp add aliexpress --url "https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,zen-studio/aliexpress-scraper"
codex mcp login aliexpress

Or copy examples/codex-config.toml into ~/.codex/config.toml.

Most clients that support remote MCP servers accept:

{
  "mcpServers": {
    "aliexpress": {
      "url": "https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,zen-studio/aliexpress-scraper"
    }
  }
}

If your client cannot complete the Apify sign-in, send your Apify token as a header instead, see examples/bearer-token-mcp.json. Copy the token from your Apify Console integrations page and keep it out of shared files. Clients that only run local servers can bridge with mcp-remote, see examples/claude-desktop-config.json.

Use it as an AliExpress API

The tool is also an Apify Actor with a REST API, so you can call it from your own code, a pipeline or an automation, without an assistant. Copy your API token from the Apify Console integrations page. The input fields are the same ones the assistant uses; the Store page has an API tab with ready-made code and the full input reference.

pip install apify-client

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("zen-studio/aliexpress-scraper").call(
    run_input={"keywords": ["phone stand"], "maxResults": 20, "sort": "orders", "priceMax": 5,
               "country": "US", "currency": "USD", "language": "en_US"}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["price"], item.get("soldCount"), item["rating"], item["title"], item["url"])

npm install apify-client

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('zen-studio/aliexpress-scraper').call({
    keywords: ['phone stand'],
    maxResults: 20,
    sort: 'orders',
    priceMax: 5,
    country: 'US',
    currency: 'USD',
    language: 'en_US',
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Start a run and get its results in one request:

curl -X POST "https://api.apify.com/v2/acts/zen-studio~aliexpress-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["phone stand"], "maxResults": 20, "sort": "orders", "priceMax": 5}'

This waits up to 300 seconds. For bigger runs, start the run asynchronously and read its dataset when it finishes, see the Apify API reference.

Use Apify's integration for n8n, Make or Zapier, choose the Actor zen-studio/aliexpress-scraper and pass the same JSON input. A daily schedule on a list of product links is the usual setup for price and stock tracking.

Use cases

• Dropshipping product research. Best sellers in a niche by exact orders, with price, rating, reviews and delivery time side by side.

• Price and stock tracking. Re-check a fixed list of products, variant by variant, on a schedule.

• Supplier and competitor checks. A seller's whole range with prices and orders, plus store feedback and years open.

• Shipping research. Which products ship from a local warehouse, what shipping costs, and how often orders arrive within a given number of days.

• Review mining. Recurring complaints and praise, photos, and the variants buyers chose, before you list a product.

• Market comparison. The same search in the US, Germany, Brazil or Japan, each in its own currency and language.

Example output

One product search row from the run in the demo, abridged. Your assistant reads rows like this and answers in plain language.

{
  "productId": "3256813069085205",
  "title": "Metal Magnetic Phone Holder Mini Round Car Magnet Mount Universal Stick on Dashboard Magnetic Stand for Smartphone Navigation",
  "url": "https://www.aliexpress.com/item/3256813069085205.html",
  "price": 1.09,
  "priceFormatted": "US $1.09",
  "currency": "USD",
  "originalPrice": 8.41,
  "discountPercent": 87,
  "soldCount": 155062,
  "soldText": "100K+ sold",
  "rating": 4.9,
  "reviewCount": 16106,
  "isChoice": true,
  "shipsFrom": "CN",
  "variantCount": 23,
  "seller": { "name": "Stone's Store", "positiveFeedbackRate": "100.0" },
  "shipping": [
    {
      "shipFrom": "China",
      "shipTo": "United States",
      "cost": 0,
      "costFormatted": "Free",
      "isFree": true,
      "deliveryDaysMin": 8,
      "deliveryDaysMax": 14,
      "estimatedDeliveryFrom": "2026-11-10",
      "estimatedDeliveryTo": "2026-11-16",
      "tracked": true,
      "deliveryDistribution": { "summary": "83.2% orders arrive in ≤ 13 days" }
    }
  ]
}

How long requests work

Each tool call returns within about 45 seconds. Bigger requests keep running on Apify after that, and your assistant checks back until the results are ready, then reads them in pages. You may see a few "still running" updates; that is expected. Twenty products with full details took about 50 seconds in the demo run; reviews and long product lists take longer. The AliExpress skill teaches assistants this flow, along with input recipes for each job. Claude Code gets it with the plugin.

Pricing

Pay per result plus a small start fee per run, billed to your Apify account. There is no subscription to this repository. Each product is billed, the full details add-on (on by default) is billed per product, and buyer reviews are billed per review. Current prices, including volume discounts, are on the tool's pricing page:

• AliExpress product search, links and stores

Your assistant controls cost through maxResults, maxReviewsPerProduct and the details add-on. Ask for a small number first, then scale up.

Free Apify plan: every run returns up to 62 products, including runs set to no limit. The tool does not limit the number of runs; each run is billed against your plan's monthly credit like any other. Any paid Apify plan removes the 62-product cap.

Limitations

• One market per run. Country, currency and language apply to the whole run; compare markets with one run each.

• Search depth. About 3,590 products per keyword and about 4,800 per store. Add more specific keywords, filters or a search term inside the store to go further.

• Exact order counts come with search and store results. Products added by link show the order label ("10,000+ sold") instead.

• Markets. 63 delivery countries are available; Russia and Kazakhstan are not among them.

• No business licence details. Seller rows carry store name, number, feedback and sales volume, not registered company documents.

• Read-only. No orders, carts, messages or reviews.

Use the data responsibly and in line with AliExpress's terms and the data protection laws that apply to you, such as GDPR, CCPA and PIPL. Reviews can carry a buyer's display name and country; most display names are anonymous ("AliExpress Shopper").

Troubleshooting

• /mcp says the server is not authenticated, or its tools could not be fetched. Select the server and choose Authenticate. Other clients show a Connect or Sign in button.

• Prices or delivery times differ from what you see on AliExpress. Set country, currency and language together for the market you check; currency and language do not follow the country by themselves.

• A search returns few products. Price ranges, filters and ship-from countries narrow fast. Widen the price range, drop a filter, or try a broader keyword.

• A run stopped at 62 products. That is the free Apify plan. Any paid plan removes it.

• Your assistant says a run is still going. That is normal for bigger requests and for reviews. Ask it to keep checking the same run; a new request for the same question is billed again.

• A product link returns nothing. Use the full product address, such as aliexpress.com/item/1005006439988253.html. Shortened share links from the app can expire.

• Your client cannot complete the sign-in. Use an Apify token header instead, see Other clients.

FAQ

What is AliExpress? AliExpress (速卖通, in full 全球速卖通) is Alibaba Group's global consumer marketplace, where mostly Chinese sellers ship directly to buyers worldwide. It is a common supplier for dropshipping stores on Shopify, TikTok Shop and other platforms.

Is there an AliExpress API? Yes. This tool can be called over a REST API or with Apify's Python and JavaScript clients, see Use it as an AliExpress API. AliExpress's own affiliate and dropshipping programs give API access after you register an app and wait for approval; this needs neither.

How is this different from open-source AliExpress MCP servers? Open-source servers run on your machine with Python or Docker, and most need your logged-in AliExpress session, a browser extension or affiliate app keys, with one market fixed in settings. AliExpress MCP is hosted: no AliExpress account, no keys, nothing to run, any market per request, and it works in web assistants such as claude.ai and ChatGPT.

Do I need an AliExpress account? No. You only need an Apify account, which takes a minute to create.

Is it free? You can try it on Apify's free plan. Results are billed from the first run against the plan's monthly credit, and on the free plan every run returns at most 62 products. The tool sets no limit on the number of runs; your Apify credit does. See Pricing.

Can it place orders, post reviews or message sellers? No. The tool is read-only by design.

Which countries and currencies are supported? 63 delivery countries, 44 currencies and 17 languages. Your assistant sets all three for the market you name.

Is the data live? Yes. Prices, stock, delivery estimates and review counts reflect AliExpress at the moment you ask, in the market you chose.

Does it work with Shopify or DSers? It researches products; it does not import them into your store. Export rows as JSON or CSV from Apify, or connect your store tools through n8n, Make or Zapier.

Which AI assistants work with it? Any client that supports remote MCP servers, including Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT, Codex, Cursor, VS Code with GitHub Copilot and many more.

Is this an official AliExpress product? No. AliExpress MCP is an independent product by Zen Studio and is not affiliated with AliExpress or Alibaba Group.

Privacy

Requests go to Apify's hosted MCP server and run on your Apify account. Apify's privacy policy applies. This repository contains configuration and instructions only; it collects nothing.

More from Zen Studio

AliExpress MCP is built on Zen Studio's Apify Actors. You can also run the tool directly on Apify, from its API, or on a schedule.

• Goofish MCP: Xianyu (闲鱼) second-hand listings, prices and sellers.

• RedNote MCP: Xiaohongshu (小红书) notes, comments and creators.

• Douyin MCP: Douyin (抖音) videos, creators, comments and shop products.

• Taobao & Tmall MCP: Taobao and Tmall (淘宝, 天猫) products, prices, SKUs and shops.

• 1688 & Alibaba.com MCP: 1688 wholesale and Alibaba.com products, plus supplier reviews.

• G2 & Capterra Reviews MCP: software reviews from G2, Capterra, TrustRadius and Gartner Peer Insights.

License

MIT. AliExpress and 速卖通 are trademarks of their respective owners.