crank/examples/dadata/README.md

Примеры 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/