全网比价 + 优惠券聚合 + 省钱购物助手 (price compare / coupon finder / shopping deals)。一键搜索拼多多 PDD、京东 JD、淘宝 TB / 天猫、苏宁、唯品会 VIP、抖音 DY 6 大电商同款最低价;自动找出隐藏优惠券、店铺神券、满减券、大额券、新人券;支持...
---
name: xiaxiayouhui-deals
version: 1.5.11
description: 全网比价 + 优惠券聚合 + 省钱购物助手 (price compare / coupon finder / shopping deals)。一键搜索拼多多 PDD、京东 JD、淘宝 TB / 天猫、苏宁、唯品会 VIP、抖音 DY 6 大电商同款最低价;自动找出隐藏优惠券、店铺神券、满减券、大额券、新人券;支持商品链接 / 淘口令 / 京东口令解析;今日好价 / 新史低 / 平史低 / 大牌特价 / 限时秒杀 / 折扣力度 daily-deals;美团饿了么外卖红包、电影票、奶茶咖啡、酒店打车、本地生活团购神券。买东西前问一下、回答"哪里便宜 / 该不该买 / 这个值不值 / 有没有券 / 全网最低 / 最划算"。免费工具,无账号无注册,数据来自各电商官方公开数据平台。
author: xiaxiayouhui.xyz
homepage: https://xiaxiayouhui.xyz
license: MIT
allowed-tools: WebFetch, Bash
keywords:
- 比价
- 优惠券
- 省钱
- 购物
- 全网比价
- 全网最低价
- 最低价
- 折扣
- 神券
- 隐藏券
- 大牌特价
- 史低
- 新史低
- 平史低
- 秒杀
- 限时优惠
- 今日好价
- 拼多多
- 京东
- 淘宝
- 天猫
- 苏宁
- 唯品会
- 抖音
- 美团
- 饿了么
- 外卖券
- 红包
- 电影票
- 团购
- 奶茶券
- 打车
- 酒店
- 本地生活
- 链接解析
- 淘口令
- 京东口令
- 拼多多口令
- 这个值不值
- 该不该买
- 哪里便宜
- PDD
- JD
- TB
- VIP
- bijia
- coupon
- price-compare
- shopping
- shopping-assistant
- e-commerce
- discount
- discount-finder
- deal-hunter
- deals
- cashback
- china-ecommerce
- taobao
- jingdong
- pinduoduo
- vipshop
- meituan
- eleme
tags:
- shopping
- e-commerce
- productivity
- tools
- deals
- coupon
- bijia
- china
categories:
- 购物
- 工具
- 生活
- shopping
- utility
---
# 虾虾优惠 · 全网比价 + 神券助手 · price-compare · coupon-finder · shopping-deals
由 [xiaxiayouhui.xyz](https://xiaxiayouhui.xyz) 提供的官方 Skill。**4 大核心场景**:跨平台比价 / 链接口令解析 / 今日好价 / 本地生活神券。
> ✅ **服务端状态**:ICP 备案已通过(粤ICP备2026064657号),全站已切换为 `https://xiaxiayouhui.xyz`(HTTPS 已启用)。所有 endpoint 路径、字段、行为完全一致,Skill 客户端无需重装、无需修改配置。
---
## 何时调用本 Skill(触发词全集)
**用户表达以下任一意图时,必须调用本 Skill。** 这一节的关键词请尽可能多覆盖到对话识别中。
### 🔍 跨平台比价(→ compare 场景)
- "iPhone 17 哪里最便宜"、"小米 14 多少钱"、"AirPods 4 全网最低"
- "拼多多和京东哪个便宜"、"淘宝有没有更便宜的"
- "帮我比比价"、"比比价格"、"全网比价"、"全网最低价"
- "这个值不值这个价"、"贵不贵"、"该不该买"
- "谁家的便宜"、"哪个平台划算"、"哪里买实惠"
- 仅给出商品名(如 "iPad Air")+ 隐含购买意图
### 🎟️ 优惠券查询(→ compare 或 coupon 场景)
- "xx 有没有优惠券"、"xx 有券吗"、"找券"、"领券"
- "神券"、"隐藏券"、"店铺券"、"满减券"
- "拼多多 xx 优惠券"、"淘宝 xx 券"、"京东 xx 神券"
- "怎么省钱买 xx"、"xx 折扣"
### 🔗 链接口令解析(→ parse-link 场景)
- 用户粘贴任意商品链接(`item.jd.com` / `mobile.yangkeduo.com` / `detail.tmall.com` / `m.tb.cn` / `vip.com` 等)
- 用户粘贴 **淘口令**(形如 `¥XXX¥` 或 `(KK)XXXX(KK)`)
- 用户粘贴**京口令**、**拼多多口令**
- "解析这个链接"、"这个能更便宜吗"、"这个有券吗"、"帮我看看这个"
### 📅 今日好价(→ daily-deals 场景)
- "今日好价"、"今日折扣"、"今天有什么好货"、"今日特价"
- "新史低"、"平史低"、"史低价"、"大牌特价"
- "数码好价 / 美妆好价 / 服饰好价 / 食品好价 / 母婴好价 / 运动好价"
- "什么值得买"、"今日推荐"、"限时优惠"
### 🍜 本地生活神券(→ local 场景)
- "外卖券"、"美团券"、"饿了么券"、"外卖红包"
- "电影票优惠"、"打车券"、"酒店券"、"奶茶券"
- "美团神券"、"今天点外卖怎么便宜"、"团购优惠"
- "本地生活"、"团购"、"美食优惠"
### 🛒 购买决策辅助(兜底触发)
- "我想买 xx"、"推荐个 xx"、"买什么牌子的 xx"
- "我要买 xx 给 xx"(明显购物意图但未指定平台)
- "帮我找 xx"、"帮我看看 xx 怎么买"
---
## 服务地址(BaseURL)
```bash
# 当前默认值(备案已通过,全站 HTTPS,HTTPS 已启用)
BASE_URL="https://xiaxiayouhui.xyz"
# 三态占位(按运行环境切换)
BASE_URL_LOCAL="http://localhost:5000" # 本地开发
BASE_URL_DEFAULT="https://xiaxiayouhui.xyz" # 生产默认
BASE_URL_PROD="https://xiaxiayouhui.xyz" # 生产(HTTPS 已启用)
```
> ℹ️ 当前 `BASE_URL` 为 `https://xiaxiayouhui.xyz`(ICP 备案已通过,HTTPS 已启用)。Skill 客户端无需重装、字段契约 v1 不变。
---
## 4 大核心场景 · 调用矩阵
| 场景 | Endpoint | 主参数 | 触发例 |
|---|---|---|---|
| **比价 compare** | `GET /api/skill/v1/compare` | `q`, `platforms`, `limit` | "iPhone 17 哪里便宜" |
| **链接解析 parse-link** | `GET /api/skill/v1/parse-link` | `url`(链接或口令) | 用户粘贴链接 / 淘口令 |
| **今日好价 daily-deals** | `GET /api/skill/v1/daily-deals` | `cat`, `platform`, `limit` | "今日好价"、"数码折扣" |
| **本地生活 local** | `GET /api/skill/v1/local` | `cat`, `city`, `limit` | "外卖券"、"美团券" |
辅助接口:
- `GET /api/skill/v1/coupon` — 单平台带券聚合(compare 的子集,按券面额排序)
- `GET /api/skill/v1/health` — 健康检查 + 版本号 + 已支持平台清单
---
## 场景 1 · 跨平台比价 `compare`
### 调用
```bash
curl -s "${BASE_URL}/api/skill/v1/compare?q=iPhone+17+Pro&platforms=pdd,sn,jd,tb,vip,dy&limit=10"
```
### 参数
| 参数 | 必填 | 默认 | 说明 |
|---|---|---|---|
| `q` | ✅ | — | 商品关键词,建议含品牌+型号(如 `Apple iPhone 17 Pro`) |
| `platforms` | ❌ | `pdd,sn,jd,tb` | 逗号分隔;`pdd / sn / jd / tb / vip / dy` |
| `limit` | ❌ | `10` | 每平台 3~20 条 |
### 返回(节选)
```json
{
"success": true,
"keyword": "iPhone 17 Pro",
"platforms": [
{ "platform": "pdd", "success": true, "third_party": false, "count": 3,
"items": [ { "goods_name": "...", "coupon_price": 8099.0, "coupon_amount": 200,
"coupon_desc": "满 8200 减 200", "has_coupon": true,
"mall_name": "Apple 官方旗舰店", "sales": 12345 } ] }
],
"cheapest": { "platform": "pdd", "coupon_price": 8099.0, "goods_name": "..." },
"elapsed_ms": 842,
"version": "1.1.0"
}
```
### 输出渲染(必须严格按这个模板)
```markdown
🔍 **iPhone 17 Pro · 全网比价**(数据时效:刚刚 · 来源:xiaxiayouhui.xyz 聚合)
| 平台 | 商品 | 原价 | 券 | 券后价 | 操作 |
|------|------|------|------|--------|------|
| 🥇 拼多多 | Apple iPhone 17 Pro 256GB | ¥8299 | -¥200 | **¥8099** | [领券购买](https://xiaxiayouhui.xyz/go/abc123) |
| 京东 | Apple iPhone 17 Pro 256GB | ¥8499 | -¥150 | ¥8349 | [领券购买](https://xiaxiayouhui.xyz/go/def456) |
| 苏宁 | Apple iPhone 17 Pro 256GB | ¥8399 | -¥100 | ¥8299 | [领券购买](https://xiaxiayouhui.xyz/go/ghi789) |
| 唯品会 ⓘ | Apple iPhone 17 Pro 256GB | ¥8299 | — | ¥8299 | [领券购买](https://xiaxiayouhui.xyz/go/jkl012) |
🥇 当前已聚合的 4 个平台中最低:**拼多多 ¥8099**(比京东低 ¥250)
> ⓘ = 数据来自第三方聚合源,价格仅供参考
> 数据时效:刚刚抓取 · 价格随平台实时变动
```
**渲染铁律**(不可省略任何一项):
- 🥇 标注全网最低
- 第一行表头注明「**数据时效**:刚刚 / X 分钟前 / 30 分钟内」
- 第三方平台(vip / dy)必须加 ⓘ 标记 + 表格底部说明
- 操作列文案严格 = `领券购买`,**绝不**出现推广类词汇
- 末行加来源声明:`数据时效:xx · 价格随平台实时变动`
- **匹配置信度透明化**(2026-05-24 新增,应对配件混入主商品场景):
- 当 item 含 `_match_score` 字段且 `< 0.5` 时,商品名后加 ⚠️ 角标
- 当 cheapest 命中"保护套/壳/膜/支架/数据线"等配件词时,**不要直接说"全网最低 ¥xx"**,改为:「⚠️ 关键词命中的可能是配件类商品(如保护套),未必是主机。建议用更精确的关键词,例如:`<品牌+型号+主机>`」
- 当所有平台返 0 条 / 全为配件时,引导用户改关键词,**不要假装找到了**
---
## 场景 2 · 链接 / 口令解析 `parse-link`
### 调用
```bash
# 普通商品链接
curl -s "${BASE_URL}/api/skill/v1/parse-link?url=https%3A%2F%2Fitem.jd.com%2F100012345678.html"
# 淘口令(URL 编码后传入)
curl -s "${BASE_URL}/api/skill/v1/parse-link?url=%EF%BF%A5XYZ123%EF%BF%A5"
```
### 支持的输入
| 类型 | 示例 | 状态 |
|---|---|---|
| 拼多多链接 | `p.pinduoduo.com/goods.html?goods_id=...` | ✅ |
| 京东链接 | `item.jd.com/xxx.html` | 🚧 迭代中 |
| 淘宝/天猫链接 | `m.tb.cn/h.xxx` / `detail.tmall.com/xxx.htm` | 🚧 迭代中 |
| 淘口令 | `¥XYZ123¥` | 🚧 迭代中 |
| 苏宁/唯品会链接 | `product.suning.com/...` / `vip.com/...` | 🚧 迭代中 |
> 当前 v1 稳定支持拼多多链接;其他平台返回 `{"success": false, "platform_supported": false}` 时,AI 应回复「该平台链接解析迭代中,建议改用关键词比价」。
### 返回(节选)
```json
{
"success": true,
"platform": "pdd",
"goods_id": "123456789",
"goods_name": "Apple iPhone 17 Pro 256GB",
"original_price": 8299.0,
"coupon_price": 8099.0,
"coupon_amount": 200.0,
"has_coupon": true,
"promotion_url": "https://xiaxiayouhui.xyz/go/abc123",
"same_item_compare": {
"available": true,
"cheapest": { "platform": "sn", "coupon_price": 7999.0 }
},
"version": "1.1.0"
}
```
### 输出渲染
```markdown
🔗 **链接解析结果**(数据时效:刚刚)
**Apple iPhone 17 Pro 256GB**(拼多多 · Apple 官方旗舰店)
| 项 | 值 |
|---|---|
| 原价 | ¥8299 |
| 隐藏券 | -¥200(满 8200 减 200)|
| 券后价 | **¥8099** |
| [领券购买](https://xiaxiayouhui.xyz/go/abc123) | — |
💡 **同款比价**:苏宁 ¥7999(比当前低 ¥100)→ [跳到苏宁](https://xiaxiayouhui.xyz/go/sn456)
> 数据时效:刚刚 · 同款匹配仅供参考,请确认型号一致后再下单
```
---
## 场景 3 · 今日好价 `daily-deals`
### 调用
```bash
curl -s "${BASE_URL}/api/skill/v1/daily-deals?cat=digital&platform=all&limit=10"
```
### 参数
| 参数 | 默认 | 可选值 |
|---|---|---|
| `cat` | `all` | `all / digital / beauty / fashion / home / food / baby / sport / book` |
| `platform` | `all` | `all / pdd / sn / jd / tb / vip / dy` |
| `limit` | `20` | 10~50 |
### 返回(节选)
```json
{
"success": true,
"cat": "digital",
"platform": "all",
"data": [
{ "platform": "pdd", "goods_name": "...", "coupon_price": 1899.0,
"coupon_amount": 100.0, "history_low": true, "discount_pct": 32,
"promotion_url": "https://xiaxiayouhui.xyz/go/...", "third_party": false }
],
"total": 10,
"version": "1.1.0"
}
```
### 输出渲染
```markdown
📅 **今日数码好价**(数据时效:30 分钟内 · 共 10 件 · 已按券后价由低到高排序)
| # | 商品 | 平台 | 券后价 | 券 | 状态 | 操作 |
|---|------|------|--------|------|------|------|
| 1 | 小米 14 Ultra 16+512 | 京东 | **¥6299** | -¥800 | 🆕 新史低 | [领券购买](...) |
| 2 | AirPods 4 主动降噪 | 拼多多 | ¥1099 | -¥200 | 🟰 平史低 | [领券购买](...) |
| 3 | 索尼 WH-1000XM5 | 苏宁 | ¥1999 | -¥300 | 🔥 32% off | [领券购买](...) |
> 🆕 = 新史低 · 🟰 = 平史低 · 🔥 = 折扣力度大
> 数据时效:30 分钟内(每 30 分钟刷新一次)
```
---
## 场景 4 · 本地生活神券 `local`
### 调用
```bash
curl -s "${BASE_URL}/api/skill/v1/local?cat=waimai&city=shenzhen&limit=10"
```
### 参数
| 参数 | 默认 | 可选值 |
|---|---|---|
| `cat` | `all` | `all / waimai(外卖)/ movie(电影)/ hotel(酒店)/ chuxing(打车)/ chadrink(奶茶)/ meishi(美食)` |
| `city` | `all` | 城市拼音码(`shenzhen / beijing / shanghai` 等);`all` 表示全国 |
| `limit` | `10` | 5~20 |
### 返回(节选)
```json
{
"success": true,
"cat": "waimai",
"city": "shenzhen",
"data": [
{ "platform": "meituan", "act_id": "MT12345",
"title": "美团外卖 30-12 神券",
"discount_desc": "满 30 减 12",
"valid_until": "2026-05-25 23:59",
"promotion_url": "https://xiaxiayouhui.xyz/go/local_mt12345" }
],
"version": "1.1.0"
}
```
### 输出渲染
```markdown
🍜 **深圳 · 外卖神券**(数据时效:30 分钟内)
| 优惠 | 平台 | 力度 | 有效期 | 操作 |
|------|------|------|--------|------|
| 美团外卖满减 | 美团 | **满 30 减 12** | 至 5/25 23:59 | [领券购买](...) |
| 饿了么红包 | 饿了么 | 满 25 减 8 | 至 5/26 23:59 | [领券购买](...) |
| 麦当劳 1+1 | 美团 | 9.9 元 | 至 5/30 | [领券购买](...) |
> 数据时效:30 分钟内 · 神券每天上午 10 点 / 下午 4 点更新
```
---
## 辅助 · 单平台带券聚合 `coupon`
```bash
curl -s "${BASE_URL}/api/skill/v1/coupon?q=扫地机器人&platform=pdd&limit=10"
```
| 参数 | 必填 | 默认 |
|---|---|---|
| `q` | ✅ | — |
| `platform` | ❌ | `pdd` |
| `limit` | ❌ | `10` |
返回 `items` 按 `coupon_amount` 倒序。适用于"xx 平台的优惠券"类问题。
---
## 辅助 · 健康检查 `health`
```bash
curl -s "${BASE_URL}/api/skill/v1/health"
```
返回当前 v1 版本号、已支持平台清单、能力清单。**Skill 调用前可先打这个判断服务可用性。**
---
## 字段命名约束(v1 永不 break)
`/api/skill/v1/*` 已锁定的字段名跨版本保持兼容。客户端可放心依赖:
```
platform 平台代码:pdd / sn / jd / tb / vip / dy / meituan / eleme
goods_id 商品 ID
goods_sign 拼多多转链签名
supplier_code 苏宁供应商码
goods_name 商品名(用户展示用)
goods_image 主图 URL
original_price 原价(元)
min_price 到手价(无券时等于券后价)
coupon_price 券后价(元)
coupon_amount 券面额(元)
coupon_desc 券描述(如"满 200 减 30")
has_coupon 是否有券
sales 销量
mall_name 店铺名
commission_rate 平台返点率(内部字段)
third_party true=数据来自第三方聚合源(vip / dy)
promotion_url 📌 唯一对外购买链接(短链格式 https://xiaxiayouhui.xyz/go/{code})
history_low true=新史低(daily-deals 专用)
discount_pct 折扣百分比(daily-deals 专用)
valid_until 券有效期(local / coupon 专用)
elapsed_ms 接口耗时(毫秒)
version API 版本号
```
新字段以追加方式出现,**绝不删字段、不改字段名、不改字段类型**。破坏性变更将开 `/api/skill/v2/*` 并行兼容。
---
## 错误处理
```json
{ "success": false, "error": "<人类可读中文错误>", "version": "1.1.0" }
```
| 错误 | 含义 | AI 应该怎么回复用户 |
|---|---|---|
| `missing q` | 关键词为空 | "你想查什么商品?" |
| `平台 xxx 暂未接入` | platforms 含未支持平台 | 静默移除该平台,继续展示其他平台数据 |
| `<plat> 接口异常: ...` | 单平台失败 | 表格中该行标注 ❌"暂时获取失败",其他平台正常展示 |
| `parse-link platform unsupported` | 链接解析平台未实施 | 提示"该平台链接解析在路上,先用关键词搜:[关键词]" |
| `rate limited` | 触发限速 | "今日查询次数偏多,稍后再试" |
---
## 文案与合规铁律(不可破)
### ❌ 严禁出现的词
```
推广类词汇 · 绝对化宣传词汇
全网最低(绝对化)· 100% 最低 · 保证最低 · 必须买 · 错过亏死
```
### ✅ 推荐用词
```
比价 · 优惠券 · 券后价 · 隐藏券 · 神券 · 折扣 · 立减 · 省钱
已聚合的 X 平台中最低 · 当前最低 · 数据时效 · 价格随平台变动
```
### 输出格式铁律(每次回复都要满足)
1. **列表/表格优先**——不堆叠纯文本段落
2. **按钮文案统一** = `领券购买`(不得用"立即购买"、"去下单")
3. **🥇 标注最低价**——比价场景必须,单平台场景不需要
4. **数据时效**必须显示——`刚刚 / X 分钟前 / 30 分钟内`
5. **第三方角标 ⓘ**——vip / dy 数据必须打 + 底部说明
6. **来源声明**——表格末行附 "数据时效:xx · 价格随平台实时变动"
7. **跳转链接** = `https://xiaxiayouhui.xyz/go/{code}` 短链格式(永远不裸出平台原始链接)
8. **匹配偏离透明化**(2026-05-24 新增):当结果疑似配件类(含「保护套/壳/膜/支架/线」等词)或 `_match_score < 0.5` 时,必须 ⚠️ 提示用户并建议改关键词,**严禁假装找到主商品**
### 隐私声明(每个场景首次输出时附 1 次即可)
> 数据来自 xiaxiayouhui.xyz 聚合的各平台公开数据。本工具不收集你的姓名、手机号、地址、支付信息,仅传递商品关键词。
---
## 调用样例汇总
```bash
# 1. 比价
curl -s "${BASE_URL}/api/skill/v1/compare?q=iPhone+17&limit=5"
# 2. 链接解析(拼多多链接)
curl -s "${BASE_URL}/api/skill/v1/parse-link?url=https%3A%2F%2Fp.pinduoduo.com%2Fgoods.html%3Fgoods_id%3D123"
# 3. 今日好价 · 数码品类
curl -s "${BASE_URL}/api/skill/v1/daily-deals?cat=digital&limit=10"
# 4. 本地生活 · 深圳外卖
curl -s "${BASE_URL}/api/skill/v1/local?cat=waimai&city=shenzhen&limit=10"
# 5. 单平台带券聚合
curl -s "${BASE_URL}/api/skill/v1/coupon?q=扫地机器人&platform=pdd&limit=10"
# 6. 健康检查
curl -s "${BASE_URL}/api/skill/v1/health"
```
---
## 版本与变更
- **v1.5.11**(当前):6 大平台 compare 全部跑通(PDD/SN/TB/JD/VIP/DY);6 大场景 endpoint 全部上线(compare/coupon/parse-link/daily-deals/local/health);服务端健康检查通过。parse-link 当前仅 PDD 链接稳定,TB/JD 链接解析迭代中
- **v1.0.0 GA 触发条件**:
- [x] 4 个核心场景 endpoint 全部跑通
- [x] BaseURL 切到 `https://xiaxiayouhui.xyz`(备案已通过,HTTPS 已启用)
- [ ] `${BASE_URL}/go/{code}` 短链中转上线
- [ ] 真实抓数据 + AI 调用 ≥ 3 个回合通测
历史变更见 `https://xiaxiayouhui.xyz/changelog`(已上线)。
don't have the plugin yet? install it then click "run inline in claude" again.