inn-check-ru

io.github.ilyautovPublished by GitHub account ilyautovv1.12.3Updated Oct 25, 2026

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

The publisher's own server: check.tattoo: tattoo size and placement guide

Overview

AI-generated overview

Checks Russian counterparties by INN: gathers registry, finance and sanctions data and returns a risk traffic light with sources and gaps.

What you can do
Build a counterparty dossier by INN: status, owners, management, revenue, debts, bankruptcy signs and related firms, with each source marked as found, empty or unverified and numbers computed by code rather than the model. Run a quick risk check with a traffic light and stop signals, or a full due-diligence dossier in Markdown or DOCX. Map ownership and affiliation links and check signs of business splitting. Batch-check a list of counterparties, monitor changes between saved snapshots, and produce a retro verdict from an earlier snapshot. Extract INNs from invoices, contracts, letters or CSV, and assemble an evidence pack with raw responses and hashes.
When to use it
Use it when an assistant needs to vet a Russian company or sole trader before a deal, deferred payment, tender or onboarding, or to monitor a counterparty over time. It suits agents that need registry facts with explicit gaps rather than a single aggregated score.
Requirements
Runs locally as a Python package via uvx (or as a Claude Desktop bundle, plugin or skill). Network access to Russian public registries is needed; some sources are geo-blocked and may require your own proxy with a Russian IP via INN_CHECK_PROXY. Optional CHECKO_API_KEY enables the affiliation graph; courts, bailiffs and bankruptcy sources open in a browser for manual captcha entry.
Before you install
The checked INN is sent to many public registries, and to api.checko.ru and suggestions.dadata.ru if those keys are set; a configured proxy sees which INNs you check. CHECKO_API_KEY and INN_CHECK_PROXY are secrets stored in configuration. Results are an assessment from open data, not a legal or credit guarantee, and unverified sources are flagged rather than treated as clean.

Installation

In SourceWeft

  1. Open inn-check-ru in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

🇬🇧 English version

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

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

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

[inn-check-ru: сбор данных о компании по ИНН для AI-агента]

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

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

bash
npx skills add ilyautov/inn-check-ru

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

text
Собери досье компании по ИНН 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 (плагин)

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

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

bash
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.

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

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

text
собери досье компании по ИНН 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, Яндекс Маркет, Авито из агента). Пригодилось — поставьте звезду.

Source: README.md at commit 940e9dc

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

5
  1. v1.12.3LatestSep 30, 2026
  2. v1.12.2Sep 26, 2026
  3. v1.12.1Sep 26, 2026
  4. v1.12.0Sep 24, 2026
  5. v1.11.1Sep 23, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Check integrations