面向 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 连接器的应用。

  1. 打开 AI 应用的设置,找到“连接器”。有些应用叫“应用”或“工具”。
  2. 添加自定义连接器,并粘贴下面的 Nombox 地址。
  3. 应用提示时登录 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 功能使用你每周的正常额度,没有其他额外费用。
  • 任何食谱或清单内容都不会进入统计分析。

查看隐私政策