KontragentPro

io.github.kontragentpro由 GitHub 账号 kontragentpro 发布v0.2.2更新于 Oct 24, 2026

Russian company data by INN: registry, financials, bankruptcy, inspections, sanctions

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

按 INN 税号查询俄罗斯公司，返回登记卡片、多年财务数据、事件时间线和筛选后的公司列表。

可以做什么
按年收入、地区、行业代码、员工人数或破产状态筛选法人实体，并按 INN 一次获取完整公司卡片。获取来自官方税务申报的多年财务历史。读取涵盖破产、检查、商标和官方公报的事件流。配置 API 密钥后可查看账户余额、套餐和每日配额。
适用场景
适合在 Claude Desktop、Cursor 等 MCP 客户端中对俄罗斯交易对手做尽职调查、供应商或客户审核，以及快速核查公司财务与风险事件。
运行要求
以 Python 包形式通过 uvx 或 pip 在本地运行，需要访问 KontragentPro API 的网络连接。可选的 KONTRAGENTPRO_API_KEY 可提高速率限制并启用账户查询；不设置时使用匿名免费额度。另有可选的 KONTRAGENTPRO_API_BASE 和 KONTRAGENTPRO_TIMEOUT 设置。
安装前请注意
API 密钥是发送给第三方服务的持有者凭证，请勿放入共享配置。公司查询与结果会经过 KontragentPro API，数据来自俄罗斯公开登记库，重要结论应核对原始来源。该服务器为只读，不会修改数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 KontragentPro，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

KontragentPro MCP server

[PyPI] [Python] [License: MIT]

Look up Russian companies by INN (tax ID) directly from Claude Desktop, Cursor and any MCP-compatible client. A thin wrapper over the public KontragentPro API v2, serving data from Russian open registries: EGRUL (company registry), Federal Tax Service financial statements, bankruptcy register, state inspections, trademarks, sanctions and foreign-agent lists.

Works without an API key — anonymous free tier is enabled by default, so you can try it in under a minute.

Русское описание — ниже.

Tools

ToolWhat it does
search_companiesFilter legal entities by annual income (FNS open data), region, industry code, headcount, bankruptcy status
get_companyFull company card by INN in a single call
get_company_financialsMulti-year financial history from official tax filings
get_company_timelineEvent feed: bankruptcies, inspections, trademarks, official gazette
check_accountBalance, plan and daily quota (requires API key)

Install

Run without installing, via uv:

bash
uvx kontragentpro-mcp

Or with pip:

bash
pip install kontragentpro-mcpkontragentpro-mcp

Claude Desktop

Open Settings → Developer → Edit Config and add to mcpServers:

json
{  "mcpServers": {    "kontragentpro": {      "command": "uvx",      "args": ["kontragentpro-mcp"]    }  }}

Restart Claude Desktop — the tools will appear in the list. To raise rate limits, add "env": {"KONTRAGENTPRO_API_KEY": "your_key"}.

Cursor

Settings → MCP → Add new server, type command:

json
{  "command": "uvx",  "args": ["kontragentpro-mcp"]}

Example

"Check the company with INN 7736207543 and show its revenue over the last 5 years"

The client calls get_company and get_company_financials, returning the company card and the financial series.

Environment variables

VariableDefaultPurpose
KONTRAGENTPRO_API_KEY—Bearer key from your account (optional)
KONTRAGENTPRO_API_BASEhttps://kontragentpro.ru/api/v2API base URL
KONTRAGENTPRO_TIMEOUT30HTTP timeout, seconds

Get a free key at https://kontragentpro.ru/developers.

Data sources

All data comes from official Russian open registries — EGRUL/EGRIP, the Federal Tax Service (financial statements, tax regimes), the federal bankruptcy register, the Prosecutor General's inspection registry, Rospatent trademarks, and public sanctions lists. Each block on a company card carries its source and retrieval date.

По-русски

Проверка российских контрагентов по ИНН прямо в Claude Desktop, Cursor и любом MCP-совместимом клиенте. Тонкая обёртка над публичным API KontragentPro v2 — данные из открытых реестров: ЕГРЮЛ, ФНС (ГИР БО и открытые данные), ЕФРСБ (банкротства), Генпрокуратура (проверки), Роспатент, реестры санкций и иноагентов.

Ключ необязателен: без него сервер работает в анонимном free-tier с пониженным лимитом запросов — попробовать можно сразу. Ключ для повышенных лимитов и check_account выдаётся в личном кабинете: https://kontragentpro.ru/developers

Инструменты

ИнструментЧто делает
search_companiesПодбор списка ЮЛ по фильтрам: годовой доход (открытые данные ФНС), регион, ОКВЭД, штат, статус банкротства
get_companyСводная карточка компании одним запросом по ИНН
get_company_financialsМноголетняя динамика из ГИР БО ФНС; при её отсутствии — годовой снимок открытых данных ФНС
get_company_timelineЛента событий: банкротства, проверки, иноагенты, ТЗ, Вестник
check_accountБаланс депозита, план, дневная квота (нужен ключ)

Установка

bash
uvx kontragentpro-mcp        # запуск без установкиpip install kontragentpro-mcp # либо через pip

Пример

«Проверь контрагента с ИНН 7736207543 и покажи динамику выручки за 5 лет»

Клиент вызовет get_company и get_company_financials, вернёт карточку и финансовый ряд.

Лицензия / License

MIT. Данные предоставляются «как есть» из открытых источников; сервис не является заменой официальной выписки.

MIT. Data is provided as-is from public sources and is not a substitute for an official registry extract.

来源：README.md，提交 90ad961

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分