cn-ecommerce-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Chinese E-commerce Product Search

中国电商平台产品搜索

Search and retrieve product information from Taobao, Tmall, 1688, and AliExpress.

可从淘宝、天猫、1688和AliExpress搜索并获取产品信息。

When to Use

使用场景

User asks to find a product on Taobao, 1688, or AliExpress
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 that looks like it's from a Chinese e-commerce site

用户要求在淘宝、1688或AliExpress上查找产品
用户分享产品链接并想要获取详情
用户需要为某产品搜索中国供应商
用户询问中国电商平台上的产品价格
用户提供看起来来自中国电商网站的产品URL

MCP Server Setup

MCP服务器配置

json

{
  "mcpServers": {
    "cn-ecommerce-search": {
      "command": "npx",
      "args": ["-y", "@shopme/cn-ecommerce-search-mcp"],
      "env": {
        "TAOBAO_APP_KEY": "your-key",
        "TAOBAO_APP_SECRET": "your-secret",
        "TAOBAO_ACCESS_TOKEN": "your-token",
        "ALIEXPRESS_DS_KEY": "your-key",
        "ALIEXPRESS_DS_SECRET": "your-secret"
      }
    }
  }
}

json

{
  "mcpServers": {
    "cn-ecommerce-search": {
      "command": "npx",
      "args": ["-y", "@shopme/cn-ecommerce-search-mcp"],
      "env": {
        "TAOBAO_APP_KEY": "your-key",
        "TAOBAO_APP_SECRET": "your-secret",
        "TAOBAO_ACCESS_TOKEN": "your-token",
        "ALIEXPRESS_DS_KEY": "your-key",
        "ALIEXPRESS_DS_SECRET": "your-secret"
      }
    }
  }
}

Available Tools

可用工具

search_products

Search products by keyword across platforms.

```
keyword
```
: Search term (Chinese or English)
```
platform
```
: "taobao", "aliexpress", or "all" (default)
```
sort
```
: PRICE_ASC, PRICE_DESC, SALE_QTY_DESC
```
pageNo
```
,
```
pageSize
```
: Pagination

跨平台通过关键词搜索产品。

```
keyword
```
: 搜索关键词（中文或英文）
```
platform
```
: "taobao"、"aliexpress"或"all"（默认值）
```
sort
```
: PRICE_ASC（价格升序）、PRICE_DESC（价格降序）、SALE_QTY_DESC（销量降序）
```
pageNo
```
、
```
pageSize
```
: 分页参数

get_product_detail

Get detailed info about a specific product.

```
productId
```
: The product's ID
```
platform
```
: "taobao" or "aliexpress"

获取特定产品的详细信息。

```
productId
```
: 产品ID
```
platform
```
: "taobao"或"aliexpress"

parse_product_link

Parse a product URL to identify the platform and product ID.

```
url
```
: Any product URL or text containing one

解析产品URL以识别所属平台和产品ID。

```
url
```
: 任意产品URL或包含URL的文本

get_product_from_url

One-step: parse URL + fetch product details.

```
url
```
: Product URL from any supported platform

一步操作：解析URL + 获取产品详情。

```
url
```
: 来自任意支持平台的产品URL

Platform Guide

平台指南

Platform	Strengths	Price Range	Typical Buyer
Taobao	Largest selection, consumer goods	¥ Low-Mid	End consumers
Tmall	Brand flagship stores, higher quality	¥ Mid-High	Quality-focused
1688	Wholesale/factory direct, bulk pricing	¥ Lowest	Resellers, businesses
AliExpress	International shipping, buyer protection	$ Mid	International buyers

平台	优势	价格区间	典型买家
淘宝	商品品类最丰富，主打消费品	¥ 低-中	终端消费者
天猫	品牌旗舰店聚集，品质更高	¥ 中-高	注重品质的消费者
1688	工厂直供/批发，批量定价	¥ 最低	经销商、企业买家
AliExpress	支持国际配送，买家保障完善	$ 中	国际买家

Supported URL Formats

支持的URL格式

```
item.taobao.com/item.htm?id=123456
```
```
detail.tmall.com/item.htm?id=123456
```
```
detail.1688.com/offer/123456.html
```
```
aliexpress.com/item/123456.html
```
```
aliexpress.com/i/123456.html
```
```
mall.xiaohongshu.com/goods-detail/xxx
```
Short links:
```
e.tb.cn/xxx
```
,
```
m.tb.cn/xxx
```

```
item.taobao.com/item.htm?id=123456
```
```
detail.tmall.com/item.htm?id=123456
```
```
detail.1688.com/offer/123456.html
```
```
aliexpress.com/item/123456.html
```
```
aliexpress.com/i/123456.html
```
```
mall.xiaohongshu.com/goods-detail/xxx
```
短链接:
```
e.tb.cn/xxx
```
,
```
m.tb.cn/xxx
```

Price Understanding Guide

价格理解指南

Taobao/Tmall prices are in CNY (¥). Rough conversion: 1 USD ≈ 7.2 CNY
AliExpress shows prices in buyer's currency (usually USD)
1688 prices are factory/wholesale prices in CNY, often much lower
Always consider shipping costs when comparing prices

淘宝/天猫的价格以人民币（¥）计价，大致汇率：1美元 ≈ 7.2人民币
AliExpress显示的价格为买家当地货币（通常为美元）
1688的价格为工厂/批发价，以人民币计价，通常远低于淘宝
对比价格时请务必考虑运费成本

Search Tips

搜索技巧

Chinese keywords get better results on Taobao/1688
English keywords work well on AliExpress
Sort by
```
SALE_QTY_DESC
```
to find popular/trusted products
Compare the same product across Taobao and AliExpress to find price gaps
1688 often has the same product at 30-70% lower price than Taobao (wholesale)

在淘宝/1688上使用中文关键词能获得更好的搜索结果
在AliExpress上使用英文关键词效果更佳
按
```
SALE_QTY_DESC
```
排序可找到热门/口碑好的产品
对比淘宝和AliExpress上的同款产品，找出价格差异
1688上同款产品的价格通常比淘宝低30%-70%（批发价）