cn-ecommerce-search

name	cn-ecommerce-search
description	Search products across 8 Chinese e-commerce platforms: Taobao, Tmall, JD, PDD, 1688, AliExpress, Douyin, 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.
version	2.0.0
license	MIT
metadata	{"author":"shopme","version":"2.0.0","mcp-server":"@shopmeagent/cn-ecommerce-search-mcp"}

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

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

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

• 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
• Short links: e.tb.cn/xxx, m.tb.cn/xxx

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)
2. English keywords are auto-expanded with synonyms and word variants
3. Sort by sales_desc to find popular/trusted products (best on XHS)
4. Use platform filter to narrow results to a specific platform
5. Use get_product_detail with a URL directly — no need to parse first