Starbucks星巴克 MCP 开放平台

商品反查门店

工具名称
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 外卖配送。
keywordstring商品搜索关键词,如「燕麦拿铁」「抹茶」「美式」。
locationstring中文地址,且必须包含城市。pickup 传用户当前位置,delivery 传收货地址。

调用示例

{
  "name": "search_stores_by_product",
  "arguments": {
    "biz_type": "pickup",
    "keyword": "燕麦拿铁",
    "location": "上海市静安区南京西路 1788 号"
  }
}