商品反查门店
工具名称
search_stores_by_product
MCP Endpoint
tools/call · search_stores_by_product
分类
门店发现
做什么
根据商品关键词和用户位置,查询当前渠道(啡快 / 专星送)下售卖该商品的门店列表, 同时返回匹配的商品基本信息(仅单品,不含套餐)。
与 list_products(已知门店 → 查商品)互为逆向能力。
什么时候用
适合用户先选商品、再选门店的场景:
- "附近哪里能买到燕麦拿铁"
- "我在 XX 附近,哪家星巴克有抹茶"
返回结构约定:
product = null表示商品不存在;product有值但stores = []表示附近无门店。
硬约束:item_id 与 biz_type 绑定
返回的 product.item_id 与本次调用的 biz_type 绑定,
仅可在相同 biz_type 下进入后续 get_product / 算价 / 下单链路,
不可跨 biz_type 复用。切换履约方式必须用新的 biz_type 重新调用。
入参
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| biz_type | 'pickup' | 'delivery' | 是 | 履约方式:pickup 到店自取 / delivery 外卖配送。 |
| keyword | string | 是 | 商品搜索关键词,如「燕麦拿铁」「抹茶」「美式」。 |
| location | string | 是 | 中文地址,且必须包含城市。pickup 传用户当前位置,delivery 传收货地址。 |
调用示例
{
"name": "search_stores_by_product",
"arguments": {
"biz_type": "pickup",
"keyword": "燕麦拿铁",
"location": "上海市静安区南京西路 1788 号"
}
}