# Visibilidad

Bison corre cada semana tu set de preguntas de compra en los asistentes de IA y mide cómo aparece tu marca en las respuestas. Estos son los números que recibe tu agente y cómo leerlos.

## Las métricas

| Campo | Qué mide | Escala |
| --- | --- | --- |
| `visibility` | Puntaje general de la marca. Combina qué tan seguido te mencionan, qué tan seguido te citan, en qué posición apareces y con qué sentimiento. | 0 a 100 |
| `mentionRate` | En qué porcentaje de las respuestas aparece tu marca. | 0 a 100 |
| `shareOfVoice` | Qué parte de la conversación ocupa tu marca frente a las demás marcas que aparecen en las respuestas. | 0 a 100 |
| `citationRate` | Con qué frecuencia las respuestas te citan como fuente. | 0 a 100 |
| `positiveSentiment` | Qué tan positivo es el sentimiento hacia tu marca en las respuestas. | 0 a 100 |
| `avgPosition` | Lugar promedio en el que aparece tu marca cuando la mencionan. 1 es la primera marca nombrada: un número más bajo es mejor. | 1 en adelante |
| `executions` | Cuántas veces se corrieron las preguntas esa semana. Más ejecuciones, números más estables. | entero |

> **`null` no es cero:** Un valor `null` significa que no hay datos: la semana no se midió o ese modelo no corrió. Cero significa que se midió y tu marca no apareció. Tu agente no debería tratarlos igual.

## Semanas y cambios

- **Última semana medida.** Es la semana más reciente con puntaje entre las cuatro últimas. Si una corrida falló o quedó incompleta, esa semana se salta. Si ninguna de las cuatro tiene puntaje, la respuesta dice que aún no hay reportes.
- **Cómo se compara.** El cambio (`visibilityChange`, `mentionRateChange`) es la diferencia en puntos porcentuales contra la semana con puntaje anterior. Si esa semana no es la inmediata, la respuesta lo avisa en `notes` e indica cuántas semanas hay entre las dos.
- **Fechas.** Cada semana se identifica con una fecha `AAAA-MM-DD`.
- **Decimales.** Los porcentajes de `get_visibility_summary` y de la tendencia llevan un decimal; algunas tablas, como las de competidores y preguntas de la comparación semanal, vienen redondeadas a enteros.

## Por modelo

Los números se desglosan por modelo: ChatGPT, Gemini, Perplexity y Claude. Un modelo con `measured: false` no tuvo ejecuciones esa semana: no está contratado en tu plan o no corrió. Ver [Planes y modelos](https://docs.bisonagents.com/mcp/conceptos/planes-y-modelos/).

## Tendencia y línea base

La tendencia agrupa las semanas por mes y muestra el promedio de cada uno. Se compara contra una línea base que queda fija: la primera semana «completa», es decir, la primera en la que se midió al menos el 75 % de las preguntas del máximo de las cuatro primeras semanas. Así una primera semana con pocas preguntas no distorsiona la comparación.

## Herramientas que los devuelven

- [`get_visibility_summary`](https://docs.bisonagents.com/mcp/herramientas/get_visibility_summary/)
- [`get_visibility_trend`](https://docs.bisonagents.com/mcp/herramientas/get_visibility_trend/)
- [`compare_weeks`](https://docs.bisonagents.com/mcp/herramientas/compare_weeks/)
- [`compare_competitors`](https://docs.bisonagents.com/mcp/herramientas/compare_competitors/)
- [`get_prompt_detail`](https://docs.bisonagents.com/mcp/herramientas/get_prompt_detail/)