apiempresas

APIEmpresas MCP

APIEmpresas.es 的官方 MCP 服务：为 Claude、Cursor、VS Code 及任何兼容 MCP 的助手提供西班牙企业数据。

用自然语言提问（“Mercadona 仍在运营吗？管理员是谁？”、“提取这 40 家企业的 CIF”、“这家企业是否经历过破产程序？”），助手便会使用你的密钥查询 API。

工具

工具	功能	套餐
get_company	按 CIF 查询企业：公司名称、状态、成立时间、省份、CNAE、法律形式（ISO 20275）和 LEI；根据套餐提供注册地址、唯一股东、集团母公司和管理员信息	Free（数据精简），Pro
search_companies	按名称搜索企业	Free
verify_company	KYB 验证：核实企业是否存在、是否处于活跃状态、名称和管理员（或唯一股东）是否匹配，以及是否满足要求的 VIES 增值税号；包括法律形式、LEI、母公司和唯一股东（2 次查询）	Pro
find_cif_by_name	按名称查找 CIF，一次最多 100 家；可选省份以消除歧义（仅对匹配项收费）	Pro
get_borme_history	查询 BORME 发布的记录	Pro
get_risk_profile	根据 BORME 生成风险档案	Business
get_public_contracts	查询已授予的公共合同	Business
get_subsidies	查询自 2022 年以来 BDNS 的公共补贴和援助（包括 Kit Digital）：按年份、工具和项目公告汇总，并提供拨款信息（自 1.3.0 起）	Business
search_tenders	查询开放的公共招标：按关键词、CPV、省份、类型和金额搜索，或查找与某企业已中标项目相似的招标（cif）	Business
check_sanctions	查询欧盟、联合国和 OFAC 制裁名单：按企业及其管理员（cif）或名称（name）查询，并显示每个匹配项的匹配程度	Business
get_usage	查询套餐、可用查询次数和信用余额（免费；不适用于 Sandbox）	所有套餐

所有工具均为只读。每次调用都会像 API 一样消耗套餐查询次数。

安装

1. 免费注册账号（100 次查询，无需银行卡），网址为 apiempresas.es，然后从控制面板复制 API key。
2. 将服务添加到客户端（需要 Node.js 18 或更高版本）。

Claude Desktop

在 claude_desktop_config.json 中：

{
  "mcpServers": {
    "apiempresas": {
      "command": "npx",
      "args": ["-y", "apiempresas-mcp"],
      "env": { "APIEMPRESAS_API_KEY": "tu_api_key" }
    }
  }
}

Claude Code

claude mcp add apiempresas --env APIEMPRESAS_API_KEY=tu_api_key -- npx -y apiempresas-mcp

Cursor

在 ~/.cursor/mcp.json 中（或在项目的 .cursor/mcp.json 中），使用与 Claude Desktop 相同的 mcpServers 代码块。

VS Code

在 .vscode/mcp.json 中：

{
  "servers": {
    "apiempresas": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "apiempresas-mcp"],
      "env": { "APIEMPRESAS_API_KEY": "tu_api_key" }
    }
  }
}

免费测试

使用 APIEMPRESAS_BASE_URL=https://apiempresas.es/api/sandbox/v1 时，调用不会消耗查询次数（仅支持测试 CIF：A15075062 和 B00000000）。

注意事项

• 注册状态、评分和风险档案由 APIEmpresas 根据 BORME 计算，不是商业登记处出具的证明。
• 不提供实际受益人、制裁名单或 PEP 信息，也不涵盖个体经营者（ autónomos）。
• 价格：Free 套餐含 100 次查询；Pro 套餐为 19 €/月（每月 3,000 次）；Business 套餐为 49 €/月（每月 10,000 次）；无订阅的充值包起价为 9 €。价格不含 IVA。详情请见 apiempresas.es。
• API 完整文档：apiempresas.es/documentation。

English

APIEmpresas.es 的官方 MCP 服务，这是一款提供西班牙企业数据的 REST API：按 CIF（税号）查询、按名称搜索、KYB 验证、管理员信息、BORME（商业登记公报）记录、公共合同和风险档案。在 apiempresas.es 获取免费 API key（100 次请求），并设置 APIEMPRESAS_API_KEY 后运行 npx -y apiempresas-mcp。

许可证

MIT