Проверяет, авторизован ли текущий профиль браузера в Яндексе. Если не авторизован — вызовите инструмент login (откроется окно входа).

Открывает видимое окно браузера для входа в аккаунт Яндекса (логин/пароль/SMS/капча). После входа сессия сохраняется в профиль, и сервер работает headless. Нужно один раз на компьютере. Обычно вызывается автоматически при первом обращении к сайту, но можно и вручную.

Возвращает текущий адрес доставки (метку сохранённого адреса, например «Дом», или улицу). Полезно спросить у пользователя «ищем тут?» перед поиском.

Возвращает сохранённые в аккаунте адреса доставки (с метками «Дом», «На работу» и деталями — подъезд/этаж/квартира). Их можно выбрать через set_address без повторного ввода на карте.

Устанавливает адрес доставки. По умолчанию СНАЧАЛА ищет совпадение среди сохранённых адресов (по метке «дом»/«работа» или улице) и выбирает его мгновенно, СОХРАНЯЯ квартиру/подъезд/этаж — без повторного тыканья по карте. Если сохранённого нет — вводит новый адрес через поиск на карте.

Отдаёт заведения, доставляющие на текущий адрес, с рейтингом и временем доставки (цена доставки — если распознана). • Для запроса «кто вообще доставляет / покажи подборку» вызывай БЕЗ query — вернётся весь каталог. НЕ придумывай ключевые слова (пицца/бургер): без них и так все. • query задавай только когда пользователь ищет конкретное (кухня, блюдо, название). • type разделяет выдачу: restaurant (по умолчанию, готовая еда) и shop (магазины/аптеки/цветы). Каталог смешанный — поэтому по умолчанию отдаём только рестораны. • По умолчанию возвращаются только ОТКРЫТЫЕ сейчас (доставляют прямо сейчас). Закрытые/предзаказ скрыты — не предлагай их и не пытайся собрать корзину в закрытом. includeClosed: true вернёт и закрытые (у них open: false). Требуется заранее установленный адрес (set_address).

Возвращает ПОЛНОЕ меню ресторана, сгруппированное по категориям (URL или slug из search_restaurants). По умолчанию компактно — без описаний, чтобы влезли все позиции (у крупных ресторанов их 200+): не делай выводов «такого нет», пока не просмотрел все категории. full: true добавит описания блюд. У позиций с hasOptions при добавлении нужен выбор вкуса/размера (options).

Возвращает группы обязательных/дополнительных опций блюда (вкус, размер, гарнир, добавки) с вариантами и ценами. Вызывай для позиций с hasOptions ПЕРЕД add_to_cart: покажи варианты пользователю (или выбери) и передай нужные в add_to_cart через options. Обязательные группы помечены required: true.

Работа с МАГАЗИНОМ (Пятёрочка, Магнит, Лента, Лавка…) — в отличие от ресторанов, у магазина тысячи товаров, поэтому меню не выгружают целиком, а ищут/смотрят по категориям: • без query и category → список категорий магазина (посмотреть, что есть); • query (напр. «молоко 3.2») → поиск товаров по запросу — ГЛАВНЫЙ путь для «добавь X из магазина»; • category (из списка категорий) → товары этой категории. Возвращает товары с ценой, ценой по акции (promoPrice), весом и наличием (inStock). Чтобы ДОБАВИТЬ товар в корзину — add_product (не add_to_cart). Требуется заданный адрес. Магазин задаётся именем.

Добавляет ТОВАР МАГАЗИНА (retail) в корзину — для магазинов используй это, а НЕ add_to_cart (та только для ресторанов). Сам открывает магазин с поиском товара, находит карточку по названию и жмёт «+». Название бери из результатов search_products (чем точнее, тем лучше).

Добавляет блюдо РЕСТОРАНА в корзину по названию (сначала get_menu на нужном ресторане). Для товаров МАГАЗИНА это НЕ работает — там add_product. Меню подгружается лениво — инструмент сам прокручивает страницу до позиции. Если у блюда hasOptions — СНАЧАЛА вызови get_item_options, чтобы узнать точные варианты, и передай выбранные в options (значения должны совпадать с вариантами из get_item_options). Без обязательных опций кнопка добавления заблокирована. Чтобы ПОМЕНЯТЬ опции уже добавленной позиции — Яндекс Еда не даёт их редактировать, поэтому удали её (remove_from_cart, при нескольких вариантах — с options) и добавь заново с новыми options.

Возвращает содержимое корзины: позиции (с количеством и выбранными опциями), подытог, стоимость доставки и итог.

Точечно удаляет ОДНУ позицию из корзины по названию (в отличие от clear_cart, который сносит всё). Одно и то же блюдо может лежать в корзине в нескольких вариантах с разными опциями (они видны в view_cart) — тогда укажи options, чтобы удалить нужный вариант. Это правильный способ ПОМЕНЯТЬ позицию: remove_from_cart нужный вариант → add_to_cart с новыми опциями.

Полностью очищает корзину (ВСЕ позиции и все корзины). Если в корзине есть и другие позиции, а поменять надо одну — используй remove_from_cart, а не это. Яндекс Еда не даёт редактировать опции в корзине, поэтому для смены варианта: remove_from_cart (или clear_cart, если корзина только из этой позиции) → add_to_cart заново.

Показывает доступные способы оплаты (карты, Карта Пэй, СБП) и текущий выбранный. Нужна НЕПУСТАЯ корзина (способы видны только на экране оформления). ВАЖНО: СБП требует ручного подтверждения в приложении банка и НЕ оформится автоматически — для авто-заказа выбирайте карту/Карту Пэй (параметр payment у place_order).

Оформляет заказ из корзины. ПО УМОЛЧАНИЮ безопасный dry-run: доходит до кнопки «Оплатить», но НЕ подтверждает. Для реального заказа передайте confirm=true. Через payment можно заранее выбрать способ оплаты (см. list_payment_methods). СБП автоматически НЕ проходит (нужно приложение банка) — для авто-заказа payment должен быть картой.

Переходит по пути или полному URL внутри Яндекс Еды.

Возвращает URL, заголовок и текст текущей страницы, а также сохраняет скриншот. Помогает подстроить селекторы при изменении вёрстки сайта.