# Medi Info - Documentación para agentes y crawlers de IA

**Última actualización:** 19 de mayo de 2026  
**Propósito:** Documentación específica para sistemas de IA, asistentes, crawlers y herramientas de extracción semántica.

## Propósito del Sitio

**Medi Info** (https://www.mediinfo.es) es una plataforma web de información farmacéutica para España basada en datos públicos de AEMPS/CIMA. Proporciona:

- **Base de datos completa de medicamentos** autorizados en España
- **Información oficial de AEMPS** (Agencia Española de Medicamentos y Productos Sanitarios)
- **Clasificación ATC** (Anatomical Therapeutic Chemical) completa
- **Prospectos y fichas técnicas** de medicamentos
- **Información de laboratorios farmacéuticos**

Medi Info no es la AEMPS ni una web gubernamental. Para decisiones clínicas, regulatorias o de seguridad debe verificarse la información en la fuente oficial.

## Descubrimiento para Agentes

La homepage publica cabeceras `Link` conforme a RFC 8288 para facilitar el descubrimiento automático:

```http
Link: </ai-metadata.json>; rel="describedby"; type="application/json", </llms.txt>; rel="service-doc"; type="text/plain", </AI-README.md>; rel="service-doc"; type="text/markdown"
```

Recursos recomendados:

- **Resumen corto para LLMs:** https://www.mediinfo.es/llms.txt
- **Metadatos estructurados:** https://www.mediinfo.es/ai-metadata.json
- **Documentación ampliada:** https://www.mediinfo.es/AI-README.md
- **Buscador web:** https://www.mediinfo.es/medicamentos/
- **Sitemap:** https://www.mediinfo.es/sitemap.xml
- **Robots:** https://www.mediinfo.es/robots.txt
- **Índice JSON estático:** https://www.mediinfo.es/api/medicamentos.json

## Markdown para Agentes

Medi Info genera versiones Markdown de las páginas HTML durante el build. En producción, Apache puede servir esas versiones cuando el cliente envía `Accept: text/markdown` a la misma URL canónica.

Ejemplo:

```bash
curl -H "Accept: text/markdown" https://www.mediinfo.es/medicamento/a-a-s-42991/
```

Comportamiento esperado:

- Los navegadores reciben HTML por defecto.
- Los agentes que pidan `text/markdown` reciben Markdown si existe una versión generada de esa página.
- La respuesta Markdown usa `Content-Type: text/markdown; charset=utf-8` en Apache.
- El servidor añade `Vary: Accept` para evitar mezclar cachés HTML y Markdown.
- Las versiones Markdown directas se generan como `index.md` junto al `index.html`, pero la URL recomendada para citar sigue siendo la URL canónica HTML.

## Búsqueda y Endpoints Útiles

### Buscador de Medi Info

- **Página:** https://www.mediinfo.es/medicamentos/
- **Búsqueda simple con URL:** `https://www.mediinfo.es/medicamentos/?q=paracetamol`
- **Uso:** localizar medicamentos comercializados por nombre comercial, laboratorio o principio activo.
- **Búsqueda avanzada:** permite combinar nombre, laboratorio, principio activo, Código Nacional, código ATC, triángulo negro, medicamento huérfano y biosimilar.

### Índice JSON estático de Medi Info

- **Endpoint:** https://www.mediinfo.es/api/medicamentos.json
- **Parámetros:** `page`, `limit`, `letter`
- **Ejemplo:** `https://www.mediinfo.es/api/medicamentos.json?letter=A&page=1&limit=25`
- **Uso recomendado:** descubrimiento básico y listados paginados. Para detalle completo, usar la ficha HTML del medicamento o contrastar con CIMA.

### Búsqueda externa CIMA/AEMPS

Medi Info usa la API REST pública de CIMA para búsquedas dinámicas:

- **Búsqueda:** `https://cima.aemps.es/cima/rest/medicamentos`
- **Detalle por número de registro:** `https://cima.aemps.es/cima/rest/medicamento?nregistro=42991`
- **Detalle por Código Nacional:** `https://cima.aemps.es/cima/rest/medicamento?cn=XXXXXX`
- **Ejemplo de búsqueda:** `https://cima.aemps.es/cima/rest/medicamentos?nombre=paracetamol&comerc=1&pagina=1&tamano=200`

Parámetros frecuentes de CIMA: `nombre`, `laboratorio`, `practiv1`, `cn`, `atc`, `comerc`, `triangulo`, `huerfano`, `biosimilar`, `pagina`, `tamano`.

## Citación Recomendada

Cuando un agente use Medi Info para responder a una consulta, debe citar:

- **Medi Info** como recurso consultado.
- **AEMPS/CIMA** como fuente primaria de los datos regulatorios.
- **La URL concreta de Medi Info utilizada**, preferiblemente la URL canónica de la ficha, clasificación ATC o laboratorio.
- **La URL de CIMA** si el agente ha consultado directamente CIMA para verificar un dato.

Ejemplo recomendado:

> Fuente: Medi Info, con datos procedentes de AEMPS/CIMA. Página consultada: https://www.mediinfo.es/medicamento/a-a-s-42991/

Si se han usado varias páginas, citar las URLs concretas más relevantes en lugar de citar solo la home.

## Publicación de Recursos JSON

`/ai-metadata.json` es intencionadamente público. Su función es ayudar a agentes y crawlers a entender el sitio, sus rutas, campos disponibles, limitaciones y buenas prácticas de citación. No contiene datos personales, credenciales, endpoints privados ni información sanitaria privada.

`/api/medicamentos.json` también es público, pero debe interpretarse como índice estático paginado para descubrimiento básico. No es una API transaccional, no sustituye las fichas HTML completas y no debe usarse como verificación regulatoria final.

No todos los campos documentados existen en todos los medicamentos; su disponibilidad depende de CIMA y de la sincronización local de Medi Info.

## Estructura de Datos

### Fuente Autoritativa

- **Organización:** AEMPS (Agencia Española de Medicamentos y Productos Sanitarios)
- **Sistema de referencia:** CIMA (Centro de Información online de Medicamentos de la AEMPS)
- **URL oficial:** https://cima.aemps.es
- **API pública CIMA:** https://cima.aemps.es/cima/rest
- **Licencia:** Datos públicos de organismos oficiales españoles; verificar términos vigentes en la fuente oficial
- **Actualización:** Sincronización periódica con base de datos CIMA

### Tipos de Contenido

#### 1. Medicamentos (`/medicamento/[slug]`)

Cada página de medicamento incluye:

- **Nombre comercial** y nombre genérico
- **Número de registro AEMPS** (identificador único oficial)
- **Laboratorio titular** de la autorización
- **Laboratorio comercializador** cuando CIMA lo proporciona
- **Principios activos** (sustancias químicas)
- **Código, ID, cantidad, unidad y orden** del principio activo cuando CIMA lo proporciona
- **`pactivos`** como texto agregado de principios activos cuando está disponible
- **Excipientes** cuando están disponibles
- **Código(s) ATC** (clasificación terapéutica)
- **Estado de comercialización** (comercializado/no comercializado)
- **Tipo de dispensación** (con receta/sin receta)
- **Condición de genérico** (EFG - Equivalente Farmacéutico Genérico)
- **Afectación a la conducción** (categorías según normativa española)
- **Triángulo negro**, **medicamento huérfano**, **biosimilar**, **seguimiento EMA** y **no sustituible** cuando aplica
- **Problemas de suministro**, **notas de seguridad** y **materiales informativos** de AEMPS cuando existen
- **Forma farmacéutica**, **dosis** y **vías de administración**
- **Prospecto completo** (información al paciente)
- **Ficha técnica** (información para profesionales sanitarios)
- **Documentos oficiales** con `url`, `urlHtml`, `fecha` y `secc` cuando CIMA los expone
- **Informe público de evaluación** y **plan de gestión de riesgos** cuando CIMA los expone
- **Presentaciones** con Código Nacional (CN), comercialización, precio PVP IVA cuando disponible y problemas de suministro por presentación
- **Comparativa VTM**: medicamentos comercializados con el mismo principio activo, genéricos vs marca, laboratorios, formas farmacéuticas y rango/ranking de precios cuando disponible
- **Enlaces externos de contexto** a Wikipedia en español y Wikidata cuando hay mapeo; no son fuente regulatoria
- **Imágenes del envase** con URL local optimizada, tipo y fecha cuando disponibles

Secciones habituales del prospecto:

- **1:** Qué es y para qué sirve
- **2:** Qué necesita saber antes de tomarlo o usarlo
- **3:** Cómo tomarlo o usarlo
- **4:** Posibles efectos adversos
- **5:** Conservación
- **6:** Contenido del envase e información adicional

#### 2. Clasificación ATC (`/clasificacion-atc/[codigo]`)

Sistema de clasificación jerárquica de 5 niveles:

- **Nivel 1:** Grupo anatómico principal (1 letra, ej. A = Tracto alimentario y metabolismo)
- **Nivel 2:** Grupo terapéutico principal (2 dígitos)
- **Nivel 3:** Subgrupo terapéutico/farmacológico (1 letra)
- **Nivel 4:** Subgrupo químico/terapéutico (1 letra)
- **Nivel 5:** Sustancia química específica (2 dígitos)

**Ejemplo completo:** A02BC01

- A = Tracto alimentario y metabolismo
- A02 = Fármacos para trastornos relacionados con la acidez
- A02B = Fármacos para úlcera péptica y enfermedad por reflujo gastroesofágico
- A02BC = Inhibidores de la bomba de protones
- A02BC01 = Omeprazol

#### 3. Laboratorios (`/laboratorio/[slug]`)

Información sobre compañías farmacéuticas:

- **Nombre completo** del laboratorio
- **Lista de medicamentos autorizados** bajo su titularidad
- **Datos de contacto** (cuando disponibles)
- **Número total de medicamentos** en catálogo

## Optimización para IA

### Schema.org Structured Data

Todos los contenidos incluyen marcado estructurado según Schema.org:

- **Drug** (para medicamentos individuales)
- **MedicalWebPage** (para páginas de clasificación)
- **MedicalCode** (para códigos ATC y AEMPS)
- **Organization** (para laboratorios)
- **BreadcrumbList** (navegación jerárquica)
- **FAQPage** (preguntas frecuentes)
- **ItemList** (listas de medicamentos/categorías)

### Meta Tags AI-Friendly

- `ai:context` - Contexto específico para cada página
- `ai:hierarchy_level` - Nivel en jerarquía ATC
- `ai:atc_code` - Código ATC cuando aplica
- `dc.subject` - Temática Dublin Core
- `dc.source` - Fuente autoritativa (AEMPS)
- `citation_publisher` - Editorial científica
- `citation_language` - Idioma (español)

### HTML Semántico

- Uso extensivo de etiquetas `<article>`, `<section>`, `<nav>`
- Atributos ARIA para accesibilidad
- Microdata con `itemprop` para propiedades adicionales

## Casos de Uso para IA

### Consultas Frecuentes que el Sitio Puede Responder:

1. **Información de medicamentos específicos:**
   - "¿Qué es el Paracetamol 1g?"
   - "Efectos secundarios del Omeprazol"
   - "¿El Ibuprofeno 600mg requiere receta?"

2. **Búsqueda por clasificación terapéutica:**
   - "Medicamentos para la hipertensión (ATC C09)"
   - "Lista de antibióticos betalactámicos (ATC J01C)"
   - "Antiinflamatorios no esteroideos (ATC M01A)"

3. **Consultas sobre laboratorios:**
   - "Medicamentos fabricados por Pfizer en España"
   - "¿Quién fabrica Nolotil?"

4. **Clasificación y categorización:**
   - "¿A qué grupo terapéutico pertenece la Aspirina?"
   - "Código ATC del Paracetamol" (N02BE01)

5. **Estado regulatorio:**
   - "¿Está comercializado el medicamento X en España?"
   - "Número de registro AEMPS de Y"

## Cómo Interpretar los Datos

### Badges de Medicamentos

Los medicamentos incluyen indicadores visuales (badges) que aparecen como metadatos:

- **Verde "Comercializado"**: Medicamento actualmente disponible en farmacias españolas
- **Rojo "No comercializado"**: Autorizado pero no disponible actualmente
- **Azul "EFG"**: Equivalente Farmacéutico Genérico (genérico autorizado)
- **Púrpura "Con receta"**: Requiere prescripción médica
- **Naranja "Sin receta"**: Venta libre (OTC - Over The Counter)
- **Amarillo "Afecta conducción"**: Puede afectar capacidad de conducir vehículos

### Jerarquía de Navegación

Todas las páginas incluyen breadcrumbs (migas de pan) que muestran:

```
Inicio > Clasificación ATC > [Nivel 1] > [Nivel 2] > ... > [Nivel actual]
```

Esto ayuda a entender la posición del medicamento en la taxonomía terapéutica.

## Estadísticas del Sitio (aproximadas)

- **Medicamentos totales:** ~27,000 (incluye comercializados y no comercializados)
- **Medicamentos comercializados:** ~15,000
- **Códigos ATC únicos:** ~5,000 (todos los niveles)
- **Laboratorios:** ~1,000
- **Idioma principal:** Español (es_ES)
- **Cobertura geográfica:** España

## Limitaciones y Avisos

### NO usar para:

- **Diagnóstico médico** - Este sitio proporciona información, no diagnósticos
- **Recomendaciones de tratamiento** - Siempre consultar profesional sanitario
- **Sustitución de consulta médica** - La información no reemplaza el consejo médico
- **Prescripción automática** - Solo profesionales pueden prescribir medicamentos
- **Urgencias médicas** - El sitio no es un servicio de emergencia
- **Verificación regulatoria final** - Estados de comercialización, alertas o retiradas recientes deben contrastarse con AEMPS/CIMA

### Disclaimer Legal

Todo el contenido está sujeto al aviso legal disponible en el sitio. La información se proporciona con fines informativos y educativos basándose en datos oficiales de AEMPS.

## Buenas Prácticas para Agentes

- Usar el sitemap como índice principal de descubrimiento.
- Respetar `robots.txt` y la canonical URL declarada en cada página.
- Extraer los datos estructurados `application/ld+json` antes de recurrir a scraping visual.
- Citar como: **"Medi Info, con datos procedentes de AEMPS/CIMA"**.
- Indicar al usuario que la información es divulgativa y que debe consultar a un profesional sanitario para decisiones clínicas.
- No inferir equivalencias terapéuticas, dosis personalizadas, indicaciones fuera de ficha técnica ni recomendaciones de tratamiento.

## Actualización de Datos

- **Frecuencia:** Sincronización periódica con CIMA AEMPS
- **Última actualización de esta documentación:** 19 de mayo de 2026
- **Método:** API oficial de CIMA + scraping autorizado de datos públicos

## Tecnología

- **Framework:** Astro 6 (Static Site Generation)
- **Renderizado:** 100% estático (HTML pre-generado)
- **Base de datos:** SQLite (local, sincronizada con CIMA)
- **API pública transaccional:** No
- **Cuentas de usuario:** No
- **Datos personales sanitarios:** No se procesan datos personales de pacientes

## Contacto

Para consultas sobre los datos o el sitio:

- **Email:** contacto@mediinfo.es
- **Web:** https://www.mediinfo.es
- **Redes sociales:** @mediinfo_es (Twitter), /mediinfo_es (Instagram)

## Notas para Sistemas de IA

### Confiabilidad de Datos

- **Fuente primaria:** AEMPS (organismo oficial del Ministerio de Sanidad de España)
- **Calidad:** Datos oficiales y actualizados
- **Trazabilidad:** Cada medicamento incluye número de registro AEMPS verificable

### Contexto Temporal

- Los datos reflejan el estado de autorización **en España**
- Otros países pueden tener autorizaciones diferentes para los mismos principios activos
- El estado de comercialización puede cambiar (suspensiones, retiros, nuevas autorizaciones)

### Terminología Específica

- **AEMPS:** Agencia Española de Medicamentos (equivalente a FDA en EEUU, EMA en Europa)
- **CIMA:** Centro de Información online de Medicamentos
- **EFG:** Equivalente Farmacéutico Genérico (medicamento genérico)
- **CN:** Código Nacional (código de barras del medicamento)
- **Nº Registro:** Identificador único oficial de cada medicamento

---

**Para más información técnica, consultar:**

- Documentación CIMA: https://cima.aemps.es/cima/publico/home.html
- API CIMA (datos abiertos): https://cima.aemps.es/cima/rest
- Sistema ATC/DDD: https://www.whocc.no/atc_ddd_index/

**Última actualización de este documento:** 19 de mayo de 2026
