面向 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 功能使用你每周的正常额度,没有其他额外费用。
- 任何食谱或清单内容都不会进入统计分析。