使用说明
bizmachine mcp
MCP服务器 BizMachine -捷克和斯洛伐克公司数据API。按名称、域名或ICO查找任何捷克或斯洛伐克公司的收入、员工、财务、联系人、风险信号、参与度得分、所有权、NACE分类等。
工具
搜索&核心
| 工具 | 说明 |
|---|---|
suggest |
按名称或域名搜索公司→ ICO |
company |
通过ICO获取完整的原始聚合数据 |
lookup |
智能查找：名称/域→ 最佳匹配→ 具有收入的结构化数据 |
bulk_lookup |
批量查找多家公司 |
公司简介和地区
下面的每个工具都接受 要么 一 ico 或 一 query （名称/域名，自动解析CZ→SK):
| 工具 | 说明 |
|---|---|
profile |
丰富的连接器样式配置文件：身份、地址、分类、大小、财务、分数、联系人、风险、信号计数——一次通话 |
contacts |
电话、电子邮件、网站、领英、脸书、推特 |
financials |
收入、增长、息税前利润、息税折旧摊销前利润、利润率、资产、注册资本、人员成本、出口商/进口商 |
risks |
风险信号（破产、清算、执行、欠税）+健康状况 |
metrics |
所有可用的BizMachine指标，已标准化 |
indicators |
最高加权驱动因素的参与度得分（活动、增长、可达性） |
nace |
NACE行业分类（初级+次级） |
owned_companies |
子公司/持有股份（所有权向下图） |
设置
1.获取API密钥
注册地址： bizmachine.com 并获取您的API密钥。
2.安装
git clone https://github.com/davidsimoes/bizmachine-mcp.git
cd bizmachine-mcp
npm install
3.配置克劳德代码
添加到您的 ~/.claude/settings.local.json:
{
"mcpServers": {
"bizmachine": {
"command": "node",
"args": ["/path/to/bizmachine-mcp/index.mjs"],
"env": {
"BIZMACHINE_API_KEY": "your_key"
}
}
}
}
用法
注册后，Claude会自动获得这些工具：
# Quick lookup by domain or name
mcp__bizmachine__lookup("mixit.cz")
mcp__bizmachine__lookup("Košík")
# Batch lookup
mcp__bizmachine__bulk_lookup(["alza.cz", "rohlik.cz", "mixit.cz"])
# Rich, connector-style profile (by name/domain or ICO)
mcp__bizmachine__profile({ query: "alza.cz" })
mcp__bizmachine__profile({ ico: "27082440" })
# Focused areas (each accepts ico OR query)
mcp__bizmachine__contacts({ query: "alza.cz" }) # incl. LinkedIn
mcp__bizmachine__financials({ ico: "27082440" })
mcp__bizmachine__risks({ query: "Sberbank" }) # liquidation, insolvency…
mcp__bizmachine__indicators({ query: "rohlik.cz" }) # engagement scores
mcp__bizmachine__nace({ ico: "24836451" })
mcp__bizmachine__owned_companies({ ico: "27082440" })
mcp__bizmachine__metrics({ query: "mixit.cz" })
# Raw search / full data
mcp__bizmachine__suggest("alza")
mcp__bizmachine__company("27082440")
特性
- 智能域名匹配：当给定域时，查询API并根据网站URL匹配结果，然后返回到名称匹配
- 一个复合呼叫:
profile区域工具都读BizMachine的aggregated-data端点，因此单个获取（缓存）为身份、财务、联系人、风险、分数和分类提供支持 - 收入提取：处理精确值和范围估计值（中点）
- 名称规范化：去掉捷克法律后缀（s.r.o.、a.s.等）和变音符号以进行模糊匹配
- CZ+SK带自动回退功能：查询工具首先尝试捷克语数据库，然后尝试斯洛伐克语数据库
- 30天文件缓存：结果缓存在
~/.cache/bizmachine/以避免重复的API调用 - 速率限制：API调用之间150毫秒
API计划层次
每个工具可以返回的数据取决于您的BizMachine API计划。上述工具是基于标准数据密钥可用的端点构建的(suggest, aggregated-data, indicators, owned-companies).一些BizMachine数据集——详细的财务报表（行项目）、个人车辆/车队记录、公开招标和职位发布列表、补贴和个人联系人——需要更高的计划级别，并由BizMachine作为单独的端点公开。如果标准层上只有摘要/计数级别数据可用（例如车队规模、未完成的作业计数、电子商店计数），则通过以下方式显示 metrics 和 profile.signals.
发展
纯粹的数据整形逻辑存在 lib/extract.mjs （无I/O），中的API客户端
lib/api.mjs，以及MCP接线 index.mjs.运行单元测试（没有API密钥
需要——他们锻炼纯粹的助手）：
npm test
许可证
麻省理工学院
