申請 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,支持重試與回放。
正式發布 — 穩定、帶版本的基礎。提供沙盒與生產環境。