inn-check-ru

# inn-check-ru: проверка контрагента по ИНН в AI-агенте

> 🇬🇧 [English version](README.en.md)

> **Не отгружай в долг вслепую.** Открытый AI-скилл, который по одному ИНН собирает открытые реестры (ЕГРЮЛ, ФССП, суды, банкротства, финансы) и выдаёт **светофор риска 🟢/🟡/🔴** с рекомендацией: отсрочка, только предоплата или избегать. Для Claude Code, Cursor, Codex, ChatGPT и Gemini. Бесплатно, Apache-2.0, данные — из настоящих реестров, а не из головы модели.

[![License: Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
[![Версия](https://img.shields.io/badge/версия-1.11.1-blueviolet)](CHANGELOG.md)
[![Stars](https://img.shields.io/github/stars/ilyautov/inn-check-ru?style=social)](https://github.com/ilyautov/inn-check-ru/stargazers)
[![skills.sh](https://skills.sh/b/ilyautov/inn-check-ru)](https://skills.sh/ilyautov/inn-check-ru/inn-check-ru)

<p align="center">
  <a href="https://inn-check-ru.aifrontier.tech/">
    <img src="assets/social-preview.png" alt="inn-check-ru: проверка контрагента по ИНН — светофор риска по реестрам ЕГРЮЛ, ФССП, судов, банкротств, санкции и граф связей, каждая цифра с источником и датой" width="720">
  </a>
</p>

📖 **Сайт проекта:** [inn-check-ru.aifrontier.tech](https://inn-check-ru.aifrontier.tech/) — разборы по кластерам: [проверка по ИНН](https://inn-check-ru.aifrontier.tech/proverit-kontragenta-po-inn.html), [ИП](https://inn-check-ru.aifrontier.tech/proverka-ip-po-inn.html), [однодневки](https://inn-check-ru.aifrontier.tech/priznaki-odnodnevki.html), [дробление](https://inn-check-ru.aifrontier.tech/droblenie-biznesa.html), [мониторинг](https://inn-check-ru.aifrontier.tech/monitoring-kontragentov.html).

```
🚦 ООО «Ромашка», ИНН 7700000000 — на 15.06.2026

🔴 Отсрочку не давать. Только 100% предоплата или отказ.

Почему: компания в стадии ликвидации; 4 исп. производства ФССП на 3,1 млн ₽ — больше суммы сделки.
Уровень поднят сигналами: ликвидация (ЕГРЮЛ) + ФССП 3,1 млн > сумма сделки 1,2 млн.
Рекомендация: избегать отсрочки; при острой нужде — только предоплата.
Вердикт сменится, если: ликвидация отменена И производства погашены (🔴→🟡).
Мониторить: банкротное заявление в ЕФРСБ.
Что проверено: ЕГРЮЛ ✅, ФССП ✅ (15.06.2026). Что НЕ проверено: суды (kad.arbitr — вручную).
```
*(Пример иллюстративный, данные условные. Так выглядит ответ за пару минут quick-scan.)*

**Быстрый старт** (Claude Code, Cursor, Codex и др.):

```bash
npx skills add ilyautov/inn-check-ru
```

Затем просто скажите агенту: **«проверь поставщика по ИНН 7700000000 перед предоплатой»**.

## Зачем это нужно

Каждый, кто торгует в долг или платит предоплату, знает эту историю: контрагент оказался в банкротстве, директор дисквалифицирован, а компания «в стадии ликвидации» уже полгода. Всё это было **открыто до сделки** — в ЕГРЮЛ, ФССП, картотеке арбитража, ЕФРСБ. Просто никто не свёл это в одну картину за те пять минут, что есть у собственника.

«Проверить контрагента по ИНН» — один из самых массовых деловых запросов в рунете. Сервисов много, но у них общая болезнь, которую мы измерили вживую:

> **Живой тест (15.06.2026).** Одна компания, 5 бесплатных агрегаторов. Число судебных дел разошлось почти втрое: примерно ~500 / ~1000 / ~1500 — у каждого своя методология подсчёта. Один агрегатор вдобавок подмешал чужие банкротные «намерения». Зато выручка и число исполнительных производств совпали у всех.

Отсюда главный принцип скилла: **одиночному агрегатору верить нельзя — счётчики врут уверенно. Факт — это то, что совпало у ≥3 источников; расхождение — флаг, а не повод выбрать самую красивую цифру.**

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

**Двухскоростная проверка.** Сначала quick-scan (пара минут): только deal-killer-сигналы — ликвидация, банкротство, недостоверность ЕГРЮЛ, дисквалификация директора, долги крупнее суммы сделки. Нашёлся хоть один — 🔴, дальше можно не собирать: ~70% отсева происходит здесь. Чисто — полное досье по каскаду источников.

**Источники — по каскаду дешевизны:** бесплатные скрипты ФНС (ЕГРЮЛ, Прозрачный бизнес, ГИР БО, ✅ Реестр МСП, НПД, ЕРКНМ/РНП, спецреестры — без ключей, `scripts/fetch_counterparty.py`) → ФССП и суды через браузер/агрегаторы (checko, list-org, СБИС, audit-it, rusprofile — все без капчи и регистрации; официальный API ФССП отключён с 2022) → ручной ввод как последняя опция.

**Быстро отсеивает и не тратит время зря.** Быстрая фаза (ЕГРЮЛ, риск-флаги ФНС, реестр дисквалифицированных, санкционные перечни) собирается параллельно за 2–4 секунды. Нашёлся deal-killer — досье не собирается вовсе: `--режим quick|полный|всё` и блок `_сбор` в выводе показывают, где проверка остановилась и почему. Режим `всё` отключает ранний выход для снимков мониторинга.

**Батч по базе контрагентов.** `scripts/batch_check.py контрагенты.csv --профиль отсрочка` — таблица со светофорами, наверху опасное и непроверенное, дубли схлопнуты, невалидные ИНН не потеряны, `--продолжить` переживает обрыв и перепроверяет только то, что не проверилось.

**Мониторинг с расписанием.** `scripts/watchlist.py --добавить <ИНН>`, `--прогон` по списку, `--только-изменения` для крона. Снимки хранятся отпечатками: поля диффа, состояния источников и хеш остального — в пять раз меньше и без лишних чужих персданных. `--установить-расписание` печатает готовые строки crontab и launchd, но ничего не ставит само.

**Три состояния вместо «чисто».** Каждый источник в выводе — `ok` (ответил, контракт полей совпал), `пусто` (ответил, записи по ИНН нет — это факт) или `не проверено` (сеть, гео, капча, схема изменилась, не покрыто скриптом). Парсеры проверяются против записанных ответов ФНС, а не угаданных имён полей (`eval/run_fetch_eval.py` + тест дрейфа схемы); канарейки — эталонные ИНН из реестра `scripts/sources.py` — отличают «данных нет» от «парсер сломан». Блок `_итог_проверки` считает долю непроверенных deal-killer-источников: больше половины — «проверка не состоялась», и 🟢 не выдаётся. Когда парсер ломается, продукт говорит «не проверено», а не «чисто».

**Сеть — параметр, а не стена.** `scripts/check_access.py` за десять секунд показывает, что доступно с вашей сети (доступен / tls / гео / dns / капча), кеширует результат на сутки, и движок сразу помечает заблокированное «не проверено», не съедая дедлайн. TLS-ошибки fedsfm.ru и rosstat.gov.ru лечит `scripts/install_ca.py` — корень УЦ Минцифры с проверкой отпечатков, верификация не отключается; гео-блок — РФ-IP: если у вас есть своя нода в России, `--прокси http://host:3128` (или `INN_CHECK_PROXY`, или `HTTPS_PROXY`) проводит через неё и сбор, и probe; блок `_сеть` в выводе говорит, через что шли, а probe-кэш, снятый из другой сети, не переиспользуется. Только СВОЯ нода: узел видит, какие ИНН вы проверяете, — общего пула у проекта нет и не будет (см. KNOWN_LIMITS.md). Добавить источник — одна запись в `sources.py`, одна функция и фикстура.

**Цель проверки задаёт вес фактов.** Одиннадцать профилей в `data/profiles_ru.json` (`нейтрально` по умолчанию, `отсрочка`, `предоплата`, `получаю_предоплату`, `подрядчик`, `тендер`, `цепочка_поставки`, `доля`, `клиент_115фз`, `самопроверка`, `ндс_вычет`): отрицательные чистые активы — стоп для отгрузки в долг и аргумент в торге при покупке доли. Светофор и рекомендацию считает `scripts/profiles.py` из собранного JSON, только вверх по тревожности; без названной цели — карточка фактов без вердикта. Там, где вердикт по одному ИНН был бы подменой (цепочка поставки — вопрос про 2-3 звена), профиль светофор не выдаёт намеренно. `fetch_counterparty.py <ИНН> --профиль отсрочка` собирает только то, что влияет на вердикт в этом профиле.

**ИП — отдельный светофор.** По 12-значному ИНН скилл сам переключается на контур ИП: статус в ЕГРИП, самозанятость (НПД), спецрежим и численность, МСП (исключение из реестра — стоп-сигнал), внесудебное банкротство физлиц, два поиска ФССП (по ИНН и по ФИО). Что закрыто законом (выручка, налоговый долг, адрес ИП) — честно «не проверено», а не правдоподобная выдумка.

**Финансовый профиль — кодом, а не из головы модели.** `scripts/fin_scoring.py` считает из строк отчётности ГИР БО: чистые активы два года подряд ниже нуля (ст. 30 ФЗ-14 — риск обязательной ликвидации, 🔴 deal-killer), автономию, ликвидность, падение выручки, транзитный профиль (рост >300% при нулевой численности). Каждый флаг трассируется к сырой строке баланса; где строки нет — честное «не проверено». Логика проверяется офлайн-eval'ом на синтетических фикстурах (`eval/run_fin_eval.py`).

**Санкционный контур — офлайн, три списка.** `scripts/sanctions_check.py` сверяет директора и компанию локально за секунды с перечнем Росфинмониторинга, OFAC SDN (США) и EU Consolidated list (ЕС) — каждый скачивается один раз в кэш и обновляется независимо. Совпадение в списках ЕС/США для экспортной сделки — отдельный риск вторичных санкций и валютных платежей. Плюс чеклист однодневки по методике ФНС из уже собранных сигналов (3+ признака → 🟡, 5+ → 🔴) и ранние сигналы ликвидации из Вестника госрегистрации и Федресурса — они попадают в ЕГРЮЛ с опозданием в недели.

**Мониторинг — механика, а не обещание.** `fetch_counterparty.py <ИНН> --save` сохраняет снимок проверки перед каждой крупной отгрузкой; `diff_counterparty.py <ИНН>` сравнивает два последних снимка и показывает, что изменилось: смена статуса на ликвидацию 🔴, новый директор 🟡, недостоверность сведений 🔴, ухудшение финансов по порогам скоринга — всё офлайн, с датами «было/стало», в JSON или светофорной карточкой (`--human`).

**Граф связей и признаки дробления — кодом.** `affiliates_graph.py <ИНН>` (бесплатный ключ checko) строит граф глубины 2 **ленивым обходом** — с бюджетом запросов, остановкой на первом значимом сигнале (ликвидация у связанной компании — это уже ответ) и на пересечении с уже проверенными (`--известные`): общие директора и учредители, соседи по адресу, правопреемство. Инструмент, выкачавший полсотни компаний на вопрос «кто за поставщиком», задаёт вопрос «зачем» — поэтому в выводе видно, сколько запросов потрачено и где обход остановлен, а неразвёрнутые связи идут в