Skip to content
Back to search

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/chaosontoast--aliexpress-mcp/badge.svg)](/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

i

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
  1. # aliexpress-mcp
  2. An MCP server that lets Claude search AliExpress using the official Affiliate API.
  3. ## Tools
  4. | Tool | What it does |
  5. | --- | --- |
  6. | `search_products` | Keyword search with price range, sort (price / orders), delivery-days filter, currency and ship-to country |
  7. | `get_product_details` | Full details for up to 50 product IDs |
  8. | `hot_products` | Trending / high-commission products, optionally filtered by keyword |
  9. Each result has: title, price, original price, discount, rating %, recent sales, shop, category, link and image.
  10. ## Setup
  11. 1. Sign up at https://portals.aliexpress.com, then create an app under the Open Platform
  12. (https://openservice.aliexpress.com) to get an **App Key** and **App Secret**.
  13. A **Tracking ID** from the affiliate portal is optional (it makes links affiliate links).
  14. 2. Clone this repo and register the server with Claude Code (requires [uv](https://docs.astral.sh/uv/)):
  15. ```sh
  16. 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
  17. ```
  18. Never commit your App Key or Secret; pass them as environment variables as shown.
  19. ## Optional settings (env vars)
  20. | Variable | Default |
  21. | --- | --- |
  22. | `ALIEXPRESS_TRACKING_ID` | none |
  23. | `ALIEXPRESS_CURRENCY` | `AUD` |
  24. | `ALIEXPRESS_SHIP_TO` | `AU` |
  25. | `ALIEXPRESS_LANGUAGE` | `EN` |
  26. ## Not yet checked against the live API
  27. - The request signing (HMAC-SHA256, IOP style) and response parsing follow the API's documented
  28. format but have not been run with real credentials.
  29. - The unit for `min_price` / `max_price` is unconfirmed. If price filters return odd results,
  30. AliExpress may expect cents. Adjust in `server.py`.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.