cn-ecommerce-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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.

通过Shopme统一商品数据库，跨中国电商平台搜索并获取商品信息。

零配置——无需API密钥。

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

用户要求在淘宝、天猫或小红书上查找商品
用户分享商品链接并想要了解详情
用户需要为某商品搜索中国供应商
用户询问中国电商平台上的商品价格
用户提供来自淘宝、天猫或XHS的商品URL
用户想要跨平台对比商品

MCP Server Setup

MCP服务器设置

json

{
  "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)

json

{
  "mcpServers": {
    "cn-ecommerce-search": {
      "command": "npx",
      "args": ["-y", "@shopmeagent/cn-ecommerce-search-mcp"]
    }
  }
}

无需环境变量。可选配置：

变量名	默认值	说明
`SHOPME_API_BASE`	`https://api.shopmeagent.com`	覆盖API端点（例如本地开发时使用 `http://localhost:8000` ）

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)

通过关键词跨平台搜索商品。

参数	类型	必填	默认值	说明
`keyword`	string	是	—	搜索词（中文或英文）
`platform`	string	否	all	按平台筛选： `xhs` , `taobao` , `tmall`
`sort_by`	string	否	`relevance`	`relevance` （相关性）、 `price_asc` （价格升序）、 `price_desc` （价格降序）、 `sales_desc` （销量降序）、 `created_at` （上架时间）
`page`	number	否	1	页码
`limit`	number	否	10	每页商品数量（最多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

通过ID或URL获取特定商品的详细信息。

参数	类型	必填	说明
`product_id`	string	二选一	商品ID（推荐使用，速度更快）
`url`	string	二选一	商品URL
`platform`	string	否	平台提示，用于加快查找速度

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

解析商品URL以识别平台和商品ID。本地运行，无需调用API。

参数	类型	必填	说明
`url`	string	是	商品URL或包含URL的文本

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

平台	代码	优势	价格区间	典型买家
淘宝 Taobao	`taobao`	商品品类最丰富，主打消费品	¥ 低-中	终端消费者
天猫 Tmall	`tmall`	品牌旗舰店，品质更高	¥ 中-高	注重品质的消费者
小红书 XHS	`xhs`	社区精选，主打美妆/生活方式	¥ 中	年轻女性、生活方式爱好者

Supported URL Formats

支持的URL格式

```
item.taobao.com/item.htm?id=123456
```
```
detail.tmall.com/item.htm?id=123456
```
```
mall.xiaohongshu.com/goods-detail/xxx
```
Short links:
```
e.tb.cn/xxx
```
,
```
m.tb.cn/xxx
```

```
item.taobao.com/item.htm?id=123456
```
```
detail.tmall.com/item.htm?id=123456
```
```
mall.xiaohongshu.com/goods-detail/xxx
```
短链接：
```
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

所有价格均为人民币（¥）。大致汇率：1 USD ≈ 7.2 CNY
比价时请务必考虑运费

Search Tips

搜索技巧

Chinese keywords get more results
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

中文关键词能获取更多结果
英文关键词会自动扩展同义词和变体
按
```
sales_desc
```
排序可找到热门/可信商品（在小红书上效果最佳）
使用
```
platform
```
筛选器将结果限定在特定平台
直接使用
```
get_product_detail
```
工具处理URL——无需先解析