counterparty-guard

Files (2)

• SKILL.md
• fetch_counterparty.py · scripts/

SKILL.md (first lines)

# Counterparty Guard — проверка контрагента по ИНН

> ⚠️ **Каноническая версия переехала в отдельный репозиторий [inn-check-ru](https://github.com/ilyautov/inn-check-ru).** Эта копия в паке заморожена на v0.3.1 и не обновляется; новые правки идут в inn-check-ru, который подключён к этому маркетплейсу как внешний плагин (см. `.claude-plugin/marketplace.json`).

> Помогает оценить риск работы с контрагентом по открытым данным. Не является юридической или кредитной гарантией. Финальное решение — за собственником.

Отгрузить в долг, внести предоплату, подписать договор на год — и через месяц узнать, что контрагент в банкротстве, а директор дисквалифицирован. Самое обидное: всё это было открыто **ещё до сделки** — в ЕГРЮЛ, ФССП, картотеке арбитража, ЕФРСБ. Просто никто не свёл это в одну картину за те пять минут, что есть у собственника. Скилл сводит — по одному ИНН, до сделки, в **светофор 🟢/🟡/🔴** с рекомендацией («отсрочка / только предоплата / избегать») и списком того, что мониторить дальше.

> **Почему круговая сверка, а не один агрегатор (живой тест 15.06.2026).** Прогнали одну компанию через 5 бесплатных агрегаторов. Число судов разошлось почти втрое: у одного примерно ~500, у другого ~1000, у третьего ~1500 (разная методология подсчёта дел/эпизодов), а один вдобавок подмешал чужие банкротные «намерения». Зато выручка и число исполнительных производств совпали у всех. Отсюда главный принцип скилла: **одиночному агрегатору верить нельзя — счётчики врут уверенно. Факт = то, что совпало у ≥3 источников; расхождение = флаг, а не повод выбрать одну цифру.** (Цифры намеренно округлены; проверяйте на своих контрагентах сами.)

**Принцип (POV).** Риск контрагента — это не «есть компромат / нет компромата», а **сведение противоречивых открытых сигналов в одно датированное решение**. Деньги реальные, поэтому: считаем кодом, датируем каждый сигнал, светофор двигаем только вверх по тревожности (вниз — лишь при опровержении сигнала, не «потому что хочется сделки»), одиночному источнику не верим. Скилл не выносит приговор компании — показывает риск собственнику и оставляет решение ему.

Цель: по ИНН собрать открытые данные и выдать **светофор риска** с понятной рекомендацией — работать ли с контрагентом и на каких условиях (предоплата / отсрочка / избегать). Работает в два захода: быстрый quick-scan по deal-killer-сигналам, затем полное досье по запросу.

## Принципы

1. **Zero-prompt.** Нужен только ИНН (или название). Остальное собираем сами.
2. **Двухскоростной режим.** Сначала quick-scan (минуты, deal-killer-сигналы → 🟢/🟡/🔴), потом полное досье — только если quick-scan не 🔴 и пользователю нужны детали. Не гнать полный сбор, когда контрагент уже отсеян на quick-scan.
3. **Светофор, а не простыня.** Владельцу — 🟢/🟡/🔴 + 1-2 фразы почему + что делать. Детали — ниже, по запросу «разверни».
4. **Каскад транспортов по дешевизне.** Каждый сигнал берём самым дешёвым доступным способом (скрипт → токен-API → браузер → manual).
5. **Grounding и датировка.** Каждый сигнал с источником и датой. Чего не достали — честно «не проверено», не выдумываем.
6. **Numerical-manifest.** Каждая цифра в досье (выручка, долги, число судов, суммы исков) идёт с источником + датой + tier-маркером. Число без происхождения не выдаётся — оно либо трассируется к источнику, либо помечается «не подтверждено». Это лечит ложную точность агрегаторов.
7. **Manual as truth.** Если источник недоступен или пользователь сам приносит данные (выписку, факт) — принимаем как вход, но помечаем «со слов пользователя, не верифицировано».
8. **Проактивность.** При появлении нового крупного контрагента (в счёте, в CRM) — сам предложи проверку.

## Источники и транспорт (каскад)

**ОСНОВНОЙ ПУТЬ — бесплатный агрегатор через браузер (без капчи, всё в одном).**
Проверено вживую 15.06.2026 на РФ-IP: `checko.ru` (поиск по ИНН → карточка
`checko.ru/company/...`) одним запросом отдаёт ВЕСЬ профиль без капчи и без
регистрации: реквизиты, статус, финотчётность за все годы, налоговый режим и
задолженность, оценку надёжности (риск номинальности / финрисков), арбитраж
(истец/ответчик, суммы), ФССП (исполнительные производства), банкротства (ЕФРСБ),
блокировки счетов, санкции, госзакупки + РНП, проверки/КНМ, связи (дочерние,
право-преемники), лицензии, товарные знаки, историю изменений. Аналоги: rusprofile.ru,
list-org.com, zachestnyibiznes.ru. У checko есть и собственный API (данные ФНС/Росстата/
ФССП/ФАС/Генпрокуратуры) для автоматизации без браузера.

**МУЛЬТИ-АГРЕГАТОР + КРОСС-СВЕРКА (обязательно ≥2 источника).** Один агрегатор —
единая точка отказа и риск ложной точности. Проверено вживую 15.06.2026: checko и
list-org по одной компании дали РАЗНЫЕ цифры (арбитраж ~500 vs ~1500 — разная методология
подсчёта), и у каждого свой профиль:
**Пул из 5 агрегаторов (все проверены вживую 15.06.2026 на РФ-IP, без капчи, без регистрации).**
Бери 3-4 из пула на каждую проверку, сверяй между собой:

| Агрегатор | Доступ | Силён в | Особенности / риски |
|---|---|---|---|
| **checko.ru** | поиск → `/company/{slug}-{ОГРН}` | скоринг надёжности, факторы риска, санкции, удобная сводка | чище от шума, есть свой API |
| **list-org.com** | `/search?val={ИНН}` → `/company/{id}` | полный баланс построчно, численность, реестр операторов ПДн, Вестник, сертификаты ФСА | сырее; ПОДМЕШИВАЕТ чужие банкротные «намерения» — проверяй принадлежность ИНН |
| **saby.ru (СБИС)** | прямой `/profile/{ИНН}-{КПП}` | торги, суды, стоимость бизнеса, надёжность, отчётность с 2004 | часть данных за пейволлом (маскировка XXX) |
| **audit-it.ru** | `/buh_otchet/{ИНН}_{slug}` | глубокий финанализ: коэффициенты (автономия, ликвидность, ROE/ROA, EBIT), аудиторское заключение | ОТСТАЁТ ПО ГОДАМ (давал 2023, когда другие 2024) — проверяй свежесть |
| **rusprofile.ru** | поиск по ИНН → `/id/{внутр}` | реестры ФНС наглядно, надёжность, банкротство, санкции | часть за проф-доступом |

**Круговая сверка (проверено): суды дали 4 РАЗНЫЕ цифры** — примерно ~500 / ~1000 / ~1500 у разных агрегаторов (разная методология подсчёта дел/эпизодов). А ФССП и выручка совпали у всех → надёжный сигнал.

**Сведение и оценка уверенности — через движок `cross-source-verify`.** Не дублируй здесь логику дедупликации/конфликтов/tier — это последняя миля любой проверки, она вынесена в отдельный скилл. counterparty-guard собирает сырые результаты из агрегаторов, `cross-source-verify` сводит их в один ответ (свежесть × авторитет × согласие, расхождения показывает явно). Краткое правило для быстрой ориентации: ≥3 источника; совпало → 🟢 высокая уверенность; разошлось (счётчики, оценки) → флаг «расхождение, уточнить», не выдавай одну цифру за факт; разная свежесть → бери самый свежий год (audit-it отстаёт); одиночный тревожный сигнал (банкротство у list-org) → проверь принадлежность ИНН перед тем как пугать.

Транспорт основного пути: открыть карточку в браузере (Claude-in-Chrome, на РФ-IP) →
`get_page_text` → распарсить в светофор. Госисточники ниже — РЕЗЕРВ/добивка.

**ПРАВИЛО ПРО КАПЧУ (важно):** капчи не автоматизируем и пользователя капчей не
дёргаем. `pb.nalog.ru` (Прозрачный бизнес) требует капчу на каждый поиск — это только
ручная опция «если пользователь сам хочет официальную сверку», не основной флоу.

| Слой | Сигналы | Транспорт | Доступ |
|---|---|---|---|
| 🟢 Базовый | реквизиты, директор, статус, дата рег., ОКВЭД, капитал | скрипт ЕГРЮЛ ФНС / DaData free | без ключа |
| 🟢 Риск-флаги ФНС | налоговая задолженность, дисквалификация, массовый адрес/директор, недостоверность сведений, численность, спецрежим | скрипт «Прозрачный бизнес» (pb.nalog.ru) | без ключа |
| 🟢 Финансы | выручка, прибыль, активы, динамика по годам | скрипт ГИР БО (bo.nalog.gov.ru) | без ключа |
| 🟡 Долги | исполнительные производства ФССП | токен-API (api-ip.fssp.gov.ru) | бесплатный токен |
| 🔴 Суды | арбитражные дела (истец/ответчик, суммы) | браузер (Claude-in-Chrome) или агрегатор ofdata | браузер/платно |
| 🔴 Банкротства | банкротство, намерения кредиторов | браузер / агрегатор | браузер/платно |
| 🟡 Госзакупки | РНП, исполнение/расторжения контрактов | zakupki OpenData | без ключа |
| ⚪ Что недоступно | — | manual: пользователь вводит как истину | — |

Скрипт зелёной зоны: `scripts/fetch_counterparty.py <ИНН>` → JSON по трём источникам ФНС (см. reference). Транспортные грабли: kad.arbitr за DDoS-Guard (голый скрипт = 451, нужен браузер); ФССП агрессивно лимитит (вежливые задержки, токен); эндпоинты ФНС недокументированы (могут смениться).

## Режимы и рабочий процесс

Три режима, одна логика: **quick-scan** (минуты, только deal-killer-сигналы) → **полное досье** (по запросу, каскад источников + круговая сверка) → **мониторинг** (leading indicators перед каждой крупной отгрузкой). Quick-scan — всегда первым: он отсевает ~70% и экономит сбор.

### Шаг 1 — Получить ИНН
Спроси ИНН (или название → резолв в ИНН через ЕГРЮЛ/DaData). Подтверди, что нашли именно ту компанию (название + адрес).

### Шаг 2 — QUICK-SCAN (всегда первым, минуты)
Быстрый проход только по **deal-killer-сигналам** — тем, что одни делают сделку опасной независимо от остального. Один агрегатор-карточка (checko) обычно показывает их сразу:
- в процессе **ликвидации / реорганизации**;
- **банкротство** (введена процедура, заявления кредиторов);
- **недостоверность сведений** в ЕГРЮЛ (адрес/директор/учредитель);
- **дисквалификация** директора;
- крупные **иски-долги / исполнительные производства** на суммы, сопоставимые с активами или с суммой сделки.

Выдай предварительный светофор:
- найден хоть один deal-killer → 🔴, **дальше можно не собирать** (предложи остановиться или развернуть подтверждение по конкретному сигналу);
- сигналов нет, но есть жёлтые флаги (молодая компания, массовый адрес, налоговый долг) → 🟡, предложи полное досье;
- чисто → 🟢 предварительно, полное досье по запросу.

Quick-scan экономит сбор: ~70% отсева происходит здесь. Числа на quick-scan тоже датируются и помечаются tier (см. numerical-manifest).

### Шаг 3 — Собрать зелёную зону (всегда, бесплатно)
Запусти `scripts/fetch_counterparty.py <ИНН>`. Получи: реквизиты, директора, статус (действующая/ликвидация), риск-флаги ФНС, финансы за последние годы.

### Шаг 4 — Полное досье: добрать по доступности (каскад)
Запускается, если quick-scan не дал 🔴 и нужны детали.
- ФССП (долги) — если есть токен.
- Суды/банкротства — если доступен браузер (Claude-in-Chrome) или агрегатор; иначе пометь «не проверено, проверьте вручную на kad.arbitr».
- Госзакупки/РНП — если релевантно.
- Сведение собранного из ≥3 источников → через `cross-source-verify`.

### Шаг 5 — Свести в светофор (severity-resolver, один раз)
Финальный уровень риска решается **один раз** и помечается, на каких сигналах он основан (severity-провенанс). Логика порогов (грубая, настраивается):
- 🔴 **Красный (избегать / только 100% предоплата):** в процессе ликвидации/банкротства; недостоверность сведений в ЕГРЮЛ; дисквалифицированный директор; крупные исполнительные производства; компания младше 6 мес. с массовым адресом и УК 10 000 ₽.
- 🟡 **Жёлтый (осторожно, предоплата / без отсрочки):** массовый адрес ИЛИ директор; налоговая задолженность; судебные иски как ответчик на крупные суммы; убыток/падение выручки; частые смены директора/адреса.
- 🟢 **Зелёный (можно работать, отсрочка допустима):** действующая >2 лет; чистые риск-флаги; положительная динамика; нет крупных судов/долгов.

Резолвер: модель уровня → пересчёт допустим **только вверх по тревожности или вниз при опровержении сигнала**, не «смягчить, потому что хочется сделки». Под итоговым светофором — строка «уровень поднят сигналами: {какие именно}».

### Шаг 6 — Выдать вывод

From ilyautov/small-business-ru, Apache-2.0.

More from ilyautov/small-business-ru