← Back to Skills Marketplace
shopmeskills

Cn Ecommerce Search

by Shopme · GitHub ↗ · v2.0.0
cross-platform ✓ Security Clean
6236
Downloads
8
Stars
37
Active Installs
2
Versions
Install in OpenClaw
/install cn-ecommerce-search
Description
Search products across 8 Chinese e-commerce platforms: Taobao, Tmall, JD, PDD, 1688, AliExpress, Douyin, XHS. Zero-config — no API keys needed. Powered by Sh...
README (SKILL.md)

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
Usage Guidance
Before installing, make sure you trust the Shopme npm package and provider. Avoid using it for confidential sourcing plans or private product research unless you are comfortable sending search terms and product URLs to Shopme's service.
Capability Analysis
Type: OpenClaw Skill Name: cn-ecommerce-search Version: 2.0.0 The skill bundle is classified as suspicious due to the use of `npx -y @shopmeagent/cn-ecommerce-search-mcp` in `SKILL.md`. While the stated purpose is benign (running an e-commerce search skill), `npx` downloads and executes an arbitrary npm package, which represents a significant supply chain risk. This is a risky capability involving shell execution and network access to an external registry, even if plausibly needed for the skill's operation, and could lead to arbitrary code execution if the npm package were compromised.
Capability Assessment
Purpose & Capability
The documented purpose, tools, and supported platforms fit together: product keyword search, product detail lookup by URL or ID, and local link parsing for Chinese e-commerce marketplaces. The external Shopme database is disclosed.
Instruction Scope
The instructions are scoped to user-requested product search, supplier lookup, price comparison, and product detail workflows. I found no artifact-backed prompt override, hidden behavior, destructive action, purchase authority, or credential harvesting.
Install Mechanism
The setup uses npx -y @shopmeagent/cn-ecommerce-search-mcp, so the actual executable MCP server is fetched from npm and is not included in the reviewed artifact. This is a supply-chain consideration, but it is clearly disclosed and purpose-aligned.
Credentials
No API key or required environment variable is requested. The optional SHOPME_API_BASE and default Shopme API endpoint mean product queries or URLs may go to an external service, which is proportionate for a live product-search skill.
Persistence & Privilege
The provided artifacts do not show persistence, privileged local access, account mutation, broad file indexing, local auth/session use, background workers, or payment/purchase actions.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install cn-ecommerce-search
  3. After installation, invoke the skill by name or use /cn-ecommerce-search
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
**Major update: Expanded platform support and simplified setup.** - Now supports 8 Chinese e-commerce platforms: added JD, PDD, Douyin, XHS alongside Taobao, Tmall, 1688, AliExpress. - Zero configuration required — no API keys or environment variables needed. - All product search and detail retrieval powered by Shopme’s unified product database. - New and updated tool parameters, including improved filters, platform codes, and easier product lookup by URL or ID. - Enhanced documentation: updated usage instructions, platform guide, and supported URL formats.
v1.0.0
Initial release of cn-ecommerce-search - Search products on Taobao, Tmall, 1688, and AliExpress by keyword. - Retrieve detailed product information using product ID or URL. - Parse product links to identify platform and extract product IDs. - Compare product prices and details across supported Chinese e-commerce platforms. - Supports both Chinese and English keywords; guides on optimal usage for each platform. - Includes a platform guide, supported URL formats, and price comparison tips.
Metadata
Slug cn-ecommerce-search
Version 2.0.0
License
All-time Installs 37
Active Installs 37
Total Versions 2
Frequently Asked Questions

What is Cn Ecommerce Search?

Search products across 8 Chinese e-commerce platforms: Taobao, Tmall, JD, PDD, 1688, AliExpress, Douyin, XHS. Zero-config — no API keys needed. Powered by Sh... It is an AI Agent Skill for Claude Code / OpenClaw, with 6236 downloads so far.

How do I install Cn Ecommerce Search?

Run "/install cn-ecommerce-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Cn Ecommerce Search free?

Yes, Cn Ecommerce Search is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Cn Ecommerce Search support?

Cn Ecommerce Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Cn Ecommerce Search?

It is built and maintained by Shopme (@shopmeskills); the current version is v2.0.0.

💬 Comments