---
title: "Укошику · розробникам і агентам"
description: "Публічне API Укошику: стрічка рецептів без входу, NLWeb /ask і MCP для агентів."
canonical: "https://ukoshiku.com/developers"
last-updated: "2026-09-23"
---

# Укошику · розробникам і агентам

Укошику відкритий для програмного доступу двома способами: анонімне читання публічної стрічки рецептів і MCP для AI-агентів, яким людина явно надала доступ до свого акаунта.

## Публічна стрічка
Без ключа й без входу — курсорна пагінація по опублікованих рецептах.
- `GET https://ukoshiku.com/api/social/feed?before=<unix ms>` — наступна сторінка стрічки (фільтри `q`, `sort`, `min`, `max`, `time`).
- `GET https://ukoshiku.com/api/social/{id}` — одна публікація зі складом.
- `POST https://ukoshiku.com/ask` — пошук рецептів природною мовою (NLWeb).

## MCP для агентів
Особисті рецепти, план харчування та кошик Сільпо/Mercadona — через OAuth 2.1 і Model Context Protocol на `POST https://ukoshiku.com/api/mcp`.
- [/auth.md](https://ukoshiku.com/auth.md) — як агент отримує доступ, крок за кроком.
- [/.well-known/mcp/server-card.json](https://ukoshiku.com/.well-known/mcp/server-card.json) — картка сервера й повний список тулів.
- `POST https://ukoshiku.com/api/docs-mcp` — окремий MCP без авторизації лише з документацією.

## Машиночитані документи
- [/llms.txt](https://ukoshiku.com/llms.txt) — навігаційний індекс для агентів.
- [/developers/llms.txt](https://ukoshiku.com/developers/llms.txt) — помилки, NLWeb, WebMCP.
- [/openapi.json](https://ukoshiku.com/openapi.json) — OpenAPI-специфікація публічного REST.

## MCP-тули
- `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` — Готує пропозицію додати рядки до конкретного списку покупок. Рядки з’являться лише після підтвердження в Укошику.