概述

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

Chinese keywords get more results on domestic platforms (Taobao, JD, PDD, 1688)
English keywords are auto-expanded with synonyms and word variants
Sort by sales_desc to find popular/trusted products (best on XHS)
Use platform filter to narrow results to a specific platform
Use get_product_detail with a URL directly — no need to parse first

版本历史

共 1 个版本

v1.0.0 当前

2026-05-07 23:37 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)