aliexpress-mcp
MCP server for searching and comparing AliExpress products via the official Affiliate API
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/chaosontoast--aliexpress-mcp)HTML
<a href="/listings/chaosontoast--aliexpress-mcp"><img src="/api/listings/chaosontoast--aliexpress-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
1. Sign up at https://portals.aliexpress.com, then create an app under the Open Platform (https://openservice.aliexpress.com) to get an **App Key** and **App Secret**. A **Tracking ID** from the affiliate portal is optional (it makes links affiliate links). 2. Clone this repo and register the server with Claude Code (requires [uv](https://docs.astral.sh/uv/)):
claude mcp add aliexpress --scope user -e ALIEXPRESS_APP_KEY=your_key -e ALIEXPRESS_APP_SECRET=your_secret -- uv --directory /path/to/aliexpress-mcp run aliexpress-mcp
Never commit your App Key or Secret; pass them as environment variables as shown.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 42 lines
- # aliexpress-mcp
- An MCP server that lets Claude search AliExpress using the official Affiliate API.
- ## Tools
- | Tool | What it does |
- | --- | --- |
- | `search_products` | Keyword search with price range, sort (price / orders), delivery-days filter, currency and ship-to country |
- | `get_product_details` | Full details for up to 50 product IDs |
- | `hot_products` | Trending / high-commission products, optionally filtered by keyword |
- Each result has: title, price, original price, discount, rating %, recent sales, shop, category, link and image.
- ## Setup
- 1. Sign up at https://portals.aliexpress.com, then create an app under the Open Platform
- (https://openservice.aliexpress.com) to get an **App Key** and **App Secret**.
- A **Tracking ID** from the affiliate portal is optional (it makes links affiliate links).
- 2. Clone this repo and register the server with Claude Code (requires [uv](https://docs.astral.sh/uv/)):
- ```sh
- claude mcp add aliexpress --scope user -e ALIEXPRESS_APP_KEY=your_key -e ALIEXPRESS_APP_SECRET=your_secret -- uv --directory /path/to/aliexpress-mcp run aliexpress-mcp
- ```
- Never commit your App Key or Secret; pass them as environment variables as shown.
- ## Optional settings (env vars)
- | Variable | Default |
- | --- | --- |
- | `ALIEXPRESS_TRACKING_ID` | none |
- | `ALIEXPRESS_CURRENCY` | `AUD` |
- | `ALIEXPRESS_SHIP_TO` | `AU` |
- | `ALIEXPRESS_LANGUAGE` | `EN` |
- ## Not yet checked against the live API
- - The request signing (HMAC-SHA256, IOP style) and response parsing follow the API's documented
- format but have not been run with real credentials.
- - The unit for `min_price` / `max_price` is unconfirmed. If price filters return odd results,
- AliExpress may expect cents. Adjust in `server.py`.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.