Starbucks星巴克 MCP 开放平台

单品详情

工具名称
get_product
MCP Endpoint
tools/call · get_product
分类
商品与套餐

做什么

获取单个商品的完整信息,包括所有规格(SKU)及每个规格下的可自定义选项。 商品详情中去除了纯渲染字段(排序序号等),保留 Agent 推理和下单所需的全部信息。

每个客制化 optionsub_option 都会返回 default_nummin_nummax_num, 表示默认份数与可选数量范围。

下单字段映射

  • SKU 传 spec_id,选项传 option_id
  • 两级结构(如 ChangeSugar)时,传子级 option_id不传父级
  • spec_sku(POS Key 编码)和 code 不传给下单域。
硬约束:item_id 与 biz_type 绑定

本接口的 item_id 必须来自与本次调用相同 biz_typelist_productssearch_stores_by_product 结果, 禁止跨 biz_type 复用。

入参

参数类型必填说明
biz_type'pickup' | 'delivery'履约方式,必须与 item_id 获取时的 biz_type 一致。
item_idstring商品 ID,来自 list_products 或 search_stores_by_product。
store_idstring门店 ID。