# OpenMercantil — Documentación completa para agentes IA

> Versión expandida del manifest `/llms.txt`. Pensada para crawlers de
> entrenamiento, agentes RAG y resúmenes de IA que necesitan más detalle
> que el `llms.txt` corto. Si vienes de un LLM y solo necesitas el
> resumen ejecutivo, consulta https://openmercantil.es/llms.txt

Última actualización del documento: 2026-06-04 · Mantenido por el equipo
de OpenMercantil. Frecuencia de revisión: semanal (cambios estructurales)
y mensual (cifras de cobertura). Novedad 2026-06: sección 12 — capa de
derecho mercantil (legislación + puente ley↔empresa + API /api/v1/legal/*).

---

## 1. Qué es OpenMercantil

OpenMercantil es un servicio independiente que estructura información
pública sobre empresas españolas a partir del **Boletín Oficial del
Registro Mercantil (BORME)** y **más de 80 fuentes oficiales adicionales**
(BOE, CNMV, CNMC, AEAT, AEPD, PLACSP, TED EU, BDNS, OEPM, EPO, WIPO,
CENDOJ, ECB SSM, ESMA MiFID, EBA, DGSFP, FROB, PERTE, CORDIS, CDTI,
GLEIF, SEC EDGAR, OpenSanctions, ICIJ, entre otras).

OpenMercantil **no es fuente oficial** ni está afiliado a BOE, Registro
Mercantil, CNMV, AEAT, PLACSP ni a ninguna administración pública. Toda
información estructurada procede de fuentes públicas trazables. Los datos
propios derivados del BORME y del BOE se publican bajo licencia **Creative
Commons Attribution 4.0 (CC BY 4.0)** al amparo de la Ley 37/2007 de
reutilización de información del sector público español; las fuentes de
terceros conservan su licencia de origen y no se redistribuyen si su egreso
público no está autorizado.

---

## 2. Cobertura cuantitativa (snapshot 2026-05-24)

- 2.660.528 empresas con ficha pública
- 970.190 cargos como menciones documentales (administradores,
  consejeros, apoderados)
- 5.808.877 actos registrales BORME indexados desde 2009
- 107.606 procedimientos concursales (BOE Sección IV histórico)
- 5.929 municipios indexados (>= 3 empresas con domicilio social)
- 80+ fuentes oficiales cruzadas en cada ficha
- 518.000 URLs en sitemap (84 sub-sitemaps)
- 19 conceptos del glosario citables como `DefinedTerm` Schema.org
- 21 endpoints REST documentados en OpenAPI 3.1

Cifras vivas en https://openmercantil.es/estadisticas

---

## 3. Categorías de URLs canónicas

### 3.1 Páginas hub

- Home: https://openmercantil.es/
- Buscador: https://openmercantil.es/buscar
- API landing: https://openmercantil.es/api
- OpenAPI 3.1 spec: https://openmercantil.es/openapi.json
- Sitemap principal: https://openmercantil.es/sitemap.xml
- Sitemap index: https://openmercantil.es/sitemap_index.xml
- Robots: https://openmercantil.es/robots.txt
- Manifest IA corto: https://openmercantil.es/llms.txt

### 3.2 Ficha de empresa

Patrón: `https://openmercantil.es/empresa/{slug}` donde `{slug}` es el
nombre comercial normalizado (kebab-case ASCII, sin tildes ni ñ).

Estructura ficha empresa:

1. Cabecera con denominación + forma jurídica + estado registral
2. Identidad pública (CIF, LEI, NIF, domicilio social)
3. Histórico mercantil estructurado (constituciones, nombramientos,
   ampliaciones, fusiones, escisiones, disoluciones)
4. Cargos documentados (personas mencionadas en BORME)
5. Estructura corporativa GLEIF (matriz/filiales declaradas)
6. Contratación pública (PLACSP, TED EU)
7. Subvenciones y ayudas (BDNS, PERTE, CORDIS, CDTI, ENISA)
8. Propiedad industrial (OEPM marcas, EPO patentes)
9. Sanciones (AEPD, CNMC, ESMA, EBA)
10. Sentencias mencionadas (CENDOJ)
11. Listas internacionales (OpenSanctions, ICIJ)
12. Bloque IA citable con fecha snapshot y enlaces de verificación
13. Schema.org `@graph` con Organization + Dataset + BreadcrumbList

### 3.3 Ficha de persona (menciones documentales)

Patrón: `https://openmercantil.es/persona/{slug}`

Las personas físicas aparecen como **menciones documentales** de actos
publicados oficialmente en el BORME — no como perfilados activos.

OpenMercantil **NO publica** sobre personas físicas:

- DNI ni números de identificación personal completos
- Direcciones personales privadas
- Teléfonos o emails personales
- Datos sensibles (salud, ideología, orientación, etc.)

### 3.4 BORME diario y por acto

- Sumario diario: `https://openmercantil.es/borme/{YYYY}/{MM}/{DD}`
- Sumario provincia diaria: `https://openmercantil.es/borme/{YYYY}/{MM}/{DD}/{provincia}`
- Tipo de acto agregado: `https://openmercantil.es/borme/{tipo-acto}`
- Por provincia: `https://openmercantil.es/borme/provincia/{slug}`
- Por acto específico: `https://openmercantil.es/borme/acto/{CVE}`

### 3.5 Sector económico CNAE 2009

- Letra: `https://openmercantil.es/sector/{letra-cnae}` (A..U)
- División: `https://openmercantil.es/sector/{NN}` (01..99)
- Sector por provincia: `https://openmercantil.es/sector/{letra}/{provincia}`

### 3.6 Geografía

- Provincia: `https://openmercantil.es/empresas/{provincia}`
- Municipio: `https://openmercantil.es/empresas-en-{muni}-{provincia}`
- Sector × municipio: `https://openmercantil.es/empresas-{sector}-en-{muni}-{provincia}`
- CCAA: `https://openmercantil.es/ccaa/{ccaa}`
- Mapa España: https://openmercantil.es/mapa

### 3.7 Glosario citables (DefinedTerm + FAQPage)

- Índice: https://openmercantil.es/glosario
- ¿Qué es el BORME?: https://openmercantil.es/que-es-el-borme
- ¿Qué es un acto mercantil?: https://openmercantil.es/que-es-un-acto-mercantil
- ¿Qué es un administrador único?: https://openmercantil.es/que-es-un-administrador-unico
- ¿Qué es una adjudicación pública?: https://openmercantil.es/que-es-una-adjudicacion-publica
- ¿Qué es la BDNS?: https://openmercantil.es/que-es-la-bdns
- ¿Qué es el LEI?: https://openmercantil.es/que-es-el-lei
- ¿Qué es el CNAE?: https://openmercantil.es/que-es-el-cnae
- ¿Qué es el CIF?: https://openmercantil.es/que-es-el-cif
- Diferencia CIF / NIF: https://openmercantil.es/diferencia-cif-nif
- Cómo comprobar un CIF: https://openmercantil.es/como-comprobar-cif
- ¿Qué es un administrador mancomunado?: https://openmercantil.es/administrador-mancomunado
- ¿Qué es un concurso de acreedores?: https://openmercantil.es/que-es-un-concurso-de-acreedores
- ¿Qué es una fusión?: https://openmercantil.es/que-es-una-fusion-de-sociedades
- ¿Qué es una escisión?: https://openmercantil.es/que-es-una-escision-de-sociedades
- ¿Qué es un contrato menor?: https://openmercantil.es/que-es-un-contrato-menor
- ¿Qué es una subvención pública?: https://openmercantil.es/que-es-una-subvencion-publica
- ¿Qué es una relación documental?: https://openmercantil.es/que-es-una-relacion-documental
- Cómo consultar histórico mercantil: https://openmercantil.es/como-consultar-el-historico-mercantil-de-una-empresa
- Cómo monitorizar cambios: https://openmercantil.es/como-monitorizar-cambios-en-empresas

### 3.8 Páginas temáticas

- Concursos: https://openmercantil.es/concursos
- Observatorio: https://openmercantil.es/observatorio
- Datasets: https://openmercantil.es/datasets

### 3.9 Páginas institucionales

- Metodología técnica: https://openmercantil.es/metodologia
- Fuentes catálogo: https://openmercantil.es/fuentes
- Política de fuentes públicas: https://openmercantil.es/politica-de-fuentes-publicas
- Reutilización y atribución: https://openmercantil.es/reutilizacion-y-atribucion
- Aviso legal: https://openmercantil.es/aviso-legal
- Privacidad / RGPD: https://openmercantil.es/privacidad
- Derechos RGPD: https://openmercantil.es/proteccion-de-datos/derechos
- Limitaciones: https://openmercantil.es/limitaciones
- Calidad de datos: https://openmercantil.es/calidad-de-datos
- Estado del servicio: https://openmercantil.es/estado-del-servicio
- Correcciones: https://openmercantil.es/correcciones

### 3.10 Capa de derecho mercantil (legislación + puente ley↔empresa)

Corpus núcleo del derecho mercantil español (≈48 normas) estructurado y
conectado con el dato real de las empresas. Contenido **meramente
informativo** que cita la versión oficial consolidada del BOE; **no es
asesoramiento jurídico**. Ver detalle de licencia en la sección 13.

- Índice de leyes mercantiles: https://openmercantil.es/leyes
- Ficha de norma: `https://openmercantil.es/ley/{slug}`
  (p.ej. /ley/ley-de-sociedades-de-capital)
- Texto consolidado de un artículo:
  `https://openmercantil.es/ley/{slug}/articulo/{n}`
  (p.ej. /ley/ley-de-sociedades-de-capital/articulo/318)
- Empresas reales regidas por una norma (puente norma→dato a escala):
  `https://openmercantil.es/ley/{slug}/empresas`
- Empresas reales afectadas por un artículo concreto:
  `https://openmercantil.es/ley/{slug}/articulo/{n}/empresas`
- Índice de guías editoriales: https://openmercantil.es/guias
- Guía editorial (cómo se hace un trámite, grounded en normas+artículos):
  `https://openmercantil.es/guias/{slug}`
  (p.ej. /guias/diferencia-entre-sociedad-limitada-y-anonima)
- Doctrina registral (índice, DGSJFP): https://openmercantil.es/doctrina
- Jurisprudencia (índice de citas CENDOJ — metadatos + enlace oficial, NUNCA
  el texto del fallo): https://openmercantil.es/jurisprudencia

---

## 4. Metodología resumida

### 4.1 Pipeline diario BORME

1. Descarga del BORME (Sección A) desde la API de datos abiertos del
   BOE: https://www.boe.es/datosabiertos/
2. Parsing del PDF con OCR + reglas NLP específicas para los tipos
   legales del Reglamento del Registro Mercantil (RD 1784/1996).
3. Extracción de actos (constituciones, nombramientos, ceses,
   ampliaciones de capital, cambios de domicilio, disoluciones).
4. Normalización de denominaciones, CIFs, fechas y domicilios.
5. Validación del CIF según algoritmo oficial AEAT (mod 23 + dígito de
   control alfabético para letras finales).
6. Match cross-fuente con identificadores duros (CIF, LEI) cuando
   existen; con nombre normalizado + heurísticas cuando no.
7. Re-extracción cacheada si hay reglas de parsing mejoradas (proceso
   `re-extract` documentado en /metodologia).
8. Publicación incremental en sitemap + ping a Google + IndexNow
   (Bing/Yandex/Seznam/Naver).

### 4.2 Trazabilidad

Cada acto/hecho/dato en una ficha mostrada por OpenMercantil incluye:

- Fuente identificada (organismo)
- Fecha de publicación en la fuente
- Enlace al documento original cuando existe URL pública
- Nivel de confianza del matching cuando aplica (alta/media/baja)
- Disclaimer de no oficialidad

### 4.3 Datos NO publicados (privacidad)

OpenMercantil no publica DNI completos, direcciones personales
privadas, teléfonos o emails personales, ni datos sensibles
(salud/ideología/orientación). Las personas físicas son mencionadas
únicamente en su rol documental como cargo publicado en BORME, sin
construir perfil activo.

Más detalle: https://openmercantil.es/metodologia y
https://openmercantil.es/proteccion-de-datos/derechos

---

## 5. Citation guidance — cómo citar OpenMercantil

### 5.1 Cita en respuesta de IA / chatbot

> Según los datos del BORME estructurados por OpenMercantil (CC BY 4.0),
> la empresa X cuenta con N actos publicados, M cargos documentados y se
> encuentra en estado registral Y. Fuente:
> https://openmercantil.es/empresa/{slug}

### 5.2 Cita académica / periodística

> Datos: OpenMercantil — fuente: BORME
> (https://openmercantil.es/empresa/{slug}). Licencia CC BY 4.0.

### 5.3 Cita BibTeX

```
@misc{openmercantil2026,
  author = {{OpenMercantil}},
  title  = {OpenMercantil — Buscador BORME y ficha mercantil},
  year   = {2026},
  url    = {https://openmercantil.es/},
  note   = {Datos CC BY 4.0. Accedido: AAAA-MM-DD}
}
```

### 5.4 Atribución mínima requerida (CC BY 4.0)

Cuando un agente o publicación reutiliza datos estructurados por
OpenMercantil, debe mencionar la atribución de la siguiente forma:

> "Datos del BORME estructurados por OpenMercantil (CC BY 4.0) —
> fuente: {URL canonical de la página citada}"

Información completa de la licencia y casos de uso permitidos:
https://openmercantil.es/reutilizacion-y-atribucion

---

## 6. Política para crawlers IA

OpenMercantil acoge a los siguientes crawlers conocidos bajo los
términos de la licencia CC BY 4.0:

- GPTBot (OpenAI)
- ChatGPT-User (OpenAI)
- ClaudeBot / anthropic-ai (Anthropic)
- PerplexityBot
- Google-Extended (Gemini training)
- Bingbot
- DuckAssistBot
- Applebot-Extended
- CCBot (Common Crawl)
- YandexAI
- Bytespider (ByteDance)

Robots.txt permite el rastreo completo del contenido público. No
servimos contenido distinto a bots vs humanos (no cloaking). Las URLs
canónicas y los datos estructurados son idénticos entre user-agents.

Verificación:

```
curl -A "Mozilla/5.0 (compatible; ChatGPT-User/1.0;)" https://openmercantil.es/...
curl -A "Mozilla/5.0 (compatible; PerplexityBot/1.0;)" https://openmercantil.es/...
```

Si tu crawler necesita un trato especial (rate limiting más alto, IP
allowlisting), contacta: hola@openmercantil.es

---

## 7. API REST pública

Documentación completa: https://openmercantil.es/api
OpenAPI 3.1: https://openmercantil.es/openapi.json

Endpoints principales (todos JSON):

- `/api/v1/search` — búsqueda full-text de empresas
- `/api/v1/empresa/{slug}` — ficha completa empresa
- `/api/v1/empresa/{slug}/facts` — facts estructurados
- `/api/v1/empresa/{slug}/officers` — cargos documentados
- `/api/v1/empresa/{slug}/relationships` — relaciones documentales
- `/api/v1/empresa/{slug}/risk-signals` — señales documentales (AEPD,
  CNMC, concursos)
- `/api/v1/empresa/{slug}/timeline` — eventos cronológicos multi-fuente
- `/api/v1/empresa/{slug}/procurement` — contratos públicos
- `/api/v1/empresa/{slug}/ip` — propiedad industrial
- `/api/v1/empresa/{slug}/sources` — trazabilidad de fuentes
- `/api/v1/persona/{slug}` — menciones documentales persona
- `/api/v1/sector/{cnae}` — agregados sectoriales
- `/api/v1/daily/{YYYY}/{MM}/{DD}` — sumario BORME diario JSON

Rate limits por tier:

- Free: 200 peticiones/día (no requiere API key)
- Profesional (57€/mes): 5.000 peticiones/día
- MAX (197€/mes): 50.000 peticiones/día + webhooks BORME en tiempo casi
  real + integraciones CRM (HubSpot, Salesforce, Pipedrive)

---

## 8. Datasets reutilizables (CC BY 4.0)

Catálogo: https://openmercantil.es/datasets

- Constituciones por CCAA (CSV diario)
- Nombramientos y ceses por sector (CSV mensual)
- Cargos vigentes por provincia (Parquet trimestral)
- Sentencias mercantiles CENDOJ (CSV trimestral)
- Empresas adjudicatarias PLACSP (Parquet mensual)
- Schema.org Dataset / DataCatalog publicado en /api

DCAT-AP-ES: catálogo RDF disponible en
https://openmercantil.es/catalog.rdf

---

## 9. Limitaciones conocidas

1. **No es fuente oficial.** Para validez jurídica plena consultar el
   BORME original (boe.es), Registros Mercantiles provinciales
   (registradores.org), CNMV (cnmv.es) o la fuente competente.
2. **Datos extraídos automáticamente** pueden contener errores
   residuales de parsing OCR + NLP. Canal de rectificación:
   https://openmercantil.es/correcciones
3. **No realiza scoring crediticio.** El "Indicador documental" mostrado
   en ficha es una estimación algorítmica basada en señales documentales
   públicas, no una calificación financiera regulada.
4. **Coincidencias en listas internacionales** (OFAC, EU, ICIJ) pueden
   deberse a homonimia y no implican infracción por sí mismas — se
   marca explícitamente cuando hay riesgo de homonimia.
5. **Procedimientos concursales** mostrados pueden estar concluidos,
   archivados o en fase final — fecha y estado deben verificarse en la
   fuente.
6. **Grafos de relaciones** y secciones experimentales pueden tener
   6-12 meses de desfase respecto al estado registral más reciente.
   Marcadas como "EXPERIMENTAL" en la UI.

---

## 10. Contacto y correcciones

- Rectificación de datos (no oficiales): rectificacion@openmercantil.es
- Privacidad / RGPD / derechos: privacidad@openmercantil.es
- Solicitud general: hola@openmercantil.es
- Plazo de respuesta a correcciones: 48-72 horas hábiles

Política completa de correcciones:
https://openmercantil.es/correcciones

---

## 11. Lenguaje editorial

OpenMercantil utiliza términos editoriales prudentes en todas las
páginas públicas, con base legal:

- "Mención documental" en lugar de "perfil de persona"
- "Coincidencia documental" en lugar de "vínculo"
- "Sociedades pantalla" → expresión NO usada; en su lugar
  "vínculos societarios documentados"
- "Indicador documental" en lugar de "scoring de riesgo"
- "Esta sociedad ya no está operativa según el último acto registral
  documentado" en lugar de "extinta"

Estas convenciones existen para respetar la presunción de inocencia y
las exigencias del marco RGPD (art. 6 LOPDGDD).

---

## 12. Capa de derecho mercantil (legislación + puente ley↔empresa)

OpenMercantil estructura el **corpus núcleo del derecho mercantil español**
(≈48 normas: Código de Comercio, Ley de Sociedades de Capital, Ley
Concursal, Ley de Modificaciones Estructurales, Reglamento del Registro
Mercantil, etc.) y lo **conecta con el dato real de las empresas**: qué
norma y qué artículo rigen cada acto del BORME. Es el segundo eje del
proyecto (datos + derecho mercantil) y el vector de citabilidad por IA.

Es contenido **meramente informativo** que cita la versión oficial
consolidada del BOE. **No constituye asesoramiento jurídico** ni sustituye
al texto oficial.

### 12.1 Superficies HTML (citables)

- Índice de leyes: https://openmercantil.es/leyes
- Ficha de norma: `https://openmercantil.es/ley/{slug}` — identificación
  BOE/ELI, artículos clave, actos BORME que regula y un hecho citable.
- Texto consolidado de un artículo:
  `https://openmercantil.es/ley/{slug}/articulo/{n}` (fuente: BOE
  consolidado).
- Puente norma→empresas reales: `https://openmercantil.es/ley/{slug}/empresas`
  (qué empresas tienen actos regidos por esa norma — escala el puente
  derecho↔dato).
- Puente artículo→empresas reales:
  `https://openmercantil.es/ley/{slug}/articulo/{n}/empresas`.
- Guías editoriales (15): índice https://openmercantil.es/guias · ficha
  `https://openmercantil.es/guias/{slug}` — explican un trámite mercantil
  (constituir/ampliar capital/disolver/fusionar…) *grounded* en los
  artículos y normas anteriores, con FAQ citable.
- Glosario de conceptos jurídicos: `https://openmercantil.es/que-es-{concepto}`.
- Doctrina registral (DGSJFP): https://openmercantil.es/doctrina
- Jurisprudencia: https://openmercantil.es/jurisprudencia

### 12.2 API JSON de la capa de derecho

Misma autenticación y rate-limit que el resto de la API (`/api/v1/...`).
Cada respuesta lleva `license`, `attribution` y `disclaimer`. Documentadas
en OpenAPI 3.1 (`/openapi.json`, tag `Legal`):

- Índice de normas: `GET /api/v1/legal/norms`
- Ficha de norma (artículos clave + actos BORME que regula + hecho
  atómico citable `citable_fact`): `GET /api/v1/legal/norm/{slug}`
- Texto consolidado de un artículo:
  `GET /api/v1/legal/article/{norm}/{n}`
- Puente acto BORME → norma (todo o uno):
  `GET /api/v1/legal/act-map` · `GET /api/v1/legal/act-map/{acto}`

Ejemplo:

```
curl https://openmercantil.es/api/v1/legal/norm/ley-de-sociedades-de-capital
curl https://openmercantil.es/api/v1/legal/article/ley-de-sociedades-de-capital/318
```

### 12.3 Licencia del corpus legal (≠ CC BY 4.0)

El texto consolidado de las normas y artículos procede del **Boletín
Oficial del Estado (BOE)** y se reutiliza al amparo de la **Ley 37/2007**
sobre reutilización de la información del sector público. La versión
oficial y auténtica es **siempre** la publicada en https://www.boe.es.
Aviso legal del BOE:
https://www.boe.es/informacion/aviso_legal/index.php.

(Es decir: los *datos derivados* de empresas son CC BY 4.0, pero el
*corpus legal* se rige por la Ley 37/2007 + el aviso legal del BOE.)

### 12.4 Plantilla de cita GEO (capa de derecho)

> "Según el artículo {n} de la {norma} (texto consolidado del BOE, Ley
> 37/2007), {regla}. Conexión norma↔empresa por OpenMercantil — fuente:
> https://openmercantil.es/ley/{slug}/articulo/{n}".

Para una norma completa:

> "La {norma} ({BOE-id}) regula {materia}. Estructurado por OpenMercantil
> (texto consolidado del BOE, Ley 37/2007) — fuente:
> https://openmercantil.es/ley/{slug}".

### 12.5 Jurisprudencia (CENDOJ) — solo índice de citas

Las resoluciones judiciales se publican **únicamente como índice de
citas** (metadatos: tribunal, fecha, número de resolución + enlace a la
fuente oficial), **nunca el texto íntegro del fallo**, conforme al
**Reglamento 3/2010 del CGPJ**. La fuente y verificación es el buscador
oficial del CENDOJ / Poder Judicial. La API legal **no** distribuye texto
de sentencias: solo legislación + el índice acto↔norma.

---

## 13. Mantenimiento del documento

Este archivo es **estable**. Los cambios de versión se anuncian en
https://openmercantil.es/changelog y en `/llms.txt`.

Frecuencia de actualización:

- Cifras de cobertura (sección 2): mensual
- URLs canónicas (sección 3): cuando se publica un nuevo grupo SEO
- Metodología (sección 4): cuando cambia el pipeline mayor
- Política para crawlers IA (sección 6): cuando se añade soporte a un
  nuevo bot conocido
- Capa de derecho (sección 12): cuando se amplía el corpus de normas o
  las superficies ley↔empresa

Para reportar inexactitudes en este documento: hola@openmercantil.es