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 分