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

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

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

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