APIEmpresas: Spanish company data

io.github.abasmartinc由 GitHub 账号 abasmartinc 发布v1.4.2更新于 Nov 7, 2026

Spanish company data: CIF lookup, BORME, directors, KYB, sanctions and open public tenders.

已验证Streamable HTTP可网页运行网页搜索与抓取金融商业与电商

概览

AI 生成的概览

APIEmpresas 官方 MCP 服务器,提供西班牙公司数据:CIF 查询、名称搜索、KYB 核验、BORME 公告、风险、制裁与公开招标。

可以做什么
  • 按 CIF 查询西班牙公司,或按名称搜索,并把一批名称批量转换为 CIF
  • 执行 KYB 核验:公司是否存在并运营、名称与签署人是否匹配,可选 VIES 增值税号与 EORI 检查
  • 批量校验发票收件人,返回可开票、需复核或不可开票的提示
  • 获取 BORME 公告历史、基于 BORME 的风险画像、已授予的公共合同与 BDNS 补贴
  • 按关键词、CPV、省份、类型或金额检索在期公开招标,并筛查欧盟、联合国与 OFAC 制裁名单
  • 查看套餐、剩余查询次数与积分余额
适用场景
适合需要核查或补全西班牙公司信息的场景:客户与供应商准入、开票前校验收票方、授信或签约前评估交易对手风险,以及寻找公共招标与补贴机会。
运行要求
可作为远程端点使用,也可通过 npx 以本地 npm 包 apiempresas-mcp 运行,需要 Node.js 18 或更高版本。需在服务商面板获取 API key,并设置为 APIEMPRESAS_API_KEY(或 X-API-KEY 请求头);无密钥时仅名称搜索和基础公司数据可用,且有每日限额。免费套餐 100 次查询,付费套餐按月计费。
安装前请注意
每次调用都会消耗套餐查询次数,用量越多成本越高;付费套餐为每月 19 欧元和 49 欧元,不含增值税。API key 属于机密,应避免写入共享配置。登记状态、评分与风险画像由服务商依据 BORME 计算,并非商业登记处的官方证明;数据不含实际受益人、PEP 名单,也不覆盖个体经营者。

安装

在 SourceWeft 中

  1. 打开 控制台中的 APIEmpresas: Spanish company data,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.abasmartinc%2Fapiempresas/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "apiempresas-spanish-company-data": {
      "type": "http",
      "url": "https://apiempresas.es/api/mcp"
    }
  }
}

README

APIEmpresas MCP

Servidor MCP oficial de APIEmpresas.es: datos de empresas españolas para Claude, Cursor, VS Code y cualquier asistente compatible con MCP.

Pregunta en lenguaje natural ("¿Mercadona está activa y quiénes son sus administradores?", "saca el CIF de estas 40 empresas", "¿esta empresa ha tenido un concurso?") y el asistente consulta la API con tu clave.

Herramientas

HerramientaQué hacePlan
get_companyEmpresa por CIF: razón social, estado, constitución, provincia, CNAE, forma jurídica (ISO 20275) y LEI; domicilio, socio único, matriz del grupo y administradores según planFree (datos recortados), Pro
search_companiesBuscar empresas por nombreFree
verify_companyVerificación KYB: existe, activa, nombre y administrador (o socio único) coinciden y, si se pide, NIF-IVA en VIES; con forma jurídica, LEI, matriz y socio único (2 consultas)Pro
find_cif_by_nameDe nombre a CIF, hasta 100 a la vez, con provincia opcional para desempatar (solo cobra las coincidencias)Pro
verify_invoice_recipientsValida una lista de clientes (hasta 100) antes de facturarles: razón social y domicilio oficiales, estado y invoice_hint ok / revisar / no_facturar, con sus motivos; con vat, también VIES (hasta 20). Solo cobra las sociedades encontradas (desde 1.4.0)Pro
get_borme_historyActos publicados en el BORMEPro
get_risk_profilePerfil de riesgo a partir del BORMEBusiness
get_public_contractsContratos públicos adjudicadosBusiness
get_subsidiesSubvenciones y ayudas públicas de la BDNS desde 2022 (Kit Digital incluido): resumen por año, instrumento y convocatoria, y las concesiones (desde 1.3.0)Business
search_tendersLicitaciones públicas abiertas: por palabras, CPV, provincia, tipo e importe, o parecidas a lo que ya ha ganado una empresa (cif)Business
check_sanctionsListas de sanciones de la UE, la ONU y OFAC: una empresa y sus administradores (cif) o un nombre (name), con el grado de cada coincidenciaBusiness
get_usagePlan, consultas disponibles y saldo de créditos (gratis; no funciona en el Sandbox)Todos

Todas son de solo lectura. Cada llamada gasta consultas de tu plan, igual que la API.

Instalación

  1. Crea una cuenta gratis (100 consultas, sin tarjeta) en apiempresas.es y copia tu API key del panel.
  2. Añade el servidor a tu cliente (necesita Node.js 18 o superior).

Claude Desktop

En claude_desktop_config.json:

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

Claude Code

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

Cursor

En ~/.cursor/mcp.json (o .cursor/mcp.json en el proyecto), el mismo bloque mcpServers que en Claude Desktop.

VS Code

En .vscode/mcp.json:

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

Pruebas sin coste

Con APIEMPRESAS_BASE_URL=https://apiempresas.es/api/sandbox/v1 las llamadas no gastan consultas (solo admite los CIF de prueba A15075062 y B00000000).

Qué conviene saber

  • El estado registral, el scoring y el perfil de riesgo los calcula APIEmpresas a partir del BORME: no son un certificado del Registro Mercantil.
  • No cubre titular real, listas de sanciones o PEP, ni empresarios individuales (autónomos).
  • Precios: Free 100 consultas; Pro 19 €/mes (3.000/mes); Business 49 €/mes (10.000/mes); bonos sin suscripción desde 9 €. IVA no incluido. Detalle en apiempresas.es.
  • Documentación completa de la API: apiempresas.es/documentation.

English

Official MCP server for APIEmpresas.es, a REST API for Spanish company data: lookup by CIF (tax ID), name search, KYB verification, bulk tax ID checks of invoice recipients (verify_invoice_recipients), directors, BORME (Commercial Registry gazette) filings, public contracts and risk profile. Get a free API key (100 requests) at apiempresas.es and run npx -y apiempresas-mcp with APIEMPRESAS_API_KEY set.

Licencia

MIT

来源:README.md,提交 12eba19

工具

12

get_company

Empresa por CIF

Ficha de UNA empresa española cuando ya tienes su CIF/NIF. Úsala para saber si existe y está activa, su razón social, forma jurídica (con código ISO 20275), código LEI, CNAE, provincia y fecha de constitución; con plan Pro, también domicilio, tramo de facturación, socio único, matriz del grupo y, con include_directors, los administradores vigentes, el tramo de empleados y cuántas sociedades comparten su domicilio (domicilio masivo). Si no tienes el CIF, usa search_companies; para decidir un alta (KYB), verify_company. Gasta 1 consulta; sin API key funciona con los datos básicos y un límite diario. Spanish company lookup by tax ID.

输入参数cif必填include_directors

search_companies

Buscar empresas por nombre

Busca empresas españolas por nombre o parte del nombre y devuelve las candidatas con su CIF, provincia y estado. Úsala cuando NO tienes el CIF de una empresa concreta; después, get_company con el CIF elegido. Para convertir una lista de muchos nombres en CIF, mejor find_cif_by_name. Sin API key funciona con hasta 10 resultados y un límite diario. Search Spanish companies by name.

输入参数limitquery必填

verify_company

Verificación KYB

Verificación para dar de alta a un cliente o proveedor (KYB) en una llamada: comprueba que la sociedad existe y opera, que la razón social que te han dado coincide (name), que quien firma es administrador vigente o socio único (person) y, si se pide, el NIF-IVA en VIES (vat) y si tiene EORI para importar y exportar fuera de la UE (eori). Avisa si el domicilio lo comparten muchas sociedades (domicilio masivo). Devuelve alertas y una recomendación pass / review / fail, además de forma jurídica, LEI, matriz y socio único. Úsala para decidir; para solo consultar datos, get_company. Plan Pro; gasta 2 consultas. KYB check for a Spanish company.

输入参数cif必填vateorinameperson

find_cif_by_name

De nombre a CIF (lista)

Convierte una LISTA de nombres de empresa (hasta 100) en sus CIF, con resultado match, ambiguous o no_match para cada uno. Úsala para completar hojas de clientes o proveedores que solo tienen el nombre. Solo los match gastan consulta. Para un solo nombre, search_companies. Plan Pro.

输入参数names必填province

verify_invoice_recipients

Validar NIF de clientes para facturar

Valida una LISTA de clientes (hasta 100) antes de emitirles facturas (Verifactu, factura electrónica): por cada NIF, si el formato es válido, si la sociedad consta, su razón social y domicilio oficiales, su estado y, si das el nombre que tienes guardado, si coincide. Devuelve invoice_hint ok / revisar / no_facturar con los motivos (extinguida, absorbida, en concurso, nombre distinto, NIF de ejemplo...). Úsala para revisar la cartera de clientes de un programa de facturación o ERP; para dar de alta a un solo cliente con más detalle, verify_company. No sustituye al censo de la AEAT. Plan Pro, Business o saldo; gasta 1 consulta por sociedad encontrada (lo que no consta no se cobra). Bulk VAT/tax ID check of invoice recipients.

输入参数vatitems必填

get_borme_history

Historial del BORME

Todos los actos publicados en el BORME de una empresa, con fecha y PDF oficial: constitución, nombramientos y ceses, ampliaciones de capital, cambios de domicilio o de nombre, disolución, concurso... Úsala para la historia y los cambios recientes; para el estado actual basta get_company. Plan Pro.

输入参数cif必填

get_risk_profile

Perfil de riesgo

Nivel de riesgo de una empresa y sus motivos, calculado a partir de sus publicaciones en el BORME (concursos, disoluciones, cierres de hoja registral, cuentas no depositadas, cambios de administradores...). Úsala antes de dar crédito o firmar con un proveedor. Plan Business.

输入参数cif必填

get_public_contracts

Contratos públicos

Contratos del sector público adjudicados a una empresa (Plataforma de Contratación del Sector Público): organismo, objeto, importe y fecha. Plan Business.

输入参数cif必填pagelimit

get_subsidies

Subvenciones y ayudas públicas

Subvenciones, préstamos, garantías y ventajas fiscales concedidos a una empresa española según la Base de Datos Nacional de Subvenciones (BDNS), desde 2022, Kit Digital incluido: resumen por año, por instrumento y las convocatorias con más importe, y la lista de concesiones. Úsala para prospección de ayudas o para saber cuánto dinero público recibe. Plan Business; gasta 1 consulta. Public grants received by a Spanish company.

输入参数cif必填yearlimit

search_tenders

Licitaciones públicas abiertas

Licitaciones públicas EN PLAZO en España (Plataforma de Contratación del Sector Público y plataformas autonómicas): título, organismo, provincia, importe, plazo de ofertas, CPV y enlace para presentarse. Filtra por palabras del título (query), CPV, provincia, tipo (supplies, services, works) e importe. Con cif, devuelve las abiertas parecidas a los contratos que esa empresa ya ha ganado: úsala para "¿a qué concursos se puede presentar esta empresa?". Plan Business; gasta 1 consulta. Open public tenders in Spain.

输入参数cifcpvtypelimitqueryprovincemax_amountmin_amount

check_sanctions

Listas de sanciones

Comprueba si una empresa española (por cif, junto con sus administradores vigentes) o un nombre suelto (name) aparece en las listas de sanciones de la UE, la ONU y OFAC (EE. UU.). Devuelve cada coincidencia con su grado (strong o possible), la lista, el programa, la fecha, el país y la fecha de nacimiento para confirmarla o descartarla: un nombre parecido no es una coincidencia confirmada. Úsala en altas de clientes o proveedores (KYB, prevención de blanqueo). Plan Business; gasta 1 consulta. Sanctions screening (EU, UN, OFAC).

输入参数cifnametype

get_usage

Consumo de la cuenta

Plan de la cuenta del usuario, consultas usadas y disponibles y saldo de créditos. No gasta consultas. Úsala si una herramienta responde que se ha agotado el cupo.

无需输入参数。

版本历史

6
  1. v1.4.2最新Nov 7, 2026
  2. v1.4.1Oct 30, 2026
  3. v1.4.0Oct 26, 2026
  4. v1.3.0Oct 20, 2026
  5. v1.2.0Oct 18, 2026
  6. v1.1.0Oct 16, 2026

评分

已满足适用检查项的 100%

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

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分