API и MCP

Меню на неделю с ценами магазина и список покупок — из вашего приложения или из ассистента. Ключ не нужен, регистрация тоже.

Ключ

не нужен

Запросов в минуту

600 / 60

Рецептов

2140

Стран

Где взять ключ

Нигде: публичное API работает без ключа и без аккаунта, просто отправьте запрос. Ключи вида rk_ существуют, но они нужны для записи рецептов в базу и выдаются только администраторам сервиса. Для чтения и сборки планов они не нужны, и лимиты для всех остальных считаются одинаково.

С чего начать

Найти рецепты по словам в названии и составе. У каждого сразу время, калорийность и цена порции в валюте выбранной страны.

curl "https://racion.app/api/recipes?q=chicken&country=DE&lang=en&limit=5"

Главный вызов — собрать неделю. Отправьте, кто ест, где покупает и чего не ест, получите семь дней блюд и один список покупок, округлённый до упаковок.

curl -X POST "https://racion.app/api/plans" \
  -H "Content-Type: application/json" \
  -d '{"country":"DE","store":"rewe","lang":"en","adults":2,
       "kids":[{"age":7}],"slots":["breakfast","lunch","dinner"],
       "equipment":["stove","oven"],"excludeTags":["fish"],
       "budgetMode":"perPersonDay","budgetValue":12}'

В ответе есть id: по адресу /plan/<id> открывается та же неделя страницей для человека — её можно распечатать, отметить купленное в магазине и отправить ссылкой. Показывайте ссылку, а не пересказ списка.

Что умеет

Метод	Что делает
`GET /api/meta`	Страны, магазины с индексом цен, аллергены и пресеты ограничений
`GET /api/recipes`	Каталог с поиском и постраничностью
`GET /api/recipes/{id}`	Рецепт целиком: граммовки на порцию, шаги, КБЖУ, цена
`GET /api/collections`	Подборки и списки их рецептов
`GET /api/occasions`	Праздничные столы, которые можно собрать на число гостей
`GET /api/ingredients`	Справочник продуктов: единицы, размеры упаковок, КБЖУ на 100 г
`POST /api/plans`	Собрать неделю со списком покупок
`GET /api/plans/{id}`	Прочитать собранный ранее план
`POST /api/baskets`	Собрать стол из блюд, которые вы выбрали сами, у каждого своё число порций
`POST /api/occasions/{id}`	Собрать праздничный стол на число гостей

openapi.json — полное описание в формате OpenAPI 3.1, его понимают генераторы клиентов и ассистенты.

Ограничения

На адрес: 600 запросов в минуту ко всему /api/, из них 60 в минуту на сборку планов. Разрешены всплески до 100 и 20 запросов подряд. При превышении приходит 429 и заголовок Retry-After. CORS открыт, поэтому вызывать можно прямо из браузера. Нужно больше — напишите, договоримся.

Откуда цены

Это оценка, а не ценник магазина. Основа — официальная статистика: Росстат в России, уровни цен Евростата с индексом HICP в Европе, BLS в США. Сверху множитель сети, поэтому дискаунтер и премиальный супермаркет дают разные суммы. В каждом ответе есть поле priceSource с источником и периодом — показывайте его рядом с цифрой, если публикуете сумму.

MCP-сервер

Если вы работаете в Claude, ChatGPT или другом клиенте с поддержкой MCP, подключите сервер racion-mcp — и ассистент сможет планировать неделю сам. Ключ ему тоже не нужен.

{
  "mcpServers": {
    "racion": { "command": "npx", "args": ["-y", "racion-mcp"] }
  }
}

Шесть инструментов: собрать неделю, собрать стол из выбранных блюд, поиск рецептов, рецепт целиком, подборки, магазины со страновым индексом цен.

Условия

Делать продукт поверх API можно. Перепубликовывать базу рецептов и фотографии целиком или большими кусками — нет. Подробности в разделе о правах: Пайдалану шарттары.

Вопросы, увеличение лимитов, партнёрство — info@racion.app.