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
CODEBLOCK0
No environment variables required. Optional:
| Variable | Default | Description |
|---|
| INLINECODE0 | INLINECODE1 | 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 |
|---|
| INLINECODE3 | string | Yes | — | Search term (Chinese or English) |
| INLINECODE4 |
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) |
getproductdetail
Get detailed info about a specific product by ID or URL.
| Parameter | Type | Required | Description |
|---|
| INLINECODE14 | string | One of two | Product ID (recommended, faster) |
| INLINECODE15 |
string | One of two | Product URL |
|
platform | string | No | Platform hint to speed up lookup |
parseproductlink
Parse a product URL to identify the platform and product ID. Runs locally, no API call.
| Parameter | Type | Required | Description |
|---|
| INLINECODE17 | string | Yes | Product URL or text containing one |
Supported Platforms
| Platform | Code | Strengths | Price Range | Typical Buyer |
|---|
| 淘宝 Taobao | INLINECODE18 | 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
- - INLINECODE26
- INLINECODE27
- INLINECODE28
- INLINECODE29
- INLINECODE30
- INLINECODE31
- INLINECODE32
- INLINECODE33
- Short links:
e.tb.cn/xxx, INLINECODE35
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
- 1. 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
中文电商商品搜索
通过Shopme统一产品数据库，在8个中国电商平台中搜索和检索商品信息。
零配置 — 无需API密钥。
使用场景
- - 用户要求在任何中国电商平台查找商品
- 用户分享商品链接并希望获取详细信息
- 用户需要搜索某商品的国内供应商
- 用户询问国内平台的价格信息
- 用户提供来自淘宝、京东、拼多多、1688等平台的商品链接
- 用户希望跨平台比较商品
MCP服务器配置
json
{
mcpServers: {
cn-ecommerce-search: {
command: npx,
args: [-y, @shopmeagent/cn-ecommerce-search-mcp]
}
}
}
无需环境变量。可选参数：
| 变量 | 默认值 | 说明 |
|---|
| SHOPMEAPIBASE | https://api.shopmeagent.com | 覆盖API端点（例如本地开发使用http://localhost:8000） |
可用工具
search_products
按关键词跨平台搜索商品。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
| keyword | 字符串 | 是 | — | 搜索词（中文或英文） |
| platform |
字符串 | 否 | all | 按平台筛选（见下表） |
| sort
by | 字符串 | 否 | relevance | relevance（相关度）、priceasc（价格升序）、price
desc（价格降序）、salesdesc（销量降序）、created_at（发布时间） |
| page | 数字 | 否 | 1 | 页码 |
| limit | 数字 | 否 | 10 | 每页数量（最大50） |
getproductdetail
通过ID或链接获取特定商品的详细信息。
| 参数 | 类型 | 必填 | 说明 |
|---|
| product_id | 字符串 | 二选一 | 商品ID（推荐，速度更快） |
| url |
字符串 | 二选一 | 商品链接 |
| platform | 字符串 | 否 | 平台提示，加速查找 |
parseproductlink
解析商品链接以识别平台和商品ID。本地运行，无需API调用。
| 参数 | 类型 | 必填 | 说明 |
|---|
| url | 字符串 | 是 | 商品链接或包含链接的文本 |
支持平台
| 平台 | 代码 | 优势 | 价格区间 | 典型买家 |
|---|
| 淘宝 Taobao | taobao | 品类最全，消费品丰富 | ¥ 低-中 | 终端消费者 |
| 天猫 Tmall |
tmall | 品牌旗舰店，品质保障 | ¥ 中-高 | 注重品质 |
|
京东 JD | jd | 物流快，电子家电优势 | ¥ 中-高 | 注重品质+速度 |
|
拼多多 PDD | pdd | 拼团优惠，价格最低 | ¥ 最低 | 价格敏感型 |
|
1688 | ali1688 | 批发/工厂直供，批量价格 | ¥ 最低（批量） | 经销商、企业 |
|
速卖通 AliExpress | aliexpress | 国际配送，买家保障 | $ 中 | 国际买家 |
|
抖音 Douyin | douyin | 直播电商，热门商品 | ¥ 低-中 | 潮流追随者 |
|
小红书 XHS | xhs | 社区推荐，美妆/生活方式 | ¥ 中 | 年轻女性、生活方式 |
支持的链接格式
- - item.taobao.com/item.htm?id=123456
- detail.tmall.com/item.htm?id=123456
- detail.1688.com/offer/123456.html
- item.jd.com/123456.html
- mobile.yangkeduo.com/goods.html?goods_id=123456
- aliexpress.com/item/123456.html
- haohuo.jinritemai.com/...?id=123456
- mall.xiaohongshu.com/goods-detail/xxx
- 短链接：e.tb.cn/xxx、m.tb.cn/xxx
价格理解指南
- - 除速卖通外，所有平台价格均以人民币（¥）显示。粗略换算：1美元 ≈ 7.2人民币
- 数据库中速卖通的价格也以人民币存储
- 1688价格为工厂/批发价，同款商品通常比淘宝低30-70%
- 比较价格时请始终考虑运费
搜索技巧
- 1. 中文关键词在国内平台（淘宝、京东、拼多多、1688）获得更多结果
- 英文关键词会自动扩展同义词和词形变化
- 按salesdesc（销量降序）排序可找到热门/可信商品（小红书效果最佳）
- 使用platform筛选条件将结果限定在特定平台
- 直接使用链接调用getproduct_detail — 无需先解析
