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 分