Funciones

Todo lo que necesitas, y nada más allá.

SimpleCMP se compone de cuatro componentes claramente separados: engine, recorder, cliente de service-DB y CMS-bridge. Usas solo lo que necesitas y sustituyes cada pieza por tu propia implementación cuando haga falta.

Engine

Máquina de estados sin UI.

La engine conoce el estado de consentimiento por servicio, el bus de eventos, el almacenamiento en localStorage / cookie, la resolución de idioma y la lógica click-to-enable. Sin ninguna suposición sobre el DOM.

Si solo necesitas la máquina de estados — por ejemplo, para renderizar tu propio banner en una SPA de Vue, React o Svelte —, importa directamente desde simplecmp/engine. El bundle es bastante más pequeño que el paquete completo con la UI de Lit.

// Vue 3 SFC
import { getManager, addEventListener }
  from 'simplecmp/engine';

const manager = getManager({
  storageName: 'simplecmp-app',
  services: [...]
});

addEventListener('saveConsents',
  (consents) => console.log(consents)
);

manager.updateConsent('ga', true);
manager.saveConsents();

Recorder

Detección automática en lugar de catalogar a mano.

El recorder vigila tres fuentes a la vez: la creación de cookies mediante document.cookie, la inserción de etiquetas <script>, <iframe>, <img> y <link> (MutationObserver) y las conexiones salientes a través de la API PerformanceObserver.

  1. Actívalo en el build de desarrollo

    Una única llamada a startRecorder() en el punto de inicialización de tu app.

  2. Navega por el sitio con normalidad

    Cada nuevo tracker se clasifica automáticamente (local + consulta a la service-DB).

  3. Exporta la configuración

    recorder.exportConfig() devuelve una configuración de servicios lista para producción.

  4. Blinda tu CI

    assertNoUnknown() hace fallar el build si aparece un tracker que no está en el catálogo.

$ pnpm dev
[recorder] watching cookies, scripts, requests…
[recorder] known: _ga         (Google Analytics)
[recorder] known: _gid        (Google Analytics)
[recorder] UNKNOWN: _fbp     .example.com
[recorder] UNKNOWN: req      connect.facebook.net
[recorder] classified via service-db: meta-pixel
[recorder] ✓ no unclassified detections

// recorder.exportConfig() →
{
  services: [
    { name: 'google-analytics', cookies: [/^_ga/, '_gid'] },
    { name: 'meta-pixel', cookies: ['_fbp'], hosts: ['connect.facebook.net'] }
  ]
}

Service-DB

Un registro abierto, sin ataduras a un proveedor.

La service-DB habla un protocolo HTTP/JSON sencillo. El cliente consulta cada identificador desconocido (cookie, host, URL de script) y recibe, si lo conoce, la clasificación: nombre del servicio, etiquetas de finalidad, textos estándar en 26 idiomas y política de privacidad por defecto.

El caché stale-while-revalidate mantiene la UX rápida; un clasificador local de respaldo entra en juego si hay errores de red. Los plugins de CMS (como la extensión de TYPO3) incluyen su propia implementación del protocolo, de modo que las clasificaciones se pueden curar incluso sin dependencias externas.

360+ servicios Referencia PHP+SQLite PRs de la comunidad
// GET https://library.simplecmp.eu/v1/lookup
//     ?kind=cookie&identifier=_ga

{
  "hit": true,
  "service": {
    "name": "google-analytics",
    "title": "Google Analytics",
    "purposes": ["analytics"],
    "cookies": ["/^_ga/", "_gid"],
    "hosts": [
      "www.google-analytics.com",
      "analytics.google.com"
    ],
    "privacyPolicy":
      "https://policies.google.com/privacy",
    "translations": { /* 26 idiomas */ }
  },
  "cache_until": "2026-05-26T00:00:00Z"
}

CMS-Bridge

Detecta el drift de producción antes de que salga caro.

Un test A/B activa Hotjar. Un píxel de marketing aterriza en la landing page vía tag manager. Un plugin antiguo empieza de repente a establecer una cookie nueva. La CMS-bridge te avisa de cada uno de estos drifts.

  • Esquema v2: detecciones por lotes, campo status, controles de ancho de banda
  • Autenticación HMAC con nonce que evita ataques de replay
  • Deduplicación por identificador con TTL configurable (1 h por defecto)
  • Tasa de muestreo ajustable, por si el tráfico es enorme
  • Receptor de webhooks como ejemplo en Node en el repo
Navegador el recorder detecta un tracker desconocido POST /webhook HMAC-signed CMS verifies signature deduplicates DB detections table status: unknown Módulo backend Editor revisa categoriza aprobar → Service-Library

Region-Engine

UE opt-in. California opt-out. Un solo código.

El RGPD (DSGVO) exige opt-in. La CCPA/CPRA exige opt-out más un enlace «Do Not Sell or Share My Personal Information». SimpleCMP detecta la región del visitante y cambia automáticamente entre ambos regímenes: sin código a medida y sin API de geolocalización por IP.

  • Resolución región→régimen mediante resolveRegime (p. ej. DE → optIn, US-CA → optOut)
  • Banner opt-out con disparador Do-Not-Sell en lugar del modal de aceptar/rechazar
  • API pública: region, regimeDefault, regimes para UIs propias
  • Configurable: override de región vía configuración, sin ataduras a un proveedor de geolocalización
// La región se determina automáticamente
init({
  region: 'auto', // 'DE' | 'US-CA' | …
  regimes: {
    optIn:  { services: [...] },
    optOut: { services: [...] }
  }
});

// API pública para UI propia:
manager.region;          // 'US-CA'
manager.regimeDefault;   // 'optOut'

// El banner CCPA muestra automáticamente:
"Do Not Sell or Share
 My Personal Information"

Audit-Engine

Comprobación de cumplimiento directamente en el navegador.

Añade ?simplecmp_audit=1 a tu URL y SimpleCMP se ejecuta en vivo en modo cumplimiento: un panel lista cada incumplimiento del §4 del documento de cumplimiento legal con su severidad, selector e indicación de cómo corregirlo.

Las comprobaciones no se limitan a la configuración estática: auditDom() lee el banner renderizado y avisa de botones de rechazo débiles, mensajes de presión comercial, nombres accesibles ausentes y objetivos de menos de 44 px. Es la engine con la que probamos nuestro propio banner, y forma parte del bundle.

$ open https://example.com/?simplecmp_audit=1

[audit] AUDIT-MODE aktiviert
[audit] critical equal-button-styling
   Decline-Button hat geringeren Kontrast als Accept
   selector: button.cn-decline
[audit] warning  weak-decline-copy
   "Ablehnen"-Text zu schwach (heuristisch erkannt)
[audit] warning  marketing-nudge
   Description enthält Werbe-Sprache
[audit] warning  accessible-name-missing
   Floating-Trigger ohne aria-label
[audit] ok       imprint-link-present
[audit] ok       reject-all-equal-prominence
[audit] ok       target-size-44px

Más funciones

La letra pequeña que de verdad importa.

26 paquetes de idioma

Incluye alemán, inglés, francés, italiano, español, neerlandés, polaco, turco, checo, sueco y más. Detección automática mediante <html lang>.

Embeds click-to-enable

Los embeds bloqueados de YouTube, Vimeo o Maps reciben automáticamente un aviso inline con el tema del sitio. La concesión se hace por servicio, sin que vuelva a aparecer todo el modal.

Bloqueo previo al consentimiento

Bloqueo universal mediante los marcadores data-name y data-src. Los scripts e iframes ni siquiera se cargan antes de que haya consentimiento: sin riesgo de race conditions.

Valores por defecto RGPD

«Rechazar todo» tiene el mismo peso que «Aceptar todo»: es el valor por defecto, no un opt-in (sentencia Cookie II del BGH, DSK 2022). El enlace al Impressum va separado de la política de privacidad.

Web Components basados en Lit

Custom Elements (<simplecmp-banner>, <simplecmp-modal>) con Shadow DOM. Opcionalmente Light DOM para ajustes de CSS en profundidad.

Señales de consentimiento del navegador

Respeta Sec-GPC (Global Privacy Control) y la señal de cabecera DNT. Comportamiento configurable: rechazo automático, ocultar el banner o confirmación explícita.

Adaptadores de tema

CSS listo para usar con Bootstrap 5, Tailwind v4, Bulma y Pico. Remapeos basados en tokens sobre las variables de cada framework, sin líos de overrides.

Consent Mode v2 (multivendor)

Señales conscientes del proveedor al inicializar y en cada guardado: gtag('consent', …) para Google (GA4/GTM), fbq('consent', …) para Meta Pixel y uetq.push('consent', …) para Microsoft UET, además de su aportación a la política CSP. Para Google Tag Manager, el evento de dataLayer lleva el estado por servicio y por finalidad: exactamente una actualización por cada decisión guardada.

Bloqueo de hojas de estilo

Opt-in opcional (universalBlocking.blockStylesheets): los <link rel="stylesheet"> de terceros como Google Fonts se bloquean antes del consentimiento con block-and-reinject. Una mitigación para el caso del LG München I.

Plantillas de layout del banner

Posicionamiento basado en tokens: las cuatro esquinas, barra inferior o modal centrado; basta un valor de configuración. El equal-button-styling viene integrado en la plantilla (si no, la comprobación de cumplimiento se pondría en rojo).

Overlay tú/usted

Paquete de tono por idioma: en cada locale, un informal.json puede sobrescribir las cadenas formales. Ya disponibles DE, FR, IT, ES y NL. Las webs de marketing consiguen un «¿Permitir cookies?» sin tener que forkear el paquete incluido.

WCAG 2.2 AA / BFSG

Landmark de región, aria-live, focus trap, tamaño de objetivo de 44×44 px y anillos de foco visibles con teclado. Probado en vivo con lector de pantalla en una tienda de desarrollo de Shopify. Relevante para el BFSG (ley alemana de accesibilidad) en e-commerce desde 06/2025.

Modal de información del proveedor

Divulgación por capas en tres pasos conforme al RGPD: banner → aviso contextual → «Más información ›» abre un modal con la entidad legal, la dirección, la URL de privacidad, la URL de opt-out y la base de la transferencia, todo extraído de la service-library.

Matchers de cookies cualificados por host

Las cookies se comparan no solo por nombre, sino también por el host que las establece. Importante cuando varios servicios usan el mismo nombre de cookie (ver ADR-0010).

Revocación limpia

Quien retira un consentimiento también se lleva por delante los datos: las cookies se borran en el dominio propio y en el dominio padre, y las entradas correspondientes de localStorage también.

Matchers de origen con coincidencia de ruta

Dos servicios pueden compartir un mismo host, como Google Maps y reCAPTCHA en www.google.com. Los matchers con ruta asignan cada petición al servicio correcto y se tienen en cuenta los comodines en sameOriginHosts.

Pruébalo ahora en vivo.

La demo interactiva muestra el banner, el modal y el recorder juntos, sin instalar nada.