cn-ecommerce-search

Original：🇺🇸 English

Translated

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.

7installs

Sourceshopmeskills/mcp

Added on2026-03-09

NPX Install

npx skill4agent add shopmeskills/mcp cn-ecommerce-search

SKILL.md Content

View Translation Comparison →

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

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)

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=123456
```
```
detail.tmall.com/item.htm?id=123456
```
```
mall.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_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