Cn Ecommerce Search
- 1k installs
- 3 repo stars
- Updated February 20, 2026
- shopmeskills/mcp
cn-ecommerce-search is a Claude Code skill that lets coding agents search and retrieve real-time product data from Taobao, Tmall, and Xiaohongshu via Shopme with zero API keys.
About
cn-ecommerce-search is a zero-config Chinese e-commerce product search skill at version 2.0.0, powered by the @shopmeagent/cn-ecommerce-search-mcp server and Shopme unified product database. It searches Taobao, Tmall, and Xiaohongshu (XHS) without API keys, returning product info by keyword, URL, or ID for price comparison and supplier research. Developers reach for cn-ecommerce-search when building agent tools, dashboards, or procurement scripts that need live CN marketplace data instead of maintaining platform-specific scrapers or vendor credentials.
- Zero-config MCP server — no API keys or credentials required
- Unified search across Taobao, Tmall, and Xiaohongshu (小红书)
- Supports product lookup by keyword, URL, or ID
- Enables price comparison and Chinese supplier discovery
- Powered by Shopme unified product database
Cn Ecommerce Search by the numbers
- 1,002 all-time installs (skills.sh)
- +19 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #398 of 4,347 Backend & APIs skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/shopmeskills/mcp --skill cn-ecommerce-searchAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1k |
|---|---|
| repo stars | ★ 3 |
| Last updated | February 20, 2026 |
| Repository | shopmeskills/mcp ↗ |
How do agents search Taobao and Tmall products?
Let their AI coding agent search and retrieve real-time product data from Taobao, Tmall, and Xiaohongshu without any API keys.
Who is it for?
Developers building agent or backend tools that need live Chinese marketplace product search without configuring platform API keys.
Skip if: Projects targeting Western marketplaces only or teams blocked from using third-party aggregated product databases.
When should I use this skill?
The user asks to find products on Taobao, Tmall, Xiaohongshu, compare CN prices, or fetch product info by URL or ID.
What you get
Product listings, price data, and item metadata from Taobao, Tmall, and Xiaohongshu via MCP tool responses.
- Product search results
- Price and listing metadata
- Item details by URL or ID
By the numbers
- Skill version 2.0.0
- Covers 3 Chinese e-commerce platforms: Taobao, Tmall, Xiaohongshu
Files
Chinese E-commerce Product Search
Search and retrieve product information across 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 Taobao, Tmall, or 小红书
- 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, Tmall, or XHS
- 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: xhs, taobao, tmall |
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 |
| 小红书 XHS | xhs | Community picks, beauty/lifestyle | ¥ Mid | Young women, lifestyle |
Supported URL Formats
item.taobao.com/item.htm?id=123456detail.tmall.com/item.htm?id=123456mall.xiaohongshu.com/goods-detail/xxx- Short links:
e.tb.cn/xxx,m.tb.cn/xxx
Price Understanding Guide
- All prices are in CNY (¥). Rough conversion: 1 USD ≈ 7.2 CNY
- Always consider shipping costs when comparing prices
Search Tips
1. Chinese keywords get more results 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
Related skills
Lark Openapi ExplorerInstantly explore, test, and generate calls against the full Lark (Feishu) OpenAPI surface without leaving their agent workflow.493k
Lark EventConsume real-time events from Lark/Feishu as structured NDJSON streams inside AI agent workflows.387k16kLark Openapi ExplorerWhen an existing Lark/Feishu skill or CLI command cannot fulfill a specific requirement and they need to discover and invoke the exact native OpenAPI endpoint.386k16k
Just ScrapeQuickly search, crawl, extract structured JSON, or monitor web pages without writing custom scraping code.245k41Lark AppsQuery the current visibility and permission scope of a Lark (Feishu) app without writing HTTP client code.235k16k
Design An InterfaceGenerate multiple radically different interface or API designs in parallel before committing to one.188k198kHow it compares
Use cn-ecommerce-search for keyless CN marketplace lookups in agents; build custom scrapers only when Shopme coverage or compliance rules require direct platform APIs.
FAQ
Which Chinese platforms does cn-ecommerce-search cover?
cn-ecommerce-search searches Taobao, Tmall, and Xiaohongshu via the Shopme unified product database through @shopmeagent/cn-ecommerce-search-mcp, returning product info by keyword, URL, or ID.
Does cn-ecommerce-search require API keys?
cn-ecommerce-search is zero-config and requires no API keys. Version 2.0.0 connects agents to Shopme's MCP server for live product lookups across supported CN marketplaces.