cn-ecommerce-search

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

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

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

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

Documentation

Documentation

Chinese E-commerce Product Search

When to Use

MCP Server Setup

Available Tools

search_products

get_product_detail

parse_product_link

Supported Platforms

Supported URL Formats

Price Understanding Guide

Search Tips

Documentation

cn-ecommerce-search

Documentation

Chinese E-commerce Product Search

When to Use

MCP Server Setup

Available Tools

search_products

get_product_detail

parse_product_link

Supported Platforms

Supported URL Formats

Price Understanding Guide

Search Tips