chore: publish clean community baseline

2026-06-17 06:15:46 +00:00
commit 73b44eb93b
317 changed files with 72433 additions and 0 deletions
@@ -0,0 +1,35 @@
+# Примеры 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/