Pepesto MCP Server

MCP-сервер для API Pepesto — дайте своему агенту возможность превратить любой рецепт (URL, обычный текст или фото) в готовую корзину реальных товаров из супермаркета с актуальными ценами в 26 европейских сетях. Этот MCP охватывает этап «рецепт → сформированная корзина» в процессе покупки продуктов (парсинг / поиск / сопоставление ингредиентов с артикулами (SKU) / проверка каталогов); оформление заказа — это отдельный шаг, см. Где происходит оформление заказа.

Быстрая установка

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "pepesto": {
      "command": "npx",
      "args": ["-y", "@pepesto/pepesto-mcp"],
      "env": { "PEPESTO_API_KEY": "pep_sk_…" }
    }
  }
}

Claude Code

claude mcp add pepesto -e PEPESTO_API_KEY=pep_sk_… -- npx -y @pepesto/pepesto-mcp

Получение API-ключа

1. Начните с покупки пакета кредитов по модели pay-as-you-go — см. https://www.pepesto.com/pricing/.

2. Создайте API-ключ, вызвав /link с адресом электронной почты, который вы использовали при оплате. Ключ возвращается только один раз — сохраните его сразу.

   curl -X POST https://s.pepesto.com/api/link \
     -H "Content-Type: application/json" \
     -d '{"email":"you@example.com"}'

3. Установите ключ в своем окружении:

   export PEPESTO_API_KEY=pep_sk_…

Инструменты

Этот MCP останавливается на этапе «сформированная корзина с ценами» — см. Где происходит оформление заказа, чтобы узнать, как пользователи завершают заказ. Эндпоинты /session, /checkout и /link намеренно не включены; см. Дорожную карту для ознакомления с планами.

Примеры диалогов

Быстрый: URL рецепта → сформированная корзина

Самый быстрый путь. Один вызов инструмента возвращает сформированную корзину и ссылку на оформление заказа.

Пользователь: Используй рецепт пиццы «Маргарита» с BBC Good Food, чтобы собрать корзину в Tesco, а также добавь газированную воду и оливковое масло.

Ассистент: [Использует pepesto_oneshot с content_urls, content_text, supermarket_domain: "tesco.com"]

Ассистент: Корзина сформирована в Tesco. Ссылка на оформление заказа: <redirect_url>.

Просмотр графа рецептов → выбор → сформированная корзина

Для запросов типа «найди мне что-нибудь приготовить», когда агент сначала ищет в графе рецептов Pepesto и возвращает подобранные товары с ценами.

Пользователь: Найди мне веганский рецепт пасты на двоих.

Ассистент: [Использует pepesto_suggest с query: "vegan pasta dinner for two"]

Ассистент: Три варианта: Creamy Cashew Penne, Lemon Garlic Spaghetti, Roasted Veg Rigatoni. Какой выберете?

Пользователь: Давай первый. Закажи в Coop (coop.ch).

Ассистент: [Использует pepesto_products с kg_token выбранного рецепта и supermarket_domain: "coop.ch"]

Ассистент: Подобрано 8 ингредиентов в Coop — кешью 4.20 CHF, пенне 1.95 CHF, ... — итого 18.40 CHF.

Парсинг конкретного рецепта → сформированная корзина

Когда у пользователя уже есть на примете URL или текст рецепта. MCP возвращает список подобранных товаров — что с ним делать, решать вам.

Пользователь: Распарси это и выдели ингредиенты: https://www.bbcgoodfood.com/recipes/pizza-margherita-4-easy-steps

Ассистент: [Использует pepesto_parse с recipe_url]

Ассистент: Pizza Margherita in 4 easy steps — 8 ингредиентов: мука для хлеба, быстродействующие дрожжи, ...

Пользователь: Теперь сопоставь их с товарами Sainsbury's.

Ассистент: [Использует pepesto_products с возвращенным kg_token и supermarket_domain: "sainsburys.co.uk"]

Ассистент: Подобрано 8 ингредиентов в Sainsbury's — итого 6.40 £.

Еженедельный план питания → одна объединенная корзина

Несколько kg_token через pepesto_products в одном вызове — Pepesto объединяет дублирующиеся ингредиенты из разных рецептов.

Пользователь: Спланируй 5 кето-ужинов на неделю и подбери их в Delhaize.

Ассистент: [Использует pepesto_suggest с query: "keto dinner low carb high protein", num_to_fetch: 5]

Ассистент: Пять ужинов: Steak & Kale, Salmon Avocado Bowl, Zucchini Lasagna, Cauliflower Risotto, Chicken Caesar.

Пользователь: Составь один список покупок на всю неделю.

Ассистент: [Использует pepesto_products со всеми пятью kg_tokens и supermarket_domain: "delhaize.be"]

Ассистент: Объединенная корзина: 24 уникальных ингредиента (некоторые повторяются в рецептах), ориентировочная стоимость 68.40 € в Delhaize.

Сравнение цен в двух супермаркетах

Прогоните один и тот же рецепт через pepesto_products для каждого магазина и сравните итоговые суммы.

Пользователь: Распарси этот рецепт воскресного обеда.

Ассистент: [Использует pepesto_parse]

Ассистент: Готово: Italian Sunday Lunch, 12 ингредиентов.

Пользователь: Покажи мне корзину в Esselunga и Conad, чтобы я мог сравнить.

Ассистент: [Использует pepesto_products дважды — supermarket_domain: "spesaonline.esselunga.it", затем supermarket_domain: "spesaonline.conad.it"]

Ассистент: Esselunga: 34.20 €. Conad: 31.50 €. Conad дешевле на 2.70 €, в основном за счет пасты и томатов.

Выгрузка каталога для анализа рынка

Только по явному запросу и с агрессивным кэшированием — см. Цены и лучшие практики ниже.

Пользователь: Я создаю дашборд для сравнения цен. Выгрузи полный каталог Plus NL.

Ассистент: Предупреждаю — pepesto_catalog — самый дорогой вызов. Я запущу его только один раз; вам следует кэшировать результат минимум на день. Подтверждаете?

Пользователь: Да.

Ассистент: [Использует pepesto_catalog с supermarket_domain: "plus.nl"]

Ассистент: Каталог выгружен: 1 847 SKU в 23 категориях.

Поддерживаемые супермаркеты

Нужен супермаркет, которого нет в этом списке? Свяжитесь с Pepesto.

Где происходит оформление заказа

Этот MCP останавливается на этапе «сформированная корзина с ценами». Он не автоматизирует оформление заказа на сайте супермаркета. Есть два способа завершить покупку:

• Приложение Pepesto (рекомендуется). Откройте redirect_url, возвращенный pepesto_oneshot, в браузере или передайте пользователю список подобранных товаров из pepesto_products и предложите воссоздать его в приложении Pepesto — именно там находится процесс оформления заказа, включая вход в систему, проверку корзины и (для некоторых рынков) оплату.

• Сайт самого супермаркета. Пользователь может взять список товаров из pepesto_products и добавить SKU напрямую на tesco.com / coop.ch и т.д. Это медленнее, но аккаунт Pepesto не требуется.

Цены и лучшие практики

Pepesto работает по простой модели оплаты за использование — вы платите только за то, что реально используют ваши агенты, а кредиты никогда не сгорают, поэтому пополнение остается вашим до тех пор, пока вы его не потратите. Мы также предлагаем скидки для студентов и начинающих команд, так что напишите нам, если это про вас. Полный прайс-лист и объемы доступны на https://www.pepesto.com/pricing/.

Несколько советов, как получить максимум от каждого кредита:

• pepesto_credits бесплатен — вызывайте его в любое время для быстрой проверки баланса.

• pepesto_oneshot, pepesto_parse, pepesto_suggest и pepesto_products — это повседневные вызовы (подобрать рецепт, спланировать неделю, сравнить корзины), и они рассчитаны на рутинное использование агентами.

• pepesto_catalog выполняет полную выгрузку SKU для супермаркета и является самым тяжелым вызовом. Это правильный инструмент для глубокого анализа рынка или дашбордов сравнения цен — просто кэшируйте результат минимум на день для каждого супермаркета. Не уверены, что он вам нужен? Расскажите нам о своем сценарии использования, и мы обычно подскажем более дешевый путь.

Дорожная карта

Планируется добавить:

• pepesto_session — обертка для /session, чтобы агент мог создать сессию оформления заказа на стороне Pepesto из выбранных SKU.

• pepesto_checkout — обертка для /checkout, цикла автоматизации браузера, который управляет сайтом супермаркета (вход, добавление в корзину, запрос CAPTCHA и т.д.). Это недостающее звено для полностью автономных покупок.

• Передача в хостинг-оформление — вывод глубокой ссылки приложения Pepesto как структурированного результата инструмента (вместо обычного текста), чтобы клиенты MCP могли отображать её как кнопку, а не как URL.

Если что-то из этого поможет вам в работе, сообщите нам — это поднимет их выше в очереди разработки.

Разработка

git clone https://github.com/pepesto-solutions/pepesto-mcp.git
cd pepesto-mcp
npm install
npm run build
npm test
npm run test:coverage

Запустите инспектор для локальной сборки:

PEPESTO_API_KEY=pep_sk_… npm run inspector

Лицензия

MCP-сервер Pepesto в этом репозитории распространяется под лицензией MIT.