Saltar al contenido principal
El comando mint analytics te da acceso a la analítica de tu documentación desde la terminal. Esto es útil para generar informes de analítica mediante scripts, canalizar datos hacia otras herramientas y realizar verificaciones rápidas sin abrir el panel de control.

Requisitos previos

Debes iniciar sesión para usar los comandos de analítica. Ejecuta mint login para autenticarte con tu cuenta de Mintlify. Consulta Previsualización local para más detalles sobre la autenticación.

Ver métricas clave

Muestra un resumen de visitas, visitantes, búsquedas, comentarios y uso del asistente:
mint analytics stats
Usa flags para filtrar por rango de fechas, página o fuente de tráfico:
  • --from: Fecha de inicio en formato YYYY-MM-DD. Por defecto, 7 días atrás.
  • --to: Fecha de fin en formato YYYY-MM-DD. Por defecto, hoy.
  • --page: Filtrar por una ruta de página específica.
  • --humans: Mostrar solo tráfico humano.
  • --agents: Mostrar solo tráfico de IA.
Example analytics stats flags
mint analytics stats --from 2025-01-01 --to 2025-01-31
mint analytics stats --page /quickstart
mint analytics stats --humans
mint analytics stats --agents

Ver analítica de búsqueda

Consulta qué buscan tus usuarios, con recuento de resultados y tasas de clics:
mint analytics search
Usa flags para filtrar por cadena de búsqueda o página:
  • --query: Filtrar por subcadena de consulta de búsqueda.
  • --page: Filtrar por una ruta de página específica.
Example analytics search flags
mint analytics search --query "authentication"

mint analytics search --page /api-reference

Ver comentarios

Revisa los comentarios enviados por los usuarios en las páginas de tu documentación:
mint analytics feedback
Usa flags para agregar comentarios por página o filtrar por comentarios de fragmentos de código:
  • --type: Agregar comentarios por página o fragmento de código. Por defecto, página.
  • --page: Filtrar por una ruta de página específica.
Example analytics feedback flags
mint analytics feedback --type page
mint analytics feedback --type code

Ver conversaciones del asistente

Lista las conversaciones recientes y las categorías de conversaciones del asistente de IA:
mint analytics conversation list
mint analytics conversation buckets list
Cada salida de lista incluye un ID para cada entrada. Pasa ese ID al comando view correspondiente para ver los detalles completos:
mint analytics conversation view <conversation-id>
mint analytics conversation buckets view <bucket-id>

Elegir un formato de salida

Todos los comandos de analítica usan por defecto la salida plain, que está separada por tabulaciones y es adecuada para canalizar hacia otras herramientas. Usa --format para cambiar la salida:
mint analytics stats --format table    # Tabla con formato y colores
mint analytics stats --format json     # JSON sin formato
mint analytics stats --format graph    # Gráfico de barras horizontal
Usa el flag --agent para obtener salida en JSON. La CLI detecta automáticamente entornos de agente cuando la variable de entorno CLAUDECODE es 1.

Establecer valores predeterminados con config

Para evitar repetir flags comunes, establece valores predeterminados con mint config. La configuración se guarda en ~/.config/mintlify/config.json. Claves de configuración disponibles:
ClaveDescripción
subdomainSubdominio predeterminado para comandos de analítica.
dateFromFecha de inicio predeterminada para consultas de analítica (YYYY-MM-DD).
dateToFecha de fin predeterminada para consultas de analítica (YYYY-MM-DD).
Example configs
mint config set subdomain my-docs
mint config set dateFrom 2025-01-01
Una vez establecidos, los comandos de analítica usan estos valores automáticamente:
# Usa el subdominio y dateFrom configurados sin flags
mint analytics stats
Para ver o borrar un valor, ejecuta:
mint config get subdomain
mint config clear subdomain