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