API проверки контрагентов и MCP-сервер
Данные о компаниях и ИП по ИНН и ОГРН — прямо в вашей CRM, учётной системе, на сайте или в ИИ-ассистенте. Реквизиты и статус из ЕГРЮЛ и ЕГРИП, руководители и учредители, бухгалтерская отчётность, налоги, риски, исполнительные производства, банкротство и госзакупки.
- Проверка контрагента перед сделкой: статус, риски, долги и банкротство
- Автозаполнение реквизитов в CRM, учётной системе и формах на сайте
- Проверка клиентов и поставщиков при оформлении заявок: связи, адрес, исполнительные производства
- ИИ-ассистенты и чат-боты, которые отвечают о компаниях по данным реестров, а не по памяти
Как начать
- Войдите на сайт и создайте ключ в личном кабинете, раздел «API». За первый ключ начислим 100 запросов — хватит, чтобы попробовать платные методы.
- Передавайте ключ в заголовке каждого запроса:
Authorization: Bearer <ключ>. - Пополните баланс API пакетом запросов: с него списывают платные методы. Поиск бесплатный.
Хотите попробовать без регистрации? Подключите MCP-сервер к ИИ-ассистенту — поиск и основные сведения о компаниях доступны без ключа.
Адрес API: https://clickfile.ru/api/v1. Ответы — JSON, даты в формате ГГГГ-ММ-ДД.
Методы REST
Вместо {id} подставьте ОГРН, ОГРНИП или ИНН. Если по ИНН нашлось несколько записей, вернётся действующая.
| Запрос | Что вернёт |
|---|---|
GET /api/v1/companies?query=&limit= | Поиск по ИНН, ОГРН или названию, до 20 результатов |
GET /api/v1/companies/{id} | Реквизиты, статус, адрес, руководитель, учредители, ОКВЭД, капитал, численность, МСП, налоговые режимы, филиалы |
GET /api/v1/companies/{id}/contacts | Телефоны, электронная почта и сайты компании |
GET /api/v1/companies/{id}/finance | Бухгалтерская отчётность по годам |
GET /api/v1/companies/{id}/taxes | Уплаченные налоги и взносы, задолженность, численность по годам |
GET /api/v1/companies/{id}/risks | Сводка рисков и факторы надёжности: санкции, дисквалификация, иноагенты, недобросовестные поставщики, недостоверные сведения, число компаний по тому же адресу, налоговая задолженность, исполнительные производства, банкротство по ЕФРСБ |
GET /api/v1/companies/{id}/enforcement | Исполнительные производства ФССП |
GET /api/v1/companies/{id}/history | История изменений в ЕГРЮЛ и ЕГРИП |
GET /api/v1/companies/{id}/connections | Связанные компании: через руководителя и учредителей, дочерние, предшественники и правопреемники |
GET /api/v1/companies/{id}/same-address | Компании по тому же адресу |
GET /api/v1/companies/{id}/procurement | Госзакупки по 44-ФЗ, 223-ФЗ и 615-ПП |
GET /api/v1/companies/{id}/procurement/counterparties | Заказчики и поставщики по госзакупкам |
GET /api/v1/companies/{id}/licenses | Лицензии |
GET /api/v1/companies/{id}/inspections | Проверки контрольных органов |
GET /api/v1/companies/{id}/trademarks | Товарные знаки |
GET /api/v1/companies/{id}/gov-support | Господдержка |
GET /api/v1/companies/{id}/certificates | Сертификаты и декларации соответствия |
GET /api/v1/companies/{id}/registries | Реестры: СРО, ИТ-аккредитация, реестр ПО, промышленная продукция, СМИ, Банк России |
GET /api/v1/account | Баланс API, пакеты запросов, цены и лимиты вашего ключа |
GET /api/v1/pricing | Цены, пакеты запросов и лимиты, без ключа |
- Запрос
GET /api/v1/companies?query=&limit=Что вернётПоиск по ИНН, ОГРН или названию, до 20 результатов - Запрос
GET /api/v1/companies/{id}Что вернётРеквизиты, статус, адрес, руководитель, учредители, ОКВЭД, капитал, численность, МСП, налоговые режимы, филиалы - Запрос
GET /api/v1/companies/{id}/contactsЧто вернётТелефоны, электронная почта и сайты компании - Запрос
GET /api/v1/companies/{id}/financeЧто вернётБухгалтерская отчётность по годам - Запрос
GET /api/v1/companies/{id}/taxesЧто вернётУплаченные налоги и взносы, задолженность, численность по годам - Запрос
GET /api/v1/companies/{id}/risksЧто вернётСводка рисков и факторы надёжности: санкции, дисквалификация, иноагенты, недобросовестные поставщики, недостоверные сведения, число компаний по тому же адресу, налоговая задолженность, исполнительные производства, банкротство по ЕФРСБ - Запрос
GET /api/v1/companies/{id}/enforcementЧто вернётИсполнительные производства ФССП - Запрос
GET /api/v1/companies/{id}/historyЧто вернётИстория изменений в ЕГРЮЛ и ЕГРИП - Запрос
GET /api/v1/companies/{id}/connectionsЧто вернётСвязанные компании: через руководителя и учредителей, дочерние, предшественники и правопреемники - Запрос
GET /api/v1/companies/{id}/same-addressЧто вернётКомпании по тому же адресу - Запрос
GET /api/v1/companies/{id}/procurementЧто вернётГосзакупки по 44-ФЗ, 223-ФЗ и 615-ПП - Запрос
GET /api/v1/companies/{id}/procurement/counterpartiesЧто вернётЗаказчики и поставщики по госзакупкам - Запрос
GET /api/v1/companies/{id}/licensesЧто вернётЛицензии - Запрос
GET /api/v1/companies/{id}/inspectionsЧто вернётПроверки контрольных органов - Запрос
GET /api/v1/companies/{id}/trademarksЧто вернётТоварные знаки - Запрос
GET /api/v1/companies/{id}/gov-supportЧто вернётГосподдержка - Запрос
GET /api/v1/companies/{id}/certificatesЧто вернётСертификаты и декларации соответствия - Запрос
GET /api/v1/companies/{id}/registriesЧто вернётРеестры: СРО, ИТ-аккредитация, реестр ПО, промышленная продукция, СМИ, Банк России - Запрос
GET /api/v1/accountЧто вернётБаланс API, пакеты запросов, цены и лимиты вашего ключа - Запрос
GET /api/v1/pricingЧто вернётЦены, пакеты запросов и лимиты, без ключа
Полное описание полей — в OpenAPI.
Примеры
Поиск компании
curl "https://clickfile.ru/api/v1/companies?query=7707083893&limit=5" \
-H "Authorization: Bearer ВАШ_КЛЮЧ"{
"query": "7707083893",
"total": 1,
"items": [
{
"ogrn": "1027700132195",
"inn": "7707083893",
"type": "legal",
"name": "ПАО СБЕРБАНК",
"status": "active",
"address": "г. Москва, ул. Вавилова, д. 19",
"head": {
"position": "Президент, председатель правления",
"name": "Греф Герман Оскарович"
},
"registration_date": "1991-06-20",
"main_okved": {
"code": "64.19",
"name": "Денежное посредничество прочее"
}
}
]
}Карточка компании
curl "https://clickfile.ru/api/v1/companies/1027700132195" \
-H "Authorization: Bearer ВАШ_КЛЮЧ"{
"level": "full",
"hidden_blocks": [],
"ogrn": "1027700132195",
"inn": "7707083893",
"kpp": "773601001",
"type": "legal",
"name": "ПАО СБЕРБАНК",
"full_name": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО «СБЕРБАНК РОССИИ»",
"status": "active",
"registration_date": "1991-06-20",
"address": {
"value": "г. Москва, ул. Вавилова, д. 19",
"region": "Москва",
"city": "Москва"
},
"head": {
"position": "Президент, председатель правления",
"name": "Греф Герман Оскарович"
},
"main_okved": {
"code": "64.19",
"name": "Денежное посредничество прочее"
}
}Цены и лимиты
Цена зависит от метода: в таблице указано, сколько запросов с баланса API списывает один успешный вызов, для списков — одна страница. Если компания не найдена, запросы не списываются. Пополнить баланс API можно в личном кабинете.
| Метод REST | Инструмент MCP | Цена |
|---|---|---|
GET /api/v1/companies | search_companies | Бесплатно |
— | get_company_basic | Бесплатно |
GET /api/v1/companies/{id} | get_company | 1 запрос |
GET /api/v1/companies/{id}/contacts | get_company_contacts | 3 запроса |
GET /api/v1/companies/{id}/finance | get_company_finance | 2 запроса |
GET /api/v1/companies/{id}/risks | get_company_risks | 3 запроса |
GET /api/v1/companies/{id}/enforcement | get_company_enforcement | 1 запрос |
GET /api/v1/companies/{id}/history | get_company_history | 2 запроса |
GET /api/v1/companies/{id}/connections | get_company_connections | 3 запроса |
GET /api/v1/companies/{id}/taxes | get_company_taxes | 1 запрос |
GET /api/v1/companies/{id}/procurement | get_company_procurement | 1 запрос |
GET /api/v1/companies/{id}/procurement/counterparties | get_company_procurement_counterparties | 1 запрос |
GET /api/v1/companies/{id}/licenses | get_company_licenses | 1 запрос |
GET /api/v1/companies/{id}/inspections | get_company_inspections | 1 запрос |
GET /api/v1/companies/{id}/trademarks | get_company_trademarks | 1 запрос |
GET /api/v1/companies/{id}/gov-support | get_company_gov_support | 1 запрос |
GET /api/v1/companies/{id}/registries | get_company_registries | 1 запрос |
GET /api/v1/companies/{id}/certificates | get_company_certificates | 1 запрос |
GET /api/v1/companies/{id}/same-address | get_company_same_address | 1 запрос |
GET /api/v1/account | get_account | Бесплатно |
GET /api/v1/pricing | — | Бесплатно |
- Метод REST
GET /api/v1/companiesИнструмент MCPsearch_companiesЦенаБесплатно - Метод REST
—Инструмент MCPget_company_basicЦенаБесплатно - Метод REST
GET /api/v1/companies/{id}Инструмент MCPget_companyЦена1 запрос - Метод REST
GET /api/v1/companies/{id}/contactsИнструмент MCPget_company_contactsЦена3 запроса - Метод REST
GET /api/v1/companies/{id}/financeИнструмент MCPget_company_financeЦена2 запроса - Метод REST
GET /api/v1/companies/{id}/risksИнструмент MCPget_company_risksЦена3 запроса - Метод REST
GET /api/v1/companies/{id}/enforcementИнструмент MCPget_company_enforcementЦена1 запрос - Метод REST
GET /api/v1/companies/{id}/historyИнструмент MCPget_company_historyЦена2 запроса - Метод REST
GET /api/v1/companies/{id}/connectionsИнструмент MCPget_company_connectionsЦена3 запроса - Метод REST
GET /api/v1/companies/{id}/taxesИнструмент MCPget_company_taxesЦена1 запрос - Метод REST
GET /api/v1/companies/{id}/procurementИнструмент MCPget_company_procurementЦена1 запрос - Метод REST
GET /api/v1/companies/{id}/procurement/counterpartiesИнструмент MCPget_company_procurement_counterpartiesЦена1 запрос - Метод REST
GET /api/v1/companies/{id}/licensesИнструмент MCPget_company_licensesЦена1 запрос - Метод REST
GET /api/v1/companies/{id}/inspectionsИнструмент MCPget_company_inspectionsЦена1 запрос - Метод REST
GET /api/v1/companies/{id}/trademarksИнструмент MCPget_company_trademarksЦена1 запрос - Метод REST
GET /api/v1/companies/{id}/gov-supportИнструмент MCPget_company_gov_supportЦена1 запрос - Метод REST
GET /api/v1/companies/{id}/registriesИнструмент MCPget_company_registriesЦена1 запрос - Метод REST
GET /api/v1/companies/{id}/certificatesИнструмент MCPget_company_certificatesЦена1 запрос - Метод REST
GET /api/v1/companies/{id}/same-addressИнструмент MCPget_company_same_addressЦена1 запрос - Метод REST
GET /api/v1/accountИнструмент MCPget_accountЦенаБесплатно - Метод REST
GET /api/v1/pricingИнструмент MCP—ЦенаБесплатно
Пакеты запросов
| Пакет | Цена | За запрос |
|---|---|---|
| 5 000 запросов | 1 500 ₽ | 0,30 ₽ за запрос |
| 25 000 запросов | 6 250 ₽ | 0,25 ₽ за запрос |
| 100 000 запросов | 20 000 ₽ | 0,20 ₽ за запрос |
- Пакет5 000 запросовЦена1 500 ₽За запрос0,30 ₽ за запрос
- Пакет25 000 запросовЦена6 250 ₽За запрос0,25 ₽ за запрос
- Пакет100 000 запросовЦена20 000 ₽За запрос0,20 ₽ за запрос
Лимиты частоты
| Вызовы | В минуту | В сутки |
|---|---|---|
| Бесплатные инструменты MCP без ключа, на один IP-адрес | 20 | 200 |
| Бесплатные инструменты MCP с ключом | 60 | 2 000 |
| Поиск компаний через REST API | 120 | — |
| Платные методы | 600 | — |
| Баланс и цены | 120 | — |
| Запросы с ключом с одного IP-адреса | 1 200 | — |
- ВызовыБесплатные инструменты MCP без ключа, на один IP-адресВ минуту20В сутки200
- ВызовыБесплатные инструменты MCP с ключомВ минуту60В сутки2 000
- ВызовыПоиск компаний через REST APIВ минуту120В сутки—
- ВызовыПлатные методыВ минуту600В сутки—
- ВызовыБаланс и ценыВ минуту120В сутки—
- ВызовыЗапросы с ключом с одного IP-адресаВ минуту1 200В сутки—
При превышении лимита API ответит кодом 429 и подскажет в заголовке Retry-After, через сколько секунд повторить.
Ошибки
Ошибка приходит с HTTP-статусом и телом в одном формате:
{
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "На балансе API не хватает запросов: метод стоит 1 запрос. Пополните баланс в личном кабинете, раздел «API»."
}
}| HTTP | Код | Что значит |
|---|---|---|
| 400 | INVALID_ARGUMENT | Неверный параметр запроса, например ИНН не той длины |
| 401 | UNAUTHORIZED | Нет ключа или ключ отозван |
| 402 | INSUFFICIENT_BALANCE | На балансе API не хватает запросов |
| 403 | FORBIDDEN | Ключ не подходит для этого метода |
| 403 | RESTRICTED | Данные этой компании закрыты |
| 404 | NOT_FOUND | Компания не найдена, запросы не списываются |
| 429 | RATE_LIMITED | Слишком много запросов. Повторите через Retry-After секунд |
| 503 | UNAVAILABLE | Временный сбой. Запросы за вызов возвращаются на баланс, повторите позже |
- HTTP400Код
INVALID_ARGUMENTЧто значитНеверный параметр запроса, например ИНН не той длины - HTTP401Код
UNAUTHORIZEDЧто значитНет ключа или ключ отозван - HTTP402Код
INSUFFICIENT_BALANCEЧто значитНа балансе API не хватает запросов - HTTP403Код
FORBIDDENЧто значитКлюч не подходит для этого метода - HTTP403Код
RESTRICTEDЧто значитДанные этой компании закрыты - HTTP404Код
NOT_FOUNDЧто значитКомпания не найдена, запросы не списываются - HTTP429Код
RATE_LIMITEDЧто значитСлишком много запросов. Повторите через Retry-After секунд - HTTP503Код
UNAVAILABLEЧто значитВременный сбой. Запросы за вызов возвращаются на баланс, повторите позже
MCP-сервер для ИИ-ассистентов
MCP (Model Context Protocol) — открытый стандарт, по которому ИИ-ассистенты подключают внешние данные. Подключите ClickFile, и ассистент сам найдёт компанию по названию или ИНН, прочитает данные реестров и ответит обычными словами — например, на просьбу «проверь поставщика перед договором».
Поиск и основные сведения о компании работают без ключа и регистрации, с ограничением числа запросов. Для полной карточки, контактов, отчётности, рисков и других данных нужен ключ: с ним вызовы списывают запросы с баланса API.
https://clickfile.ru/api/mcp| Инструмент | Что вернёт | Доступ |
|---|---|---|
search_companies | Поиск по ИНН, ОГРН или названию | Без ключа |
get_company_basic | Основные сведения, как на открытой карточке сайта | Без ключа |
get_company | Полная карточка компании | Ключ, запросы API |
get_company_contacts | Контакты компании | Ключ, запросы API |
get_company_finance | Бухгалтерская отчётность | Ключ, запросы API |
get_company_risks | Сводка рисков | Ключ, запросы API |
get_company_enforcement | Исполнительные производства | Ключ, запросы API |
get_company_taxes | Налоги, задолженность и численность | Ключ, запросы API |
get_company_history | История изменений | Ключ, запросы API |
get_company_connections | Связанные компании | Ключ, запросы API |
get_company_same_address | Компании по тому же адресу | Ключ, запросы API |
get_company_procurement | Госзакупки | Ключ, запросы API |
get_company_procurement_counterparties | Контрагенты по госзакупкам | Ключ, запросы API |
get_company_licenses | Лицензии | Ключ, запросы API |
get_company_inspections | Проверки | Ключ, запросы API |
get_company_trademarks | Товарные знаки | Ключ, запросы API |
get_company_gov_support | Господдержка | Ключ, запросы API |
get_company_certificates | Сертификаты и декларации | Ключ, запросы API |
get_company_registries | Отраслевые реестры | Ключ, запросы API |
get_account | Баланс и цены | Ключ |
- Инструмент
search_companiesЧто вернётПоиск по ИНН, ОГРН или названиюДоступБез ключа - Инструмент
get_company_basicЧто вернётОсновные сведения, как на открытой карточке сайтаДоступБез ключа - Инструмент
get_companyЧто вернётПолная карточка компанииДоступКлюч, запросы API - Инструмент
get_company_contactsЧто вернётКонтакты компанииДоступКлюч, запросы API - Инструмент
get_company_financeЧто вернётБухгалтерская отчётностьДоступКлюч, запросы API - Инструмент
get_company_risksЧто вернётСводка рисковДоступКлюч, запросы API - Инструмент
get_company_enforcementЧто вернётИсполнительные производстваДоступКлюч, запросы API - Инструмент
get_company_taxesЧто вернётНалоги, задолженность и численностьДоступКлюч, запросы API - Инструмент
get_company_historyЧто вернётИстория измененийДоступКлюч, запросы API - Инструмент
get_company_connectionsЧто вернётСвязанные компанииДоступКлюч, запросы API - Инструмент
get_company_same_addressЧто вернётКомпании по тому же адресуДоступКлюч, запросы API - Инструмент
get_company_procurementЧто вернётГосзакупкиДоступКлюч, запросы API - Инструмент
get_company_procurement_counterpartiesЧто вернётКонтрагенты по госзакупкамДоступКлюч, запросы API - Инструмент
get_company_licensesЧто вернётЛицензииДоступКлюч, запросы API - Инструмент
get_company_inspectionsЧто вернётПроверкиДоступКлюч, запросы API - Инструмент
get_company_trademarksЧто вернётТоварные знакиДоступКлюч, запросы API - Инструмент
get_company_gov_supportЧто вернётГосподдержкаДоступКлюч, запросы API - Инструмент
get_company_certificatesЧто вернётСертификаты и декларацииДоступКлюч, запросы API - Инструмент
get_company_registriesЧто вернётОтраслевые реестрыДоступКлюч, запросы API - Инструмент
get_accountЧто вернётБаланс и ценыДоступКлюч
Перед платным вызовом ассистент может спросить вашего подтверждения.
Claude в браузере и приложении
Откройте Settings → Connectors → Add custom connector, вставьте адрес MCP-сервера и сохраните. Так подключаются бесплатные инструменты: поиск и основные сведения.
Claude Desktop с ключом
Добавьте сервер в файл claude_desktop_config.json и перезапустите приложение. Нужен установленный Node.js.
{
"mcpServers": {
"clickfile": {
"command": "npx",
"args": [
"mcp-remote",
"https://clickfile.ru/api/mcp",
"--header",
"Authorization:${CLICKFILE_AUTH}"
],
"env": {
"CLICKFILE_AUTH": "Bearer ВАШ_КЛЮЧ"
}
}
}
}Claude Code
claude mcp add --transport http clickfile https://clickfile.ru/api/mcp \
--header "Authorization: Bearer ВАШ_КЛЮЧ"Cursor
Добавьте сервер в ~/.cursor/mcp.json или в .cursor/mcp.json проекта.
{
"mcpServers": {
"clickfile": {
"url": "https://clickfile.ru/api/mcp",
"headers": {
"Authorization": "Bearer ВАШ_КЛЮЧ"
}
}
}
}VS Code
Создайте в проекте файл .vscode/mcp.json. При первом запуске сервера VS Code спросит ключ и сохранит его в защищённом хранилище, в файле ключа не будет.
{
"inputs": [
{
"type": "promptString",
"id": "clickfile-key",
"description": "Ключ API ClickFile",
"password": true
}
],
"servers": {
"clickfile": {
"type": "http",
"url": "https://clickfile.ru/api/mcp",
"headers": {
"Authorization": "Bearer ${input:clickfile-key}"
}
}
}
}Яндекс AI Studio
- В AI Studio откройте Agent Atelier → MCP-серверы и нажмите «Создать MCP-сервер».
- Выберите «Внешний MCP-сервер», задайте имя, например
clickfile, и нажмите «Создать». - Вставьте адрес MCP-сервера и выберите транспорт Streamable HTTP.
- Для платных инструментов выберите тип авторизации «Токен доступа» и добавьте заголовок
Authorizationсо значениемBearer ВАШ_КЛЮЧ. Для бесплатных достаточно «Без авторизации». - Нажмите «Подключиться», отметьте нужные инструменты и сохраните.
- Подключите сервер к своему агенту в AI Studio — агент начнёт пользоваться инструментами ClickFile.
URL: https://clickfile.ru/api/mcp
Транспорт: Streamable HTTP
Заголовок: Authorization: Bearer ВАШ_КЛЮЧChatGPT
ChatGPT подключает свои MCP-серверы как коннекторы. Добавьте адрес MCP-сервера без авторизации — ассистенту станут доступны поиск и основные сведения. Передавать ключ в заголовке ChatGPT не умеет, поэтому платные инструменты в нём не работают.
GigaChat
С GigaChat инструменты ClickFile подключаются в коде, через LangChain. Установите пакеты langchain, langchain-gigachat и langchain-mcp-adapters, а ключ авторизации GigaChat задайте в переменной GIGACHAT_CREDENTIALS.
import asyncio
from langchain.agents import create_agent
from langchain_gigachat import GigaChat
from langchain_mcp_adapters.client import MultiServerMCPClient
async def main():
client = MultiServerMCPClient({
"clickfile": {
"transport": "streamable_http",
"url": "https://clickfile.ru/api/mcp",
"headers": {"Authorization": "Bearer ВАШ_КЛЮЧ"},
}
})
tools = await client.get_tools()
agent = create_agent(GigaChat(model="GigaChat-2-Max"), tools)
result = await agent.ainvoke({"messages": "Проверь компанию с ИНН 7707083893"})
print(result["messages"][-1].content)
asyncio.run(main())Другие клиенты
Подойдёт любой клиент с транспортом Streamable HTTP. Ключ передавайте в заголовке, не в адресе.
URL: https://clickfile.ru/api/mcp
Транспорт: Streamable HTTP
Заголовок: Authorization: Bearer ВАШ_КЛЮЧ