給 AI 助理
讓你的 AI 助理替你使用 Nombox
Nombox 是一款廚房應用程式,有購物清單、食譜和餐點日曆。你在應用程式裡能做的一切,你的 AI 助理都能做。告訴它你想要什麼,它會自己登入並完成。
你是 AI 助理嗎?請先閱讀 https://nombox.app/llms.txt,裡面有具體步驟。
直接問你的 AI
把這段話貼到任何 AI 聊天機器人或助理裡。它會告訴你它在 Nombox 裡能做什麼,並幫你開始。如果它不能自己登入,它會教你把 Nombox 新增進去,只需一次。
閱讀 https://nombox.app/llms.txt。然後告訴我你能在 Nombox 裡幫我做什麼,並幫我開始。
把 Nombox 加到你的 AI 應用程式
適用於 Claude.ai、ChatGPT、Gemini,以及其他支援 MCP 連接器的應用程式。
- 打開 AI 應用程式的設定,找到「連接器」。有些應用程式叫「應用程式」或「工具」。
- 新增自訂連接器,並貼上下面的 Nombox 位址。
- 應用程式提示時登入 Nombox,然後點「允許」。
https://nombox.app/mcp
Claude Code、Cursor 和其他程式設計助理
在 Claude Code 中執行一次下面的指令,它會請你登入。
claude mcp add --transport http nombox https://nombox.app/mcp
有些用戶端需要金鑰。在 Nombox 中打開「設定」,進入「智慧助理」,展開「開發者選項」,點「建立金鑰」。然後執行:
claude mcp add --transport http nombox https://nombox.app/mcp --header "Authorization: Bearer nbx_YOUR_KEY"
Cursor 和其他讀取 mcp.json 檔案的用戶端:
{
"mcpServers": {
"nombox": {
"url": "https://nombox.app/mcp",
"headers": {
"Authorization": "Bearer nbx_YOUR_KEY"
}
}
}
}機器人與腳本
沒有 MCP 用戶端的機器人可以直接用 HTTP。它需要知道所代表的人的電子郵件地址。
- 電子郵件驗證碼:用電子郵件地址和助理名稱 POST /api/agents/email/start,對方會收到 6 位數驗證碼;再用電子郵件地址和驗證碼 POST /api/agents/email/verify,回傳內容裡有權杖。
- 連結核准:用助理名稱 POST /api/agents/connect,把回傳的連結傳給對方,對方點「允許」;然後每 3 秒 POST /api/agents/connect/token,直到拿到權杖。
- 之後向 https://nombox.app/mcp 傳送請求,並帶上標頭 Authorization: Bearer YOUR_TOKEN。
每個請求、回傳內容和錯誤都寫在這些指南裡:
你的助理能做什麼
共 90 個工具,涵蓋你在應用程式裡能做的事,包括刪除。名稱和說明為英文,與你的助理讀到的一致。
入門1 個工具
nombox_guide唯讀How Nombox works: lists, items, categories, recipes and the calendar, and how to act well for the user.
帳戶與設定10 個工具
whoami唯讀The Nombox account this agent acts for: name, email and plan, plus this agent's own name.
profile_get唯讀The person's Nombox profile: username, display name and photo, with the link to their public creator page.
profile_update可能覆蓋或刪除內容 · 會連到 Nombox 之外Changes the person's username and/or profile photo.
preferences_get唯讀The person's settings: theme, language, the shopping list the apps open on, and whether the weekly meal plan suggestion is on.
preferences_update可能覆蓋或刪除內容Changes the person's settings.
ai_usage_get唯讀How many of this week's AI credits the person has used, and their weekly limit (free 10, Premium 100).
subscription_status唯讀 · 會連到 Nombox 之外Whether the person has Premium, and if so how it is billed (Stripe on the web, or the App Store on iPhone) or that it is a gift, its price, when it renews or ends, and any referral credit that will lower the next bill.
subscription_checkout_link會修改資料 · 會連到 Nombox 之外Makes a Stripe page where the person starts Premium (monthly $1.99, or yearly $17.99).
subscription_manage_link會修改資料 · 會連到 Nombox 之外A page where the person changes the plan, updates the card, sees invoices or cancels.
account_delete可能覆蓋或刪除內容 · 會連到 Nombox 之外Permanently deletes the person's Nombox account and all its data: lists and items, recipes, favorites, calendar, preferences, referrals, and every agent key including this one.
購物清單11 個工具
lists_get唯讀The person's shopping lists (their own and those shared with them) with each list's items, categories and store.
list_create會修改資料Makes a new shopping list owned by the person, optionally tied to a store.
list_update可能覆蓋或刪除內容Renames a list, changes its color, or sets or removes its store (store: null).
list_delete可能覆蓋或刪除內容Deletes a list and its items for the person and everyone it is shared with.
list_items_add會修改資料Adds items to a list, each with its own category and quantity.
list_item_update可能覆蓋或刪除內容Changes an item's text, quantity (null removes it) or category.
list_items_complete會修改資料Checks items off as bought, as tapping them in the apps does.
list_items_uncomplete會修改資料Puts checked items back on the list as still to buy.
list_items_delete可能覆蓋或刪除內容Removes items from their lists.
list_clear_completed可能覆蓋或刪除內容Removes every checked item from a list, as Clear completed does in the apps.
ingredients_from_url會修改資料 · 會連到 Nombox 之外Nombox's Import from URL: Nombox's AI reads a recipe web page and returns the ingredients as shopping-list items (lower case, no amounts, basic seasonings left out).
共享13 個工具
calendar_shares_get唯讀Who the person shares their calendar with, and whose calendars are shared with them.
calendar_share_invite會修改資料 · 會連到 Nombox 之外Invites a person by email to share the calendar: Nombox emails them a link, and once they accept, both people see each other's meals and either can remove the other's.
calendar_share_revoke可能覆蓋或刪除內容Cancels an invitation, or takes away the access of a person who accepted.
calendar_share_resend會修改資料 · 會連到 Nombox 之外Emails a waiting invitation to the person again, with the same link, and gives the link a fresh 7 days.
calendar_leave可能覆蓋或刪除內容Leaves a calendar that someone shared with the person.
calendar_invitation_preview唯讀What a calendar invitation link is for, without accepting it: who invited the person, and whether it was already accepted.
calendar_invitation_accept會修改資料Joins the calendar an invitation link is for: from then on the person sees the other person's meals and the other person sees theirs, and either can remove the other's.
list_share_invite會修改資料 · 會連到 Nombox 之外Shares a list with a person by email: Nombox emails them a link, and they get the list once they accept it.
list_share_revoke可能覆蓋或刪除內容Cancels an invitation, or takes away a person's access to a list they accepted.
list_share_resend會修改資料 · 會連到 Nombox 之外Emails a waiting invitation to the person again, with the same link.
list_leave可能覆蓋或刪除內容Takes the person off a list that someone else shared with them.
invitation_preview唯讀What an invitation link is for, without accepting it: the list, who invited the person, and whether it was already accepted.
invitation_accept會修改資料Joins the list an invitation link is for, so it shows in the person's lists with role "member".
食譜25 個工具
recipes_search唯讀Finds recipes.
recipe_get唯讀One recipe in full: title, servings, notes, photo, tags, state, ingredients and steps with their positions (counting from 1), and its link.
recipe_create會修改資料Makes a new draft recipe (only the person sees it); its cookGuide, in Nombox's Cook mode format, is required when the recipe has steps.
recipe_update可能覆蓋或刪除內容Changes one of the person's own recipes: its title, servings, notes, or the whole ingredient or step list; a call that passes steps or ingredients must also send the whole cookGuide, in Nombox's Cook mode format.
recipe_step_add會修改資料Adds one or more steps to one of the person's own recipes, each with a cookGuide entry (Nombox's Cook mode format) for the new step.
recipe_step_update可能覆蓋或刪除內容Replaces the text of the step at `position` (its photos stay) and needs a cookGuide entry (Nombox's Cook mode format) for the new text.
recipe_step_delete可能覆蓋或刪除內容Removes the step at `position`, with its photos.
recipe_step_move會修改資料Moves the step at `position` so that it ends up at `toPosition`.
recipe_step_image_add會修改資料 · 會連到 Nombox 之外Adds a photo to the step at `position` of one of the person's own recipes, from an image link: Nombox downloads it (a public http or https link to a JPEG, PNG, WebP or GIF up to 10 MB), resizes it and stores its own copy, as recipe_image_set does for the recipe's photo.
recipe_step_image_remove可能覆蓋或刪除內容Removes one photo from the step at `position`.
recipe_ingredient_add會修改資料Adds one or more ingredients to one of the person's own recipes, each with usedInSteps (the steps that add it: the first step that uses it, and any step that adds more of it; REQUIRED, may be []), which Nombox puts in the recipe's cook guide.
recipe_ingredient_update可能覆蓋或刪除內容Changes the text and/or the section (null removes the heading) of the ingredient at `position`; usedInSteps (the steps that add it now: the first step that uses it, and any step that adds more of it; REQUIRED, may be []) updates the recipe's cook guide to match.
recipe_ingredient_delete可能覆蓋或刪除內容Removes the ingredient at `position`.
recipe_ingredient_move可能覆蓋或刪除內容Moves the ingredient at `position` to `toPosition`, and optionally into another section (null removes the heading).
recipe_tags_set可能覆蓋或刪除內容Replaces all of the recipe's tags with this list.
recipe_image_set可能覆蓋或刪除內容 · 會連到 Nombox 之外Sets the recipe's photo from an image link: Nombox downloads it (a public http or https link to a JPEG, PNG, WebP or GIF up to 10 MB), resizes it and stores its own copy.
recipe_publish會修改資料Makes the recipe public now: everyone in Nombox can find it in Discover.
recipe_schedule會修改資料Makes the recipe public at a later time.
recipe_unpublish會修改資料Takes a public or scheduled recipe back to a draft that only the owner sees.
recipe_delete可能覆蓋或刪除內容Deletes one of the person's own recipes.
recipe_favorite會修改資料Adds a public recipe (or one of the person's own) to their favorites, so it shows in their Recipes.
recipe_unfavorite會修改資料Removes a recipe from the person's favorites.
recipe_copy會修改資料Saves a copy of a public recipe from Discover (or of one of the person's own) as a new draft that is theirs to change: title, servings, notes, ingredients, steps with photos, tags and the photo.
recipe_scale唯讀Shows the ingredient lines with every amount multiplied, without saving anything.
recipe_cook_guide唯讀What Cook mode shows while the person cooks, for a recipe they can see: for each step (counting from 1) its timers, the ingredient lines it ADDS, what it uses that an earlier step made (fromSteps), the ingredient amounts and temperatures it writes, and what a cook can start during its wait, plus a Before you start list for the whole recipe.
探索5 個工具
discover_search唯讀Searches the public recipes everyone can browse in Nombox's Discover tab, newest first (best match first when there is a query).
discover_tags_popular唯讀The tags people search for most in Discover, most searched first.
creator_get唯讀A creator's public profile and their public recipes (the page behind a username in Discover).
tag_filters_get唯讀The tag chips the person keeps on their Recipes screen to filter their recipes, in order, and the tags they could add (tags on their own recipes and on public recipes they favorited).
tag_filters_set可能覆蓋或刪除內容Replaces the tag chips on the person's Recipes screen with this list, in this order (an empty list removes them all).
餐點日曆4 個工具
calendar_week_get唯讀The meals planned in one week: seven days, each with its meals.
calendar_add會修改資料Puts recipes on a day of the calendar.
calendar_move可能覆蓋或刪除內容Moves a planned meal to another day.
calendar_remove可能覆蓋或刪除內容Takes planned meals off the calendar, the meals of a shared calendar too (either person may remove the other's).
規劃與 AI 協助17 個工具
weekly_draft_get會修改資料Nombox's free weekly meal-plan draft: a week of meals picked from the person's recipes, shown on their dashboard until they add it to the calendar.
weekly_draft_update可能覆蓋或刪除內容Replaces the open draft's meals with the list you give, as removing or swapping a meal in the app does.
weekly_draft_add_all會修改資料Puts all the meals the draft now shows on the person's calendar, as Add all does in the app; the draft is then done.
weekly_draft_dismiss可能覆蓋或刪除內容Hides the open draft, as Dismiss does in the app: it stays gone for the week and the dashboard goes back to its empty state.
weekly_draft_swap_day可能覆蓋或刪除內容Replaces the meals of one day of the open draft with different ones, as the swap button does in the app, and saves the result in the draft.
meal_suggestions_get唯讀What the Suggest meals sheet shows before it runs: the person's saved meal preferences (free text such as how many meals a week, cuisines, time limits), how many AI uses they have spent this week, and how many recipes suggestions can draw from.
meal_suggestions_save_prompt可能覆蓋或刪除內容Saves the person's meal preferences, the free text the Suggest meals sheet and the weekly draft follow.
meal_suggestions_generate可能覆蓋或刪除內容Picks meals for the rest of a week from the person's recipes and favorites (public recipes fill in when they have few), following their saved preferences.
meal_suggestions_regenerate會修改資料Picks different meals for one day of a suggestion list, as the swap button on the Suggest meals sheet does.
meal_suggestions_confirm會修改資料Puts the chosen suggestions on the person's calendar, as Add to calendar does on the Suggest meals sheet.
prep_ahead_get唯讀The prep-ahead tips Nombox kept for this week (what to chop, marinate or cook ahead for the meals planned from today to 7 days later), whether the calendar changed since they were made, and how many AI uses are spent.
prep_ahead_generate會修改資料Makes prep-ahead tips for the meals planned from today to 7 days later (at least 2 meals needed), as the Prep ahead card does.
prep_plan_get會修改資料The person's prep plan: a checkable to-do list of what to thaw, soak, marinate, chop or cook ahead for the meals planned from today to 6 days later, as Nombox's Today page shows it.
prep_plan_mode會修改資料Home cook (quick: only the prep that makes cooking day faster) or Pro chef (best: also chef techniques that make the food better when started early).
prep_task_check會修改資料Marks one prep task done (checked true) or not done (false), as ticking it on Today does.
dashboard_get唯讀What the Nombox dashboard shows: today's cooking and the meals of the coming week (today to 7 days later), each with its recipe's ingredients and steps, from the person's calendar and any calendar shared with them.
sous_chef_edit會修改資料Asks Sous Chef, Nombox's own recipe AI, to change a recipe the person can see, in plain words ("make it vegetarian", "halve it", "add a sauce").
推薦4 個工具
referrals_get唯讀The friends the person invited to Nombox, newest first, and whether each signed up.
referral_invite會修改資料 · 會連到 Nombox 之外Invites a friend to Nombox by email: Nombox emails them a link to sign up.
referral_cancel可能覆蓋或刪除內容Removes a referral that the friend has not accepted yet.
referral_resend會修改資料 · 會連到 Nombox 之外Emails a waiting referral to the friend again, with the same link.
限制
- 每個助理每分鐘最多傳送 240 個請求。
- 助理可免費使用。Nombox 內建的 AI 功能與應用程式內一樣,使用你每週的 AI 額度:免費版每週 10 次,Premium 每週 100 次。
- 每個帳戶最多可有 25 個已連接的助理和金鑰。
- 登入驗證碼 10 分鐘內有效。同一網路每天最多透過助理建立 3 個新帳戶。
隱私與控制
- 助理的權杖只能存取你的帳戶。
- 你可以隨時中斷某個助理:打開「設定」,進入「智慧助理」,點「移除」。
- Nombox 內建的 AI 功能使用你每週的正常額度,沒有其他額外費用。
- 任何食譜或清單內容都不會進入統計分析。