VkusVill Telegram Bot

Telegram-бот для сбора продуктовых корзин ВкусВилл с использованием AI.

Что делает бот

• Принимает запросы на сбор продуктов (например, "Собери корзину для салата оливье")
• Использует Claude AI для понимания рецептов и подбора ингредиентов
• Ищет товары через MCP (Model Context Protocol) ВкусВилл
• Формирует корзину и генерирует ссылку для оформления заказа

Стек

• OpenAI Agents SDK — агентский фреймворк с поддержкой MCP
• LiteLLM — прокси для работы с разными LLM через OpenAI-совместимый интерфейс
• aiogram — асинхронный Telegram Bot API
• Claude Haiku 4.5 или Qwen 3 — языковые модели на выбор

Установка и запуск

1. Клонировать репозиторий

git clone https://github.com/maddness/vkusvill-mcp-bot.git
cd vkusvill-mcp-bot

2. Создать виртуальное окружение

python3 -m venv venv
source venv/bin/activate  # Linux/macOS
# или
venv\Scripts\activate  # Windows

3. Установить зависимости

pip install -r requirements.txt

4. Настроить переменные окружения

cp .env.example .env

Заполнить .env:

| Переменная | Описание | |------------|----------| | TELEGRAM_BOT_TOKEN | Токен бота от @BotFather | | ANTHROPIC_API_KEY | API ключ от Anthropic | | QWEN_API_KEY | API ключ для Qwen (опционально) | | MODEL | Выбор модели: haiku или qwen (по умолчанию haiku) |

5. Запустить бота

python main.py

Команды бота

| Команда | Описание | |---------|----------| | /start | Начать работу с ботом | | /new_chat | Сбросить контекст и начать заново |

Использование

1. Отправьте боту сообщение с описанием того, что хотите приготовить
2. Бот найдёт нужные продукты во ВкусВилл
3. Получите готовую корзину со ссылкой на оформление заказа
4. Нажмите кнопку "Собрать новую корзину" для нового запроса

Лицензия

MIT