best-price-mcp 0.5.0

MCP tool for comparing prices across JD and Tmall

best-price-mcp

MCP tool for comparing prices across JD (京东), Taobao (淘宝/天猫), and PDD (拼多多).

Installation

pip install best-price-mcp

Usage

As MCP Server

best-price-mcp

Tool: compare_price

Search for the same product across major Chinese e-commerce platforms and compare final prices.

Parameters:

• query (string): Product keyword, title, or link. For best results, copy the full product title.
• platform (string, optional): "jd", "taobao", "pdd", or "all" (default)

Supported Categories (37 Standard Product Types)

Phones, smart watches, tablets, laptops, monitors, printers, storage, GPUs, earphones, cameras, projectors, game consoles, routers, keyboards/mice, robot vacuums, TVs, refrigerators, washing machines, ACs, water heaters, hair dryers, shavers, electric toothbrushes, air purifiers, water purifiers, blenders, air fryers, rice cookers, branded sneakers, branded bags, branded watches, perfume, liquor, baby formula, diapers, books, branded grain/oil.

Not Supported

Clothing, non-branded shoes/bags, accessories, home decor, custom/handmade items.

Usage Scenarios

Scenario	Example	Handling
Copy product title (recommended)	华为Mate70 Pro 12+512 雅丹黑	Noise cleaning → search
Type brand + model	iPhone 17 Pro Max 256G	Direct search
APP share link (fallback)	【淘宝】https://e.tb.cn/...	Parse → search
PC link	item.jd.com/12345.html	Prompt to copy title
Vague input	华为手机	Guide to copy title

Selection Logic

Each platform returns 1 best pick + 0-2 alternatives:

Platform	Best Pick Logic
JD	Brand flagship self-operated store → lowest 到手价 → highest rating. Rating <95% flagged.
Taobao	Tmall only. Brand flagship store priority → lowest 到手价 → highest sales.
PDD	Brand name match priority → lowest 到手价 → highest sales. Irrelevant results filtered out.

Price Fields

Field	Meaning
price	Original price (原价)
final_price	Actual price after all coupons (到手价) — what you actually pay
saved	Amount saved vs original price
coupon	Savings summary (e.g. "省¥500")

Link Resolution Strategy

Scenario	JD	Taobao/Tmall	PDD
APP share link	Extract name from 「」	API lookup → fallback 「」	Prompt user to copy title
PC link	Prompt user to copy title	Prompt user to copy title	N/A

License

MIT