cn-ecommerce-search

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