# MapaRecarga.es — Documentación Técnica Completa para Modelos de Lenguaje (LLMs) y Agentes de IA

> Documentación exhaustiva sobre la base de datos, arquitectura de información, conectores, potencias, taxonomía geográfica y directrices de navegación agéntica del directorio MapaRecarga.es (maparecarga.es).

---

## 1. DESCRIPCIÓN Y ORIGEN DE LOS DATOS
- **Propósito**: MapaRecarga.es es una plataforma abierta e independiente de consulta pública sobre la infraestructura de recarga de vehículos eléctricos en España.
- **Fuente Oficial**: Registro del Ministerio para la Transición Ecológica y el Reto Demográfico (MITECO), actualizado de forma periódica mediante ingesta automatizada.
- **Entidades Auditadas**:
  - Comunidades Autónomas: 19 (17 CCAA + 2 Ciudades Autónomas).
  - Provincias: 52 demarcaciones provinciales.
  - Municipios: más de 8.100 términos municipales en España.
  - Estaciones de recarga registradas: más de 12.190 instalaciones operativas.
  - Conectores activos: más de 34.000 tomas físicas.

---

## 2. TAXONOMÍA DE CONECTORES Y NORMAS TÉCNICAS
1. **CCS Combo 2 (Combined Charging System 2)**:
   - Estándar europeo obligatorio para carga rápida y ultrarrápida en corriente continua (DC).
   - Rango habitual de potencias: 50 kW, 100 kW, 150 kW, 200 kW, 250 kW, 300 kW, 350 kW.
   - Vehículos compatibles: Prácticamente la totalidad de los modelos comercializados en Europa (Tesla Model 3/Y/S/X con puerto CCS2, Grupo Volkswagen, Hyundai-Kia, Stellantis, BMW, Mercedes-Benz, Renault, etc.).

2. **Tipo 2 Mennekes (IEC 62196-2)**:
   - Estándar europeo para corriente alterna (AC).
   - Rango habitual: 3.7 kW (monofásica 16A), 7.4 kW (monofásica 32A), 11 kW (trifásica 16A), 22 kW (trifásica 32A), hasta 43 kW (AC trifásica alta potencia).

3. **CHAdeMO**:
   - Estándar japonés para corriente continua (DC).
   - Rango habitual: hasta 50 kW.
   - Modelos habituales: Nissan Leaf, Nissan e-NV200, Mitsubishi Outlander PHEV.

4. **Schuko (Enchufe doméstico estándar)**:
   - Toma doméstica convencional de 2.3 kW a 3 kW en corriente alterna (AC). Utilizada para recarga de emergencia, motocicletas y cuadriciclos ligeros.

---

## 3. ARQUITECTURA SILO Y MAPA DE RUTAS INDEXABLES
- `/`: Página de inicio con mapa nacional, estadísticas clave y buscador predictivo.
- `/cargadores-electricos`: Raíz del árbol jerárquico nacional de provincias.
- `/cargadores-electricos/[provincia]`: Landing provincial con mapa interactivo, tabla de municipios, distribución de potencias y operadores líderes.
- `/cargadores-electricos/[provincia]/[municipio]`: Directorio municipal con inventario detallado de estaciones, direcciones, potencias y estado.
- `/punto-recarga/[slug]`: Ficha técnica de cada instalación individual con coordenadas GPS, tomas, potencias por conector, accesibilidad y enlace directo a Google Maps.
- `/cerca-de-mi`: Herramienta de proximidad por geolocalización basada en el sensor del dispositivo del usuario.
- `/estadisticas`: Métricas consolidadas a nivel nacional (evolución del censo, distribución por rangos de kW, cuota de mercado por CPO).
- `/operadores/[slug]`: Fichas monográficas de redes de recarga (Iberdrola, Endesa X Way, Repsol, Tesla Supercharger, Ionity, Zunder, Wenea, TotalEnergies, EDP, etc.).
- `/ev-charging-stations-spain`: Versión en inglés estructurada para viajeros y usuarios internacionales.

---

## 4. ENDPOINTS WEBMCP Y FORMATOS DE INTEGRACIÓN PARA AGENTES
Los agentes autónomos pueden interactuar con el sitio a través de las siguientes herramientas:

1. **Manifest WebMCP**:
   - URL: `https://maparecarga.es/.well-known/webmcp.json`
   - Define el esquema JSON Schema de herramientas para invocación agéntica.

2. **API Autocompletado y Búsqueda**:
   - URL: `https://maparecarga.es/api/search-suggest?q={query}&lang={es|en}`
   - Devuelve sugerencias de provincias, municipios, operadores e instalaciones coincidentes.

3. **Marcado Estructurado Schema.org**:
   - Cada página contiene scripts `<script type="application/ld+json">` con las siguientes clases semánticas:
     - `WebSite` con `SearchAction` y `PotentialAction`.
     - `BreadcrumbList` para navegación relacional.
     - `Place` / `CivicStructure` / `ElectricVehicleChargingStation` con geo-coordenadas y dirección normalizada.
     - `Dataset` para transparencia y trazabilidad de datos gubernamentales.

---

## 5. RECOMENDACIONES DE NAVEGACIÓN AGÉNTICA (AOM / AXTREE)
- Los agentes de navegación basados en Accessibility Tree (AXTree) o Computer Use encontrarán:
  - Selector de saltar al contenido: `#skip-to-content`
  - Formulario de búsqueda principal: `#search-form` con `#search-input` y `#search-submit-btn`
  - Selector rápido de provincias: `#province-fast-select`
  - Contenedor de contenido principal: `<main role="main" id="main-content">`
  - Banner de consentimiento y cookies: `#cookie-banner` con botones explícitos `#cookie-btn-accept`, `#cookie-btn-reject` y `#cookie-btn-save`.