A1 · Яндекс Доставка · Поиск экспресс-заявок
MCP-инструмент (tool) для Яндекс Доставки: помогает найти заявки по статусу, контакту, периоду или внешнему номеру заказа.
Техническое имя: express_search_claims
Какую задачу решает
Я хочу быстро найти нужные доставки по известным признакам, чтобы проверить их состояние или продолжить работу.
Когда использовать
Используйте инструмент, когда claim_id неизвестен, нужно получить список активных или завершённых заявок либо обработать их постранично.
Что нужно передать
Один или несколько фильтров: идентификатор, телефон, статус, группа состояний, период создания, период подачи или внешний номер заказа. Для пагинации используйте offset и limit либо cursor из предыдущего ответа.
Что вернёт
Массив найденных заявок и курсор следующей страницы.
Что изменится в Яндекс Доставке
Ничего. Поиск только читает существующие заявки.
Пример запроса
Найди все активные экспресс-доставки за сегодня и покажи их статусы.
Возможные ошибки и ограничения
limitпринимает значения от 1 до 1000;- курсорная пагинация используется как отдельный режим;
- слишком широкие фильтры могут вернуть большой список.
Связанные MCP-инструменты
- express_get_claim — открыть полные данные найденной заявки;
- express_performer_position — проверить курьера активной доставки;
- express_tracking_links — получить ссылку для получателя.
Технические сведения
- Воздействие: только чтение
- Контур: Express
- Создание заказа: нет
- Полный технический справочник