# A1 · Яндекс Доставка · Поиск экспресс-заявок

**MCP-инструмент (tool) для Яндекс Доставки:** помогает найти заявки по статусу, контакту, периоду или внешнему номеру заказа.

Техническое имя: <code>express_search_claims</code>

## Какую задачу решает

> Я хочу быстро найти нужные доставки по известным признакам, чтобы проверить их состояние или продолжить работу.

## Когда использовать

Используйте инструмент, когда <code>claim_id</code> неизвестен, нужно получить список активных или завершённых заявок либо обработать их постранично.

## Что нужно передать

Один или несколько фильтров: идентификатор, телефон, статус, группа состояний, период создания, период подачи или внешний номер заказа. Для пагинации используйте <code>offset</code> и <code>limit</code> либо <code>cursor</code> из предыдущего ответа.

## Что вернёт

Массив найденных заявок и курсор следующей страницы.

## Что изменится в Яндекс Доставке

Ничего. Поиск только читает существующие заявки.

## Пример запроса

> Найди все активные экспресс-доставки за сегодня и покажи их статусы.

## Возможные ошибки и ограничения

- <code>limit</code> принимает значения от 1 до 1000;
- курсорная пагинация используется как отдельный режим;
- слишком широкие фильтры могут вернуть большой список.

## Связанные MCP-инструменты

- [express_get_claim](./express-get-claim.md) — открыть полные данные найденной заявки;
- [express_performer_position](./express-performer-position.md) — проверить курьера активной доставки;
- [express_tracking_links](./express-tracking-links.md) — получить ссылку для получателя.

## Технические сведения

- **Воздействие:** только чтение
- **Контур:** Express
- **Создание заказа:** нет
- [Полный технический справочник](../TOOLS.md)