inn-check-ru: инструменты агента для поиска информации о компании по ИНН
🇬🇧 English version
Скилл, MCP-сервер и CLI для Claude, Codex и других агентов. Даёте ИНН, и агент сам обходит ЕГРЮЛ, «Прозрачный бизнес», бухотчётность ГИР БО, Федресурс, реестры ЦБ, санкционные списки и ещё полтора десятка реестров. На выходе досье: жива ли компания, кто владеет и руководит, выручка и долги, признаки банкротства, связанные фирмы. Суды, ФССП и ЕФРСБ закрыты капчей: их агент открывает в браузере, а капчу проходите вы.
В чём фишка: цифры считает код, а не модель. У каждого реестра в ответе видно, что он сказал: нашёл, пусто или проверить не удалось. «Ничего не нашёл» и «не смог проверить» не смешиваются, поэтому капча или упавший сайт не превращаются в «компания чистая».
Сайт: 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, EU | sanctions_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/launchd | watchlist.py, diff_counterparty.py |
| Обновление локальных индексов раз в месяц: что и через какую сеть — в вашем конфиге, расписание не ставится само | refresh_indexes.py |
| Светофор на дату в прошлом — только по снимку, сохранённому тогда | retro_verdict.py |
| Досье осмотрительности в Markdown или DOCX | dossier.py |
| Пакет доказательств: сырые ответы, SHA-256, штамп времени RFC 3161 | --пакет, evidence_pack.py |
| ИНН из счёта, договора, письма, CSV | extract_inn.py |
| Лицензии Росздравнадзора: аптеки, наркотики, медизделия — действует / приостановлена / прекращена | rzn_licenses.py |
| Дисквалифицированные руководители — офлайн по выгрузке ФНС, плюс история компании | disq_dump.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 Desktop | inn-check-ru.mcpb | MCP, Python не нужен |
| Claude.ai (веб) | ZIP скилла | скилл |
| Cursor, Codex, другие MCP-клиенты | uvx inn-check-ru-mcp@latest | MCP, конфиги |
| Любой агент со скиллами | npx skills add ilyautov/inn-check-ru | скилл |
| Терминал | uvx inn-check-ru <ИНН> | CLI |
| Chrome, Brave, Edge | extension/ | проверка ИНН со страницы, ручные блоки ФССП и судов |
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, Яндекс Маркет, Авито из агента). Пригодилось — поставьте звезду.
