APIEmpresas – Spanish Company Data
Найдите любую испанскую компанию по названию или налоговому номеру (CIF): статус в реестре, организационно-правовую форму, LEI, аннулированные налоговые номера и статистику подач документов из бюллетеня Торгового реестра (BORME). API-ключ не требуется.
Размещённый MCP-сервер
npx add-mcp 'https://apiempresas.es/api/mcp'Устанавливается в Claude Code, Codex, Cursor и другие
Документация
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
| Herramienta | Qué hace | Plan |
|---|---|---|
get_company | Empresa 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 plan | Free (datos recortados), Pro |
search_companies | Buscar empresas por nombre | Free |
verify_company | Verificació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_name | De nombre a CIF, hasta 100 a la vez, con provincia opcional para desempatar (solo cobra las coincidencias) | Pro |
verify_invoice_recipients | Valida 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_history | Actos publicados en el BORME | Pro |
get_risk_profile | Perfil de riesgo a partir del BORME | Business |
get_public_contracts | Contratos públicos adjudicados | Business |
get_subsidies | Subvenciones 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_tenders | Licitaciones públicas abiertas: por palabras, CPV, provincia, tipo e importe, o parecidas a lo que ya ha ganado una empresa (cif) | Business |
check_sanctions | Listas de sanciones de la UE, la ONU y OFAC: una empresa y sus administradores (cif) o un nombre (name), con el grado de cada coincidencia | Business |
get_usage | Plan, 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
- Crea una cuenta gratis (100 consultas, sin tarjeta) en apiempresas.es y copia tu API key del panel.
- Añade el servidor a tu cliente (necesita Node.js 18 o superior).
Claude Desktop
En 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
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:
{
"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