门店搜索

工具名称

search_stores

MCP Endpoint

tools/call · search_stores

分类

门店发现

做什么

根据城市、地址信息、经纬度坐标、门店名称或门店 ID 搜索附近星巴克门店，返回 store_id、门店名称、门店地址、距离、分业务营业时间、门店介绍、门店标签和门店图片，支持按"网红打卡 / 历史建筑 / 露台风光 / 星巴克臻选 / 烘焙工坊 / Bar Mixato"等标签筛选。

什么时候用

用户意图为到店取餐，作为获取 store_id 的第一步。
用户说"附近有星巴克吗"、"找家最近的星巴克"、"周围有没有星巴克"。
用户需要筛选特定属性的门店（宠物友好 / 免费 WiFi / 24 小时营业等）。

使用边界

当用户已经表达明确商品意图（例如"附近哪里能买到燕麦拿铁"），应改用 search_stores_by_product。

入参

参数	类型	必填	说明
search_type	string	是	搜索类型：1=按门店名称、2=按门店 ID、3=按地址（默认）、4=按经纬度。
city	string	否	城市，当 search_type=3 时必填。
address	string	否	地址，当 search_type=3 时必填。优先使用结构化地址：省 + 市 + 区 + 镇 + 乡 + 街道 + 门牌号。
latitude	string	否	纬度，当 search_type=4 时必填。
longitude	string	否	经度，当 search_type=4 时必填。
store_name	string	否	门店名称，当 search_type=1 时必填。
store_id	string	否	门店号，当 search_type=2 时必填。
tags	string[]	否	门店标签查询，任意匹配一个即返回。

调用示例

curl -X POST https://uni.starbucks.com.cn/mcp-servers/starbucks \
  -H "Authorization: Bearer sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0","id":1,"method":"tools/call",
    "params":{
      "name":"search_stores",
      "arguments":{
        "search_type":"3",
        "city":"上海",
        "address":"南京西路 1788 号",
        "tags":["星巴克臻选"]
      }
    }
  }'