# Примеры Dadata

В этой папке лежат примеры операций Crank для Dadata. Их можно импортировать в интерфейсе Crank и использовать как основу для MCP-инструментов.

Dadata не предоставляет эти методы полностью без ключей. Для работы нужны ключи из личного кабинета Dadata:

- `Authorization: Token <API_KEY>` нужен для всех примеров.
- `X-Secret: <SECRET_KEY>` дополнительно нужен для методов стандартизации.

В YAML-файлах стоят заглушки `Token CHANGE_ME_DADATA_API_KEY` и `CHANGE_ME_DADATA_SECRET_KEY`. Перед использованием замените их в настройках операции на реальные значения. Не добавляйте ключи во входные параметры инструмента: тогда MCP-клиент и агент смогут их увидеть.

## Группа “Паспорта”

- `passports/dadata_clean_passport.operation.yaml` проверяет и разбирает номер паспорта через метод стандартизации.
- `passports/dadata_suggest_fms_unit.operation.yaml` ищет подразделение ФМС/МВД по коду или названию.

## Группа “Автомобили”

- `cars/dadata_clean_vehicle.operation.yaml` распознает марку и модель автомобиля из свободного текста.
- `cars/dadata_suggest_car_brand.operation.yaml` ищет марку автомобиля по русскому или английскому названию.

## Как проверить

1. Импортируйте нужный YAML-файл в Crank.
2. Замените заголовки-заглушки на реальные ключи Dadata.
3. Запустите тест операции в интерфейсе Crank.
4. Создайте агента, привяжите к нему операции одной группы и опубликуйте агента.
5. Подключите MCP-клиент к опубликованному агенту и вызовите нужный инструмент.

Документация Dadata:

- Проверка паспорта: https://dadata.ru/api/clean/passport/
- Подразделения ФМС/МВД: https://dadata.ru/api/suggest/fms_unit/
- Стандартизация автомобилей: https://dadata.ru/api/clean/vehicle/
- Марки автомобилей: https://dadata.ru/api/suggest/car_brand/