inn-check-ru

Проверка контрагента РФ по ИНН: светофор риска по реестрам, финансы и санкции кодом.

OtherPythonv1.12.3

inn-check-ru: инструменты агента для поиска информации о компании по ИНН

🇬🇧 English version

Скилл, MCP-сервер и CLI для Claude, Codex и других агентов. Даёте ИНН, и агент сам обходит ЕГРЮЛ, «Прозрачный бизнес», бухотчётность ГИР БО, Федресурс, реестры ЦБ, санкционные списки и ещё полтора десятка реестров. На выходе досье: жива ли компания, кто владеет и руководит, выручка и долги, признаки банкротства, связанные фирмы. Суды, ФССП и ЕФРСБ закрыты капчей: их агент открывает в браузере, а капчу проходите вы.

В чём фишка: цифры считает код, а не модель. У каждого реестра в ответе видно, что он сказал: нашёл, пусто или проверить не удалось. «Ничего не нашёл» и «не смог проверить» не смешиваются, поэтому капча или упавший сайт не превращаются в «компания чистая».

License: Apache 2.0 Версия Stars skills.sh

Сайт: inn-check-ru.aifrontier.tech · разборы: проверка по ИНН, ИП, однодневки, дробление, мониторинг

Быстрый старт

npx skills add ilyautov/inn-check-ru

И скажите агенту:

Собери досье компании по ИНН 7707083893.
Покажи статус, финансы, долги, суды, владельцев и связи.
Укажи источники, даты и что не удалось проверить.

Три основных задачи: нейтральное досье, связи компании, изменения между сохранёнными снимками. Оценка сделки (светофор 🟢/🟡/🔴) — отдельный режим: назовите цель, например «перед отсрочкой».

Зачем

Банкротство, дисквалификация директора, ликвидация — обычно всё это открыто в ЕГРЮЛ, ФССП, картотеке арбитража и ЕФРСБ ещё до сделки. Но в одну картину это никто не сводит.

Агрегаторам одним верить нельзя. Живой тест 15.06.2026: одна компания, 5 бесплатных агрегаторов, число судебных дел — ~500 / ~1000 / ~1500. Один ещё и подмешал чужие банкротные «намерения». Поэтому здесь факт — это совпадение ≥3 источников, а расхождение — флаг.

Как это работает

Три состояния вместо «чисто». У каждого источника в ответе одно из трёх:

СостояниеЗначит
okответил, поля совпали с контрактом
пустоответил, записи по ИНН нет — это факт
не провереносеть, гео, капча, изменилась схема, не покрыто скриптом

Сломанный парсер даёт «не проверено», а не «чисто». Если не проверено больше половины стоп-источников, 🟢 не выдаётся.

Две скорости. Быстрая фаза за 2–4 секунды: ЕГРЮЛ, риск-флаги ФНС, дисквалифицированные, санкции. Стоп-сигнал (ликвидация, банкротство, недостоверность, дисквалификация, долги больше сделки) → 🔴, досье дальше не собирается. Режимы: --режим quick|полный|всё.

Источники по каскаду: бесплатные скрипты ФНС без ключей (ЕГРЮЛ, Прозрачный бизнес, ГИР БО, МСП, НПД, ЕРКНМ/РНП, список ЦБ, спецреестры) → ФССП и суды через браузер или агрегаторы → ручной ввод.

Числа считает код, не модель:

ЧтоСкрипт
Финансы из ГИР БО: чистые активы, ликвидность, транзитный профильfin_scoring.py
Санкции офлайн: Росфинмониторинг, OFAC SDN, EUsanctions_check.py
Цель проверки задаёт вес фактов: 11 профилей (нейтрально, отсрочка, предоплата, тендер…)profiles.py
ИП по 12-значному ИНН: ЕГРИП, НПД, МСП, два поиска ФССПавтоматически
Граф связей глубины 2, признаки дробления по методике ФНСaffiliates_graph.py, droblenie_check.py
Перцентиль в отрасли: ОКВЭД × регион × размер, 5480 группbenchmarks.py
Поиск по ИНН в дампах ФНС: численность, спецрежим, налоги, недоимкаopendata_index.py
Признаки «бумажного» НДС — фактами, без налоговых заключенийpaper_vat.py
Батч по базе контрагентов, опасное наверх, --продолжить после обрываbatch_check.py
Мониторинг: снимки, дифф, строки для cron/launchdwatchlist.py, diff_counterparty.py
Обновление локальных индексов раз в месяц: что и через какую сеть — в вашем конфиге, расписание не ставится самоrefresh_indexes.py
Светофор на дату в прошлом — только по снимку, сохранённому тогдаretro_verdict.py
Досье осмотрительности в Markdown или DOCXdossier.py
Пакет доказательств: сырые ответы, SHA-256, штамп времени RFC 3161--пакет, evidence_pack.py
ИНН из счёта, договора, письма, CSVextract_inn.py
Лицензии Росздравнадзора: аптеки, наркотики, медизделия — действует / приостановлена / прекращенаrzn_licenses.py
Дисквалифицированные руководители — офлайн по выгрузке ФНС, плюс история компанииdisq_dump.py
Товарные знаки компании по ИНН правообладателя — сколько и какие действуютrospatent_tz.py
Таможенный представитель, перевозчик, владелец СВХ или таможенного склада (ФТС)fts_registries.py
Лицензии связи и реестр организаторов распространения информации (РКН)rkn_registries.py
Лицензии на алкоголь: действует, приостановлена, аннулирована (РАР)rar_licenses.py
Сертификаты и декларации о соответствии за последний год: заявитель или изготовитель, действует / прекращён / недействителен (Росаккредитация)fsa_registries.py
Уведомление Роскомнадзору об обработке персональных данных: номер в реестре операторов и датыfetch_counterparty.py
Лицензия Минпромторга на производство лекарств (действует / приостановлена); производитель и заключения о российском производстве по ПП 719 со срокамиminpromtorg.py
Аккредитованный удостоверяющий центр (Минцифры): действует или аккредитация прекращена, история приостановокuc_mintsifry.py
Проверки и профилактика по 248-ФЗ за последний год: плановые и внеплановые, объявленные предостережения, контрольный орган (ЕРКНМ)erknm.py
Лицензия МЧС на монтаж и обслуживание средств пожарной безопасности или на тушение пожаров: действует или прекращена, вид работ, орган, приказfetch_counterparty.py
Реестр недобросовестных поставщиков: действующие и исключённые записи, ИНН среди учредителей чужих записей (ЕИС)fetch_counterparty.py
МФО, кооперативы, ломбарды, брокеры и другие профучастники, инвестсоветники, БКИ, СРО в реестрах ЦБ — действует или исключена и когда; аннулированные лицензии с причинойcbr_registries.py
Залоги движимого имущества: вставленный текст страницы reestr-zalogov.ru → число уведомлений, даты, банки-залогодержателиpledge_text.py

Подробности, границы и допущения каждого — в SKILL.md, references/ и KNOWN_LIMITS.md.

Сеть. check_access.py за 10 секунд показывает, что доступно из вашей сети. Недоступное сразу помечается «не проверено». TLS для fedsfm.ru и rosstat.gov.ru чинит install_ca.py: корень УЦ Минцифры с проверкой отпечатков, верификация не отключается. Гео-блок обходится только своей нодой с российским IP (--прокси или INN_CHECK_PROXY): общего пула у проекта нет и не будет.

Кто видит ИНН. Провайдер модели — он в переписке. Каждый источник — свой запрос. Санкционные перечни, выгрузки ЦБ и дампы ФНС скачиваются целиком и сверяются локально. --офлайн не выходит в сеть вовсе. Телеметрии нет.

Установка

Где работаетеКак поставитьЧто получите
Claude Code, Coworkплагин (ниже)скилл + MCP, обновления через маркетплейс
Claude Desktopinn-check-ru.mcpbMCP, Python не нужен
Claude.ai (веб)ZIP скилласкилл
Cursor, Codex, другие MCP-клиентыuvx inn-check-ru-mcp@latestMCP, конфиги
Любой агент со скилламиnpx skills add ilyautov/inn-check-ruскилл
Терминалuvx inn-check-ru <ИНН>CLI
Chrome, Brave, Edgeextension/проверка ИНН со страницы, ручные блоки ФССП и судов

Claude Code и Cowork (плагин)

/plugin marketplace add ilyautov/inn-check-ru
/plugin install inn-check-ru@inn-check-ru

Сторонний маркетплейс сам не обновляется:

claude plugin marketplace update inn-check-ru && claude plugin update inn-check-ru@inn-check-ru

Claude Desktop (расширение .mcpb)

Скачать inn-check-ru.mcpb, открыть, «Установить». Движок поставится через uv. Два необязательных поля — ключ checko.ru (граф связей) и свой прокси — хранятся в защищённом хранилище системы. Ставится только MCP; скилл — плагином или ZIP.

Claude.ai (веб)

Скачать ZIP → Settings → Capabilities → Skills → Upload skill. Собрать самому: python3 scripts/build_release_zip.py.

Вручную (Copilot, Cline, Roo Code, Goose, OpenCode)

Скопируйте SKILL.md, references/ и scripts/ в каталог скиллов агента (например .agents/skills/inn-check-ru/). Без references/ агент молча теряет ветку ИП, мониторинг и батч.

Браузерное расширение

Распакованное extension/ + python3 scripts/install_native_host.py --id <ID>. macOS, Linux, Windows. Подробно — extension/README.md.

Использование

Обычными словами:

собери досье компании по ИНН 7707083893
с кем связана эта компания
что изменилось у контрагента с прошлой проверки
проверь поставщика по ИНН перед отсрочкой 30 дней

Слэш-команды плагина в Claude Code (профиль — вторым аргументом):

КомандаЧто делает
/inn-check <ИНН> [профиль]быстрая проверка и светофор
/inn-dossier <ИНН> [профиль]полное досье осмотрительности
/inn-batch <файл или ИНН…>список, опасное наверх
/inn-watch [добавить/убрать/список/прогон]мониторинг изменений
/inn-retro <ИНН> <ГГГГ-ММ-ДД>светофор по снимку прошлой даты
/inn-links <ИНН>связи и признаки дробления (ключ Checko)
/inn-vat <ИНН> [предмет] [сумма]признаки «бумажного» НДС
/inn-self <ИНН>как вас видят банк и покупатель

Два интерфейса, один движок (scripts/, чистый stdlib): скилл (SKILL.md + references/) — для разговора с агентом; MCP-сервер (mcp/) — 14 read-only инструментов для цепочек. Например: счёт из diadoc-mcp-ru → counterparty_fetch до подписи.

Чем отличается от Контур.Фокуса и Checko

Не замена, а другая задача:

  • сводит несколько источников и показывает расхождения вместо одной цифры;
  • живёт внутри вашего агента, рядом с остальной работой;
  • открытый код: пороги видны и настраиваются.

Чем не является: это оценка по открытым данным, а не юридическая или кредитная гарантия. Для крупной сделки — рабочий лист для юриста. Чего не умеет — KNOWN_LIMITS.md.

Частые вопросы

Без API-ключей работает? Базовый контур — да: ЕГРЮЛ, риск-флаги ФНС, финансы, МСП, НПД. Граф связей — бесплатный ключ checko или браузер. Суды, ФССП, банкротство ИП — через браузер.

Как проверить ИП? Так же, по 12-значному ИНН. Выручки и налогового долга ИП в открытых данных нет — по закону.

Как проверить подписанта по доверенности? Номер машиночитаемой доверенности — в реестре ФНС m4d.nalog.gov.ru. Отозванная доверенность обесценивает подпись.

Куда уходят данные

Серверов и телеметрии у проекта нет. Наружу уходит только проверяемый ИНН — в открытые реестры: сайты ФНС (egrul, pb, bo, rmsp, service, npd), zakupki.gov.ru, pd.rkn.gov.ru, digital.mchs.gov.ru, websbor.rosstat.gov.ru, bankrot.fedresurs.ru и fedresurs.ru, clearspending.ru, reestr.nostroy.ru и reestr.nopriz.ru. Если вы сами задали ключ — ещё api.checko.ru и suggestions.dadata.ru. Санкционные списки и открытые данные скачиваются целиком и сверяются на вашей машине, кэш и снимки лежат в ~/.cache/inn-check-ru/. Если включён свой прокси, он видит, какие ИНН вы проверяете. Подробно — PRIVACY_POLICY.md.

Вклад и безопасность

CONTRIBUTING.md — баги, расхождения с реестрами, новые источники. SECURITY.md — модель угроз и как сообщить об уязвимости.

Лицензия

Apache-2.0 (LICENSE). Выделено из small-business-ru.

Кто это сделал

Илья Утов, лаборатория AI Frontier. Как устроены эти инструменты — в Telegram.

Рядом: small-business-ru (34 скилла для МСБ) · humanizer-ru (очеловечить русский AI-текст) · marketplaces-mcp-ru (WB, Ozon, Яндекс Маркет, Авито из агента). Пригодилось — поставьте звезду.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx inn-check-ru-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-ilyautov-inn-check-ru": {
      "command": "uvx",
      "args": [
        "inn-check-ru-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

inn-check-ru-mcppypi

Compatible MCP Clients

inn-check-ru works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More