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#

json

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

No environment variables required. Optional:

VariableDefaultDescriptionSHOPME_API_BASE``https://api.shopmeagent.comOverride API endpoint (e.g. http://localhost:8000 for local dev)

Available Tools#

search_products#

Search products by keyword across platforms.

ParameterTypeRequiredDefaultDescriptionkeywordstringYes—Search term (Chinese or English)platformstringNoallFilter by platform (see table below)sort_bystringNorelevance``relevance, price_asc, price_desc, sales_desc, created_at``pagenumberNo1Page numberlimitnumberNo10Items per page (max 50)

get_product_detail#

Get detailed info about a specific product by ID or URL.

ParameterTypeRequiredDescriptionproduct_idstringOne of twoProduct ID (recommended, faster)urlstringOne of twoProduct URLplatformstringNoPlatform hint to speed up lookup

parse_product_link#

Parse a product URL to identify the platform and product ID. Runs locally, no API call.

ParameterTypeRequiredDescriptionurlstringYesProduct URL or text containing one

Supported Platforms#

PlatformCodeStrengthsPrice RangeTypical Buyer淘宝 TaobaotaobaoLargest selection, consumer goods¥ Low-MidEnd consumers天猫 TmalltmallBrand flagship stores, higher quality¥ Mid-HighQuality-focused京东 JDjdFast logistics, electronics, appliances¥ Mid-HighQuality + speed拼多多 PDDpddGroup-buy deals, lowest prices¥ LowestPrice-sensitive1688ali1688Wholesale/factory direct, bulk pricing¥ Lowest (bulk)Resellers, businesses速卖通 AliExpressaliexpressInternational shipping, buyer protection$ MidInternational buyers抖音 DouyindouyinLive-commerce, trending products¥ Low-MidTrend followers小红书 XHSxhsCommunity picks, beauty/lifestyle¥ MidYoung 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