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.4---56# Chinese E-commerce Product Search78Search and retrieve product information across 8 Chinese e-commerce platforms via the Shopme unified product database.910**Zero-config — no API keys required.**1112## When to Use1314- User asks to find a product on any Chinese e-commerce platform15- User shares a product link and wants details16- User needs to search Chinese suppliers for a product17- User asks about prices on Chinese platforms18- User provides a product URL from Taobao, JD, PDD, 1688, etc.19- User wants to compare products across platforms2021## MCP Server Setup2223```json24{25 "mcpServers": {26 "cn-ecommerce-search": {27 "command": "npx",28 "args": ["-y", "@shopmeagent/cn-ecommerce-search-mcp"]29 }30 }31}32```3334No environment variables required. Optional:3536| Variable | Default | Description |37|----------|---------|-------------|38| `SHOPME_API_BASE` | `https://api.shopmeagent.com` | Override API endpoint (e.g. `http://localhost:8000` for local dev) |3940## Available Tools4142### search_products4344Search products by keyword across platforms.4546| Parameter | Type | Required | Default | Description |47|-----------|------|----------|---------|-------------|48| `keyword` | string | **Yes** | — | Search term (Chinese or English) |49| `platform` | string | No | all | Filter by platform (see table below) |50| `sort_by` | string | No | `relevance` | `relevance`, `price_asc`, `price_desc`, `sales_desc`, `created_at` |51| `page` | number | No | 1 | Page number |52| `limit` | number | No | 10 | Items per page (max 50) |5354### get_product_detail5556Get detailed info about a specific product by ID or URL.5758| Parameter | Type | Required | Description |59|-----------|------|----------|-------------|60| `product_id` | string | One of two | Product ID (recommended, faster) |61| `url` | string | One of two | Product URL |62| `platform` | string | No | Platform hint to speed up lookup |6364### parse_product_link6566Parse a product URL to identify the platform and product ID. Runs locally, no API call.6768| Parameter | Type | Required | Description |69|-----------|------|----------|-------------|70| `url` | string | **Yes** | Product URL or text containing one |7172## Supported Platforms7374| Platform | Code | Strengths | Price Range | Typical Buyer |75|----------|------|-----------|-------------|---------------|76| **淘宝 Taobao** | `taobao` | Largest selection, consumer goods | ¥ Low-Mid | End consumers |77| **天猫 Tmall** | `tmall` | Brand flagship stores, higher quality | ¥ Mid-High | Quality-focused |78| **京东 JD** | `jd` | Fast logistics, electronics, appliances | ¥ Mid-High | Quality + speed |79| **拼多多 PDD** | `pdd` | Group-buy deals, lowest prices | ¥ Lowest | Price-sensitive |80| **1688** | `ali1688` | Wholesale/factory direct, bulk pricing | ¥ Lowest (bulk) | Resellers, businesses |81| **速卖通 AliExpress** | `aliexpress` | International shipping, buyer protection | $ Mid | International buyers |82| **抖音 Douyin** | `douyin` | Live-commerce, trending products | ¥ Low-Mid | Trend followers |83| **小红书 XHS** | `xhs` | Community picks, beauty/lifestyle | ¥ Mid | Young women, lifestyle |8485## Supported URL Formats8687- `item.taobao.com/item.htm?id=123456`88- `detail.tmall.com/item.htm?id=123456`89- `detail.1688.com/offer/123456.html`90- `item.jd.com/123456.html`91- `mobile.yangkeduo.com/goods.html?goods_id=123456`92- `aliexpress.com/item/123456.html`93- `haohuo.jinritemai.com/...?id=123456`94- `mall.xiaohongshu.com/goods-detail/xxx`95- Short links: `e.tb.cn/xxx`, `m.tb.cn/xxx`9697## Price Understanding Guide9899- All platforms except AliExpress return prices in **CNY (¥)**. Rough conversion: 1 USD ≈ 7.2 CNY100- AliExpress prices in the database are also stored as CNY101- 1688 prices are factory/wholesale, often 30-70% lower than Taobao for the same product102- Always consider shipping costs when comparing prices103104## Search Tips1051061. **Chinese keywords** get more results on domestic platforms (Taobao, JD, PDD, 1688)1072. **English keywords** are auto-expanded with synonyms and word variants1083. Sort by `sales_desc` to find popular/trusted products (best on XHS)1094. Use `platform` filter to narrow results to a specific platform1105. Use `get_product_detail` with a URL directly — no need to parse first
dvcrn