# Clarity CLI: prepara etiquetas y revisa la instrumentación de tu web

> Genera el fragmento de Clarity y audita tu HTML para comprobar que la medición está configurada antes de revisar métricas exportadas.

Verificado el 26 oct 2026.

## Qué es

Clarity CLI ayuda a instrumentar una web con Microsoft Clarity. Genera fragmentos de JavaScript y atributos HTML, comprueba archivos locales y puede consultar la API de exportación de datos. Forma parte de Printing Press Library y tiene código y documentación propios dentro del catálogo.

## Para qué te sirve

- Cuando añades Clarity a una página y quieres revisar el identificador de proyecto.
- Cuando necesitas comprobar si el HTML contiene las llamadas de instrumentación esperadas.

## Cómo funciona

Los comandos snippet producen código de instalación e identificación. audit inspecciona HTML local. insights live consulta los datos de exportación mediante un token; esa vía es distinta de la instrumentación que se ejecuta en el navegador.

## Antes de empezar

Para generar el fragmento necesitas el identificador de tu proyecto de Clarity. La exportación de métricas requiere un token de Data Export; la generación de snippets no lo necesita. La instalación recomendada con Node y npx incorpora el binario y su skill para agentes; las alternativas están en el README de esta herramienta. La carpeta contiene una licencia Apache-2.0; GitHub no detecta una licencia global para el catálogo.

## Límites y alternativas

No debe presentarse como una descarga general de grabaciones o mapas de calor. La instrumentación necesita tráfico real y una configuración correcta de privacidad. Usa el panel de Clarity para la inspección visual de sesiones.

## Recursos

- [Código de Clarity CLI](https://github.com/mvanhorn/printing-press-library/tree/main/library/marketing/clarity) - carpeta concreta de la herramienta; el repositorio completo tiene 2077 estrellas.
- [README y configuración](https://github.com/mvanhorn/printing-press-library/blob/main/library/marketing/clarity/README.md) - instalación, comandos y diagnóstico.
- [Licencia de esta CLI](https://github.com/mvanhorn/printing-press-library/blob/main/library/marketing/clarity/LICENSE) - Apache-2.0; comprobada en la carpeta.
- [Actividad comprobada](https://github.com/mvanhorn/printing-press-library/commit/d7698149796bc71048f54526e010a1535d808e0c) - último commit del catálogo consultado: 26 oct 2026.
- [Último cambio de esta entrada](https://github.com/mvanhorn/printing-press-library/commit/b815f4cc4ec8054b6fec93c9f9a2e7f2220153ff) - 2026-09-11; comprobado en la API de GitHub.