Сервер MCP, который обертывает поиск AliExpress и детали продукта для канадского покупателя — цены в CAD, доставка в Ванкувер, Британская Колумбия.

Читайте только по дизайну: он ищет, извлекает детали продукта и проверяет доставку. Он не добавляет в корзину, проверяет или платит.

Инструменты

search_products(query, min_rating, max_price, sort_by) — выполняет поиск по общедоступному оптовому поисковому URL и анализирует встроенный JSON. get_product_details(item_id | url) — название, цена, скидка, рейтинг, количество проданных, продавец, стоимость доставки и ETA. get_shipping_estimate(item_id) — стоимость доставки + ETA в настроенную страну. [[Т3]] — текущее содержимое тележки через подписанную [[Т4]] конечную точку. Только для чтения.

Как это работает

Начальная страница продукта представляет собой оболочку на стороне клиента ([T5], [T6]) — реальные данные о продукте загружаются через AJAX из API MTOP AliExpress после запуска JS. Таким образом, HTML-скреб не работает для данных PDP.

Вместо этого этот сервер копирует то, что mtop.js делает в браузере: он делает подписанные вызовы mtop.aliexpress.pdp.pc.query, используя cookie сессии _m_h5_tk в качестве токена HMAC. Алгоритм подписи:

AliExpress MCP Server

An MCP server that wraps AliExpress search and product detail scraping for a Canadian shopper — prices in CAD, shipping to Vancouver, BC.

Read-only by design: it searches, fetches product details, and checks shipping. It does not add to cart, check out, or pay.

Tools

• search_products(query, min_rating, max_price, sort_by) — searches the public wholesale search URL and parses the embedded JSON.
• get_product_details(item_id | url) — title, price, discount, rating, sold count, seller, shipping cost & ETA.
• get_shipping_estimate(item_id) — shipping cost + ETA to the configured country.
• view_cart() — current cart contents via the signed mtop.aliexpress.trade.cart.render endpoint. Read-only.

How it works

The initial product page is a client-side-rendered shell (window._d_c_.isCSR = true, window.runParams = {}) — real product data loads over AJAX from AliExpress’s MTOP API after the JS runs. So HTML scraping doesn’t work for PDP data.

Instead, this server replicates what mtop.js does in the browser: it makes signed calls to mtop.aliexpress.pdp.pc.query using the session’s _m_h5_tk cookie as the HMAC token. The signing algorithm:

sign = md5(token + "&" + t_ms + "&" + "12574478" + "&" + json_payload)

where token is the prefix of _m_h5_tk before the underscore, and 12574478 is AliExpress’s public web appKey. Token refresh on FAIL_SYS_TOKEN_EXPIRED is handled automatically.

Search still uses the simpler HTML path (embedded window.runParams JSON from the search SSR HTML) — no signed calls needed.

Setup

1. Install dependencies:

   pip install -r requirements.txt
   

2. Install the MCP Auth Bridge Chrome extension. The aliexpress entry is already in its sites.json.

3. Open https://www.aliexpress.com, log in, then click Save AliExpress in the extension popup. This writes cookies to ~/.mcp-credentials/aliexpress.json.

4. Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

   {
     "mcpServers": {
       "aliexpress": {
         "command": "python3",
         "args": ["/Users/YOUR_USER/justinritchie-mcp-servers/aliexpress-mcp-server/aliexpress_mcp_server.py"],
         "env": {
           "ALIEXPRESS_CREDENTIALS": "~/.mcp-credentials/aliexpress.json",
           "ALIEXPRESS_COUNTRY": "CA",
           "ALIEXPRESS_CURRENCY": "CAD"
         }
       }
     }
   }
   

5. Restart Claude Desktop.

Known limitations

• Low-volume / brand-new listings sometimes return empty MTOP responses (endpoint returns SUCCESS but an empty data block). Likely a region/visibility gate. Search results still show the listing fine.