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_desc to find popular/trusted products (best on XHS)
- Use
platform filter to narrow results to a specific platform
- Use
get_product_detail with a URL directly — no need to parse first
1---2name: cn-ecommerce-search3description: Search products across 8 Chinese e-commerce platforms: Taobao, Tmall, JD, PDD, 1688, AliExpress, Douyin, 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.4license: MIT5---6
7# Chinese E-commerce Product Search
8
9Search and retrieve product information across 8 Chinese e-commerce platforms via the Shopme unified product database.
10
11**Zero-config — no API keys required.**
12
13## When to Use
14
15- User asks to find a product on any Chinese e-commerce platform
16- User shares a product link and wants details
17- User needs to search Chinese suppliers for a product
18- User asks about prices on Chinese platforms
19- User provides a product URL from Taobao, JD, PDD, 1688, etc.
20- User wants to compare products across platforms
21
22## MCP Server Setup
23
24```json
25{
26 "mcpServers": {
27 "cn-ecommerce-search": {
28 "command": "npx",
29 "args": ["-y", "@shopmeagent/cn-ecommerce-search-mcp"]
30 }
31 }
32}
33```
34
35No environment variables required. Optional:
36
37| Variable | Default | Description |
38|----------|---------|-------------|
39| `SHOPME_API_BASE` | `https://api.shopmeagent.com` | Override API endpoint (e.g. `http://localhost:8000` for local dev) |
40
41## Available Tools
42
43### search_products
44
45Search products by keyword across platforms.
46
47| Parameter | Type | Required | Default | Description |
48|-----------|------|----------|---------|-------------|
49| `keyword` | string | **Yes** | — | Search term (Chinese or English) |
50| `platform` | string | No | all | Filter by platform (see table below) |
51| `sort_by` | string | No | `relevance` | `relevance`, `price_asc`, `price_desc`, `sales_desc`, `created_at` |
52| `page` | number | No | 1 | Page number |
53| `limit` | number | No | 10 | Items per page (max 50) |
54
55### get_product_detail
56
57Get detailed info about a specific product by ID or URL.
58
59| Parameter | Type | Required | Description |
60|-----------|------|----------|-------------|
61| `product_id` | string | One of two | Product ID (recommended, faster) |
62| `url` | string | One of two | Product URL |
63| `platform` | string | No | Platform hint to speed up lookup |
64
65### parse_product_link
66
67Parse a product URL to identify the platform and product ID. Runs locally, no API call.
68
69| Parameter | Type | Required | Description |
70|-----------|------|----------|-------------|
71| `url` | string | **Yes** | Product URL or text containing one |
72
73## Supported Platforms
74
75| Platform | Code | Strengths | Price Range | Typical Buyer |
76|----------|------|-----------|-------------|---------------|
77| **淘宝 Taobao** | `taobao` | Largest selection, consumer goods | ¥ Low-Mid | End consumers |
78| **天猫 Tmall** | `tmall` | Brand flagship stores, higher quality | ¥ Mid-High | Quality-focused |
79| **京东 JD** | `jd` | Fast logistics, electronics, appliances | ¥ Mid-High | Quality + speed |
80| **拼多多 PDD** | `pdd` | Group-buy deals, lowest prices | ¥ Lowest | Price-sensitive |
81| **1688** | `ali1688` | Wholesale/factory direct, bulk pricing | ¥ Lowest (bulk) | Resellers, businesses |
82| **速卖通 AliExpress** | `aliexpress` | International shipping, buyer protection | $ Mid | International buyers |
83| **抖音 Douyin** | `douyin` | Live-commerce, trending products | ¥ Low-Mid | Trend followers |
84| **小红书 XHS** | `xhs` | Community picks, beauty/lifestyle | ¥ Mid | Young women, lifestyle |
85
86## Supported URL Formats
87
88- `item.taobao.com/item.htm?id=123456`
89- `detail.tmall.com/item.htm?id=123456`
90- `detail.1688.com/offer/123456.html`
91- `item.jd.com/123456.html`
92- `mobile.yangkeduo.com/goods.html?goods_id=123456`
93- `aliexpress.com/item/123456.html`
94- `haohuo.jinritemai.com/...?id=123456`
95- `mall.xiaohongshu.com/goods-detail/xxx`
96- Short links: `e.tb.cn/xxx`, `m.tb.cn/xxx`
97
98## Price Understanding Guide
99
100- All platforms except AliExpress return prices in **CNY (¥)**. Rough conversion: 1 USD ≈ 7.2 CNY
101- AliExpress prices in the database are also stored as CNY
102- 1688 prices are factory/wholesale, often 30-70% lower than Taobao for the same product
103- Always consider shipping costs when comparing prices
104
105## Search Tips
106
1071. **Chinese keywords** get more results on domestic platforms (Taobao, JD, PDD, 1688)
1082. **English keywords** are auto-expanded with synonyms and word variants
1093. Sort by `sales_desc` to find popular/trusted products (best on XHS)
1104. Use `platform` filter to narrow results to a specific platform
1115. Use `get_product_detail` with a URL directly — no need to parse first
johnalbertini14-glitch