AliExpress 검색 및 제품 세부 사항을 감싸는 MCP 서버 - CAD, Vancouver, BC로 배송.

디자인에 의하여 읽기 전용: 그것은, fetches 제품 세부사항을 검색하고, 선박을 검사합니다. ** 장바구니에 추가, 체크 아웃, 또는 지불.

도구

• search_products(query, min_rating, max_price, sort_by) - 공개 도매 검색 URL을 검색하고 임베디드 JSON을 파합니다.
• get_product_details(item_id | url) - 제목, 가격, 할인, 등급, 판매, 판매자, 배송비 및 ETA.
• get_shipping_estimate(item_id) - 배송비 + ETA가 형성된 국가에.
• view_cart() - 서명된 mtop.aliexpress.trade.cart.render] 엔드포인트를 통해 현재 카트 내용. 읽기 전용.

어떻게 작동합니까?

초기 제품 페이지는 클라이언트 측 렌더링 쉘 (window._d_c_.isCSR = true, window.runParams = {}]) - JS가 실행한 후 AliExpress의 MTOP API에서 AJAX를 통해 실제 제품 데이터로드. 그래서 HTML 스크랩은 PDP 데이터에 대해 작동하지 않습니다.

대신, 이 서버는 HMAC 토큰으로 mtop.js]] 쿠키를 사용하여 세션의 _m_h5_tk를 사용하여 서명 호출합니다. 서명 알고리즘:

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.