KontragentPro

KontragentPro MCP 服务

可直接从 Claude Desktop、Cursor 和任何兼容 MCP 的客户端按 INN（税号）查询俄罗斯公司。这是对公开 KontragentPro API v2 的轻量封装，提供来自 俄罗斯开放登记册的数据：EGRUL（公司登记册）、联邦税务局财务报表、 破产登记册、国家检查、商标、制裁名单和外国代理人名单。

无需 API 密钥——默认启用匿名免费套餐，不到一分钟即可开始尝试。

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

工具

工具	功能
search_companies	按年度收入（联邦税务局开放数据）、地区、行业代码、员工人数和破产状态筛选法人实体
get_company	一次调用即可通过 INN 获取完整公司档案
get_company_financials	获取官方税务申报中的多年财务历史
get_company_timeline	事件动态：破产、检查、商标、官方公报
check_account	余额、套餐和每日配额（需要 API 密钥）

安装

使用 uv 运行，无需安装：

uvx kontragentpro-mcp

或使用 pip：

pip install kontragentpro-mcp
kontragentpro-mcp

Claude Desktop

打开 Settings → Developer → Edit Config，并将以下内容添加到 mcpServers：

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

重启 Claude Desktop，工具便会显示在列表中。若要提高速率限制， 请添加 "env": {"KONTRAGENTPRO_API_KEY": "your_key"}。

Cursor

Settings → MCP → Add new server，类型选择 command：

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

示例

“查询 INN 为 7736207543 的公司，并显示其过去 5 年的收入”

客户端会调用 get_company 和 get_company_financials，返回公司 档案和财务数据序列。

环境变量

变量	默认值	用途
KONTRAGENTPRO_API_KEY	—	账户的 Bearer 密钥（可选）
KONTRAGENTPRO_API_BASE	https://kontragentpro.ru/api/v2	API 基础 URL
KONTRAGENTPRO_TIMEOUT	30	HTTP 超时时间，单位为秒

可在 https://kontragentpro.ru/developers 获取免费密钥。

数据来源

所有数据均来自俄罗斯官方开放登记册——EGRUL/EGRIP、联邦税务局（财务报表、税制）、联邦 破产登记册、总检察长办公室检查登记册、Rospatent 商标以及公开的 制裁名单。公司档案中的每个数据区块都标注了来源和获取日期。

---

По-русски

Проверка российских контрагентов по ИНН прямо в 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	Баланс депозита, план, дневная квота (нужен ключ)

Установка

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.