Metadata-Version: 2.4
Name: best-price-mcp
Version: 0.8.0
Summary: MCP tool for comparing prices across JD and Tmall
License-Expression: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp[cli]>=1.0.0

# 💰 购物比价助手

专注天猫+京东双平台比价的MCP服务，复制商品标题即可搜索同款最低价，自动筛选旗舰店、计算到手价。

## ✨ 核心特性

▸ 双平台比价 — 京东和天猫同款商品价格一目了然，帮你找到最低价
▸ 到手价计算 — 自动计算原价-优惠券后的到手价，省多少看得见
▸ 智能筛选 — 京东自营+品牌名店，天猫C店自动过滤，旗舰店优先
▸ 配件过滤 — 充电器/手机壳/贴膜等配件自动排除，只看正品
▸ 二手/翻新过滤 — 二手、翻新、拍拍商品自动排除
▸ 品牌一致性校验 — 搜华为不会返回荣耀，搜小米不会返回红米
▸ 子品牌冲突检测 — 精准区分主品牌与子品牌，防止误匹配
▸ 同款变体去重 — 同店同价不同颜色只保留一条
▸ 型号校验 — 搜iPhone 16 Pro Max不会返回iPhone 16e，精准匹配
▸ 37个标品品类 — 手机、电脑、家电、品牌鞋包表、香水、名酒、母婴、图书等
▸ 无需额外申请Key，配置即接入

## 安装

```bash
pip install best-price-mcp
```

## 使用

### 启动MCP服务

```bash
best-price-mcp
```

### 工具：compare_price

复制商品标题，搜索京东和天猫同款价格，智能筛选旗舰店最优选。

**参数：**
- `query`（string，必填）：商品标题/关键词/链接。推荐复制完整商品标题效果最佳
- `platform`（string，选填）：指定平台 "jd"/"taobao"/"all"，默认"all"双平台搜索

### 支持品类（37个标品品类）

手机、智能手表、平板、笔记本、显示器、打印机、存储、显卡、耳机、相机、投影仪、游戏机、路由器、键鼠、扫地机器人、电视、冰箱、洗衣机、空调、热水器、吹风机、剃须刀、电动牙刷、空气净化器、净水器、破壁机、空气炸锅、电饭煲、品牌鞋、品牌包、品牌表、香水、名酒、奶粉、纸尿裤、图书、品牌粮油

不支持：服装、非品牌鞋包、饰品、家居装饰、定制手工

### 使用场景

| 场景 | 示例 | 处理方式 |
|------|------|---------|
| 复制商品标题（推荐） | 华为Mate70 Pro 12+512 雅丹黑 | 噪音清洗→搜索 |
| 输入品牌+型号 | iPhone 17 Pro Max 256G | 直接搜索 |
| APP分享链接（兜底） | 【淘宝】https://e.tb.cn/... | 解析→搜索 |
| PC链接 | item.jd.com/12345.html | 提示复制标题 |
| 拼多多链接 | yangkeduo.com/... | 提示暂不支持，引导复制标题 |
| 模糊输入 | 华为手机 | 引导复制标题 |

### 筛选策略

每个平台返回**1个最优选 + 0-2个备选**：

| 平台 | 最优选逻辑 |
|------|-----------|
| 京东 | 自营优先→品牌名店→到手价最低→好评率最高。好评率<95%加提醒。二手/翻新/拍拍自动过滤 |
| 天猫 | 仅天猫店铺（C店已过滤）→ 旗舰店优先 → 到手价最低 → 销量最高 |

### 价格字段

| 字段 | 含义 |
|------|------|
| `price` | 原价 |
| `final_price` | **到手价** — 扣除优惠券后实际支付价格 |
| `saved` | 节省金额 |
| `coupon` | 优惠信息（如"省¥500"） |

## License

MIT
