申请 API 访问即可获得沙盒密钥。沙盒密钥在样例数据上拥有完整图谱权限，且完全免费。
pip install menuclaw 或 npm i menuclaw。也可以直接调用 REST API——提供完整 OpenAPI 规范。
查询餐厅、菜品或食材。多数开发者一天内即可上线。
from menuclaw import MenuClaw mc = MenuClaw(api_key="mc_sandbox_...") # 查询一家餐厅及其菜单 r = mc.restaurant.get("R-8841") menu = mc.restaurant.menu(lat=r.lat, lon=r.lon) print(r.name, "·", r.cuisine, "·", len(menu.items), "items")
在 Authorization 请求头中传入密钥。密钥按环境（沙盒 / 生产）隔离，可无中断轮换。
curl https://api.menuclaw.com/v1/restaurant/R-8841 \ -H "Authorization: Bearer mc_live_..." \ -H "Content-Type: application/json"
| 方法 | 接口 | 说明 |
|---|---|---|
| GET | /v1/restaurant/{id} | 餐厅身份、菜系、营业时间、价格带。 |
| GET | /v1/restaurant/menu | 带栏目、菜品与规格的结构化菜单。 |
| POST | /v1/dish/search | 带筛选与地理范围的语义菜品搜索。 |
| GET | /v1/dish/{id} | 带食材与标签的规范化菜品。 |
| GET | /v1/dish/{id}/nutrition | 热量、宏量与膳食属性。 |
| GET | /v1/restaurant/intelligence | 衍生洞察：需求、价格指数、热门菜品。 |
| POST | /v1/graph/traverse | 跨知识图谱的路径查询。 |
| POST | /v1/webhooks | 注册菜单变更与价格更新钩子。 |
完整 schema、参数、错误码与速率限制请参阅交互式参考。前往开发者平台。
新增 — POST /v1/graph/traverse 支持多跳路径查询。新增 768 维图谱向量快照。
改进 — 每条营养事实现在都带有置信区间与来源链路。
新增 — 菜单变更、价格更新与餐厅生命周期 Webhook，支持重试与回放。
正式发布 — 稳定、带版本的基础。提供沙盒与生产环境。
