- name
- cn-ecommerce-search
- description
- >
- license
- MIT
- metadata
- author
- shopme
- version
- 2.0.0
- mcp-server
- @shopmeagent/cn-ecommerce-search-mcp
Chinese E-commerce Product Search
Search and retrieve product information across 8 Chinese e-commerce platforms via the Shopme unified product database.
Zero-config — no API keys required.
When to Use
- User asks to find a product on any Chinese e-commerce platform
- User shares a product link and wants details
- User needs to search Chinese suppliers for a product
- User asks about prices on Chinese platforms
- User provides a product URL from Taobao, JD, PDD, 1688, etc.
- User wants to compare products across platforms
MCP Server Setup
{
"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) |
Available Tools
search_products
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 (see table below) |
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_product_detail
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_product_link
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 |
Supported Platforms
| 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 |
| 京东 JD | jd | Fast logistics, electronics, appliances | ¥ Mid-High | Quality + speed |
| 拼多多 PDD | pdd | Group-buy deals, lowest prices | ¥ Lowest | Price-sensitive |
| 1688 | ali1688 | Wholesale/factory direct, bulk pricing | ¥ Lowest (bulk) | Resellers, businesses |
| 速卖通 AliExpress | aliexpress | International shipping, buyer protection | $ Mid | International buyers |
| 抖音 Douyin | douyin | Live-commerce, trending products | ¥ Low-Mid | Trend followers |
| 小红书 XHS | xhs | Community picks, beauty/lifestyle | ¥ Mid | Young women, lifestyle |
Supported URL Formats
item.taobao.com/item.htm?id=123456detail.tmall.com/item.htm?id=123456detail.1688.com/offer/123456.htmlitem.jd.com/123456.htmlmobile.yangkeduo.com/goods.html?goods_id=123456aliexpress.com/item/123456.htmlhaohuo.jinritemai.com/...?id=123456mall.xiaohongshu.com/goods-detail/xxx- Short links:
e.tb.cn/xxx,m.tb.cn/xxx
Price Understanding Guide
- All platforms except AliExpress return prices in CNY (¥). Rough conversion: 1 USD ≈ 7.2 CNY
- AliExpress prices in the database are also stored as CNY
- 1688 prices are factory/wholesale, often 30-70% lower than Taobao for the same product
- Always consider shipping costs when comparing prices
Search Tips
- Chinese keywords get more results on domestic platforms (Taobao, JD, PDD, 1688)
- English keywords are auto-expanded with synonyms and word variants
- Sort by
sales_descto find popular/trusted products (best on XHS) - Use
platformfilter to narrow results to a specific platform - Use
get_product_detailwith a URL directly — no need to parse first