给 AI 助理和开发者

MCP 服务

Streamable HTTP，无状态，七个工具。把这个地址填进支持 MCP 的客户端就行。

https://breezebiz.app/api/mcp/mcp

{
  "mcpServers": {
    "breezebiz": { "type": "http", "url": "https://breezebiz.app/api/mcp/mcp" }
  }
}

工具: search_shops · search_items · get_shop · get_availability · book_appointment · place_order · join_waitlist

breezebiz.app/.well-known/mcp/server-card.json

REST 接口（OpenAPI）

普通的 HTTP 接口，OpenAPI 3.1 文档在这里。读是公开的，写和网页上的预约、下单同一条路。

breezebiz.app/agent/openapi.json

curl "https://breezebiz.app/api/agent/shops?trade=beauty"
curl "https://breezebiz.app/api/agent/shop/@yanshi-xiaopu"
curl "https://breezebiz.app/api/agent/shop/@yanshi-xiaopu/availability?days=7"
curl -X POST "https://breezebiz.app/api/agent/shop/@yanshi-xiaopu/book" -H "content-type: application/json" \
  -d '{ "date": "2026-09-19", "time": "14:00", "name": "Amy", "phone": "4155550100", "services": ["Gel manicure"] }'

写入都回一个 ok；ok 为 false 时带一个 reason（比如 slot_taken、closed、sold_out），照着换个说法再试。

breezebiz.app/.well-known/api-catalog

Markdown

商城、行业页、产品和服务的清单、每家店的页面都有 Markdown 版：网址后加 .md，或请求头带 Accept: text/markdown。站点自述在 /llms.txt。

curl "https://breezebiz.app/@yanshi-xiaopu.md"
curl -H "Accept: text/markdown" "https://breezebiz.app/@yanshi-xiaopu"
curl "https://breezebiz.app/shops/beauty.md"
curl "https://breezebiz.app/llms.txt"

给客人的一句话

不用接任何东西：把店的网址发给你的 AI 助理，让它替你查、替你约。