Search products across Chinese e-commerce platforms: Taobao, Tmall, XHS (小红书). Zero-config — no API keys needed. Powered by Shopme unified product database. Use when the user asks to find products, get product info by URL or ID, search Chinese suppliers, or compare prices.
Search and retrieve product information across Chinese e-commerce platforms via the Shopme unified product database.
Zero-config — no API keys required.
{
"mcpServers": {
"cn-ecommerce-search": {
"command": "npx",
"args": ["-y", "@shopmeagent/cn-ecommerce-search-mcp"]
}
}
}
No environment variables required. Optional:
| Variable | Default | Description |
|---|
SHOPME_API_BASE | https://api.shopmeagent.com | Override API endpoint (e.g. http://localhost:8000 for local dev) |
Search products by keyword across platforms.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
keyword | string | Yes | — | Search term (Chinese or English) |
platform | string | No | all | Filter by platform: xhs, taobao, tmall |
sort_by | string | No | relevance | relevance, price_asc, price_desc, sales_desc, created_at |
page | number | No | 1 | Page number |
limit | number | No | 10 | Items per page (max 50) |
Get detailed info about a specific product by ID or URL.
| Parameter | Type | Required | Description |
|---|---|---|---|
product_id | string | One of two | Product ID (recommended, faster) |
url | string | One of two | Product URL |
platform | string | No | Platform hint to speed up lookup |
Parse a product URL to identify the platform and product ID. Runs locally, no API call.
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | Yes | Product URL or text containing one |
| Platform | Code | Strengths | Price Range | Typical Buyer |
|---|---|---|---|---|
| 淘宝 Taobao | taobao | Largest selection, consumer goods | ¥ Low-Mid | End consumers |
| 天猫 Tmall | tmall | Brand flagship stores, higher quality | ¥ Mid-High | Quality-focused |
| 小红书 XHS | xhs | Community picks, beauty/lifestyle | ¥ Mid | Young women, lifestyle |
item.taobao.com/item.htm?id=123456detail.tmall.com/item.htm?id=123456mall.xiaohongshu.com/goods-detail/xxxe.tb.cn/xxx, m.tb.cn/xxxsales_desc to find popular/trusted products (best on XHS)platform filter to narrow results to a specific platformget_product_detail with a URL directly — no need to parse first