DaData в MCP: компании по ИНН, адреса и банки в любом AI-агенте

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → DaData, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

DaData

Подсказки и поиск с DaData: российские адреса, компании и ИП по ИНН или ОГРН (ЕГРЮЛ/ЕГРИП), банки по БИК, ФИО и email, обратное геокодирование по координатам, город по IP и поиск по справочникам. По желанию платная стандартизация адресов, телефонов и ФИО, выключенная, пока вы её не разрешите.

Настройка

Настройка занимает около 2 минут. Нужен аккаунт DaData: на бесплатном тарифе доступно 10 000 запросов к подсказкам и поиску в день.

1. Зарегистрируйтесь на dadata.ru и откройте Профиль → API-ключи.
2. Скопируйте Ключ API (40 шестнадцатеричных символов) в DADATA_API_KEY. Вставляйте только сам ключ, без слова Token и пробелов: заголовок Authorization: Token коннектор добавит сам.
3. По желанию: скопируйте с той же страницы Секретный ключ в DADATA_SECRET_KEY. Без него работает всё, кроме dadata_get_balance, dadata_get_daily_stats и dadata_clean.
4. Установите коннектор и запустите dadata_find_party с ИНН 7707083893: он вернёт выписку этой компании из ЕГРЮЛ, и в пределах дневного лимита это бесплатно.

Что он читает: подсказки по адресам из произвольного текста с индексом, кодами ФИАС/ГАР и КЛАДР, ОКАТО/ОКТМО, налоговой инспекцией, координатами и часовым поясом; адрес по коду ФИАС/ГАР, КЛАДР или кадастровому номеру; ближайшие адреса по координатам; город по IP-адресу в России; компании и ИП из ЕГРЮЛ/ЕГРИП по названию, ИНН, ОГРН, адресу или руководителю, с КПП, ОКВЭД, руководителем, статусом, датами регистрации и ликвидации; банки по названию, БИК, SWIFT или ИНН с корреспондентским счётом; ФИО с разбором на фамилию, имя и отчество и определением пола; подсказки email; справочники DaData: кем выдан паспорт (по коду подразделения), почтовые отделения, налоговые инспекции и таможни, суды, станции метро, марки автомобилей, страны, валюты, ОКВЭД 2, ОКПД 2, ОКТМО и классы МКТУ.

Детали зависят от тарифа: подсказки и поиск входят в вашу подписку DaData. Платные тарифы добавляют поля вроде финансовых показателей и расширенных сведений о компании. dadata_find_affiliated, который находит компании, где человек или организация выступает учредителем или руководителем, работает только на тарифе «Максимальный»; на остальных тарифах ответ 403.

Как устроены ответы: при поиске компании по ИНН ИИ запрашивает головную организацию (branch_type MAIN), если вам не нужны филиалы; по названию он сначала берёт подсказку, а потом ищет по найденному ИНН. Даты компаний приходят в миллисекундах Unix, ИИ переводит их в обычные даты. Подсказки по адресам охватывают Россию; для Беларуси, Казахстана, Узбекистана и других стран ИИ расширяет поиск через locations. Подсказки email не проверяют, существует ли ящик, а поиск по IP знает только российские адреса.

Спрашивает перед каждым платным вызовом: ни один инструмент ничего не меняет в вашем аккаунте DaData. Деньги стоит только стандартизация: перед каждым вызовом ИИ проверяет баланс через dadata_get_balance, говорит, сколько значений будет обработано и во что это обойдётся, и ждёт вашего согласия.

Отключено при установке: dadata_clean (Стандартизация). Он приводит к стандарту и проверяет «сырые» адреса, телефоны, ФИО, email, паспорта, даты рождения и автомобили, а DaData списывает плату за каждое значение с баланса аккаунта на любом тарифе. Нужен DADATA_SECRET_KEY, за один вызов не больше 50 значений, в цикле инструмент не запускается. Администратор включает его осознанно.

Ограничения: на бесплатном тарифе 10 000 запросов в день, а DaData принимает около 30 запросов в секунду. dadata_get_daily_stats показывает, сколько из сегодняшнего лимита уже израсходовано.

Частые ошибки: 403 с текстом «Feature ... disabled for token» означает, что ключ API неверный или сервис не входит в тариф: скопируйте ключ заново в Профиль → API-ключи. 401 на балансе, статистике или стандартизации означает, что секретный ключ не указан или неверен. 429 означает, что превышена частота запросов или дневной лимит: подождите или проверьте расход.

Коннектор не пополняет баланс, не меняет тариф и ключи и не подтверждает, что почтовый ящик действительно существует.

Предварительные требования: DADATA_API_KEY

Локальная установка коннектора

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Откройте http://localhost:3000/connectors/store, выберите DaData и введите переменные, перечисленные в Предварительных требованиях.

Доступные инструменты

Примеры запросов

• «Проверь компанию с ИНН 7707083893: действует ли она, кто руководитель, какой юридический адрес и основной ОКВЭД?»
• «Наш поставщик ООО Ромашка из Казани ещё действует? Дай его ИНН, КПП и ОГРН.»
• «Найди банк по БИК 044525225 и дай корреспондентский счёт и адрес.»
• «Разбери адрес и дай его полностью с индексом и кодом ФИАС: мск сухонская 11 кв 89.»
• «Сколько запросов к DaData мы уже потратили сегодня и сколько осталось на балансе?»

Следующие шаги

• Подключить к Claude
• Подключить к ChatGPT