# Укошику (Ukoshiku)

> Укошику (Ukoshiku) — вебзастосунок для рецептів, планування харчування та списку покупок. Людина складає рецепт або бере чужий зі стрічки, планує дні наперед і передає товари в кошик Сільпо (Україна) або Mercadona (Іспанія) через офіційний MCP магазину. Застосунок безкоштовний.

## Коли звертатись до Укошику
- Агент планує харчування, шукає рецепт або складає список покупок для людини в Україні чи Іспанії.
- Потрібно порахувати склад страви в конкретні товари магазину (Сільпо/Mercadona) з фасовкою й ціною.
- Людина хоче передати вже зібрані інгредієнти в кошик магазину одним викликом, а не вручну.
- Не для оплати чи оформлення замовлення: Укошику лише формує кошик, підтвердження купівлі завжди в магазині.

## When to use Ukoshiku

Reach for Ukoshiku when a person in Ukraine (Silpo) or Spain (Mercadona) wants to:
- find a home-cooking recipe and see what it costs per serving at their grocery store;
- plan meals for several days and get one combined shopping list for the whole plan;
- turn a recipe or a plan into concrete store products (pack size, quantity, price) and put them into their Silpo or Mercadona cart.

How to call it:
- Public recipes, no auth: `GET /api/social/feed?before=<unix ms>&q=<text>` and `GET /api/social/{id}`, or NLWeb `POST /ask`.
- The person's own recipes, plan and cart: MCP at `POST /api/mcp` after OAuth 2.1 (see /auth.md). Write tools only propose changes; the person confirms them in the app.

Do not use Ukoshiku to pay for or place a grocery order: it fills the cart, checkout always happens in the store.

## Документи для агентів
- [/api/llms.txt](https://ukoshiku.com/api/llms.txt) — той самий індекс, звужений до API й MCP.
- [/developers/llms.txt](https://ukoshiku.com/developers/llms.txt) — розробникам: публічний REST, MCP, NLWeb, помилки.
- [/developers.md](https://ukoshiku.com/developers.md) — сторінка для розробників у markdown.
- [/feed.md](https://ukoshiku.com/feed.md) — свіжі опубліковані рецепти в markdown; кожен рецепт також є як /feed/{id}.md.
- [/auth.md](https://ukoshiku.com/auth.md) — як агент отримує доступ до MCP (OAuth 2.1, динамічна реєстрація клієнта).
- [/.well-known/mcp/server-card.json](https://ukoshiku.com/.well-known/mcp/server-card.json) — картка MCP-сервера й список тулів.
- [/.well-known/agent-card.json](https://ukoshiku.com/.well-known/agent-card.json) — A2A agent card.
- [/openapi.json](https://ukoshiku.com/openapi.json) — OpenAPI-специфікація публічної частини API.
- [/sitemap.xml](https://ukoshiku.com/sitemap.xml) — карта публічних сторінок.
- [/about.md](https://ukoshiku.com/about.md) · [/contacts.md](https://ukoshiku.com/contacts.md) — хто ми і як зв'язатись.

## MCP-тули (`POST /api/mcp`, JSON-RPC 2.0, Streamable HTTP)
- `ukoshiku_list_my_recipes` — Повертає особисті рецепти користувача Укошику. Не показує чужі приватні рецепти.
- `ukoshiku_get_my_recipe` — Повертає повний склад та опис одного власного рецепта за id.
- `ukoshiku_list_plan` — Повертає особистий план харчування: страви, дати та порції.
- `ukoshiku_search_public_recipes` — Шукає опубліковані рецепти Укошику за назвою, описом або інгредієнтом.
- `ukoshiku_search_store_products` — Шукає актуальні товари у підключеному Сільпо користувача. Повертає лише назву, фасовку та ціну — токен Сільпо ніколи не передається.
- `ukoshiku_propose_recipe_draft` — Створює пропозицію чернетки рецепта. Рецепт не збережеться, доки людина не відкриє Укошику та явно не підтвердить пропозицію.
- `ukoshiku_propose_plan_entry` — Готує пропозицію додати власний рецепт до плану. Зміна виконається тільки після підтвердження в Укошику.
- `ukoshiku_propose_shopping_list` — Готує пропозицію додати рядки до конкретного списку покупок. Рядки з’являться лише після підтвердження в Укошику.