MCP tool for comparing prices across JD, Taobao, and PDD
Project description
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file best_price_mcp-0.4.0.tar.gz.
File metadata
- Download URL: best_price_mcp-0.4.0.tar.gz
- Upload date:
- Size: 18.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2a5e4806323a6d5e6e5077643ad4253746d233e6e4546838e9872b14e37b952b
|
|
| MD5 |
7c2238eaed9524e7bf44cbd8377ca429
|
|
| BLAKE2b-256 |
d021a8af0377fa384296a473d3a9a082bed7924051bdcf82fa853f2dc215dda2
|
File details
Details for the file best_price_mcp-0.4.0-py3-none-any.whl.
File metadata
- Download URL: best_price_mcp-0.4.0-py3-none-any.whl
- Upload date:
- Size: 17.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
12ab3c70ac09253785317daf315c9f436e64e26dcbb53df2153d32ad76e04249
|
|
| MD5 |
5a53dd27bc47f496a7b30dc17125083b
|
|
| BLAKE2b-256 |
b4910aa7fa37462656788ac880a6017af15c997db8781aec9b328d0709307acc
|