Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

best_price_mcp-0.4.0.tar.gz (18.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

best_price_mcp-0.4.0-py3-none-any.whl (17.7 kB view details)

Uploaded Python 3

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

Hashes for best_price_mcp-0.4.0.tar.gz
Algorithm Hash digest
SHA256 2a5e4806323a6d5e6e5077643ad4253746d233e6e4546838e9872b14e37b952b
MD5 7c2238eaed9524e7bf44cbd8377ca429
BLAKE2b-256 d021a8af0377fa384296a473d3a9a082bed7924051bdcf82fa853f2dc215dda2

See more details on using hashes here.

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

Hashes for best_price_mcp-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 12ab3c70ac09253785317daf315c9f436e64e26dcbb53df2153d32ad76e04249
MD5 5a53dd27bc47f496a7b30dc17125083b
BLAKE2b-256 b4910aa7fa37462656788ac880a6017af15c997db8781aec9b328d0709307acc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page