name: cn-ecommerce-search description: > 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. 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 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 Taobao, Tmall, or 小红书
- 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, Tmall, or XHS
- 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: 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_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 |
| 小红书 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=123456mall.xiaohongshu.com/goods-detail/xxx- Short links:
e.tb.cn/xxx,m.tb.cn/xxx
Price Understanding Guide
- All prices are in CNY (¥). Rough conversion: 1 USD ≈ 7.2 CNY
- Always consider shipping costs when comparing prices
Search Tips
- Chinese keywords get more results
- 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