> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Análisis e informes

> Conoce las herramientas de análisis e informes disponibles a través de Profound MCP

Profound MCP ofrece a los asistentes de IA acceso de solo lectura a los datos de Answer Engine Optimization (AEO), visibilidad de marca, citas, sentimiento, compras y Agent Analytics de Profound. Usa esta página para entender lo que puede hacer el servidor MCP alojado antes de conectarlo a un cliente MCP. Cuando estés listo para conectarte, consulta las [guías de conexión](/es/mcp/common-mcp-clients).

## Cómo funcionan las herramientas en conjunto

La mayoría de las conversaciones comienzan con las [herramientas de descubrimiento](/es/mcp/capabilities/discovery-tools) y luego pasan a los informes. Así es como suele verse:

<Steps>
  <Step title="Confirma el acceso">
    Pregunta qué datos puedes ver. El asistente confirma el usuario que inició sesión, las organizaciones, regiones y permisos disponibles con [`whoami`](/es/mcp/capabilities/discovery-tools#whoami).
  </Step>

  <Step title="Encuentra el alcance adecuado">
    Pregunta por la marca o el sitio que te interesa. El asistente lo resuelve con [`list_organizations`](/es/mcp/capabilities/discovery-tools#list-organizations) y luego con [`list_categories`](/es/mcp/capabilities/discovery-tools#list-categories) para los informes de visibilidad o con [`list_domains`](/es/mcp/capabilities/discovery-tools#list-domains) para los informes de tráfico.
  </Step>

  <Step title="Agrega filtros opcionales">
    Pide acotar la pregunta a un mercado, motor de IA, conjunto de prompts, tema o etiqueta. El asistente resuelve esos filtros con [`list_regions`](/es/mcp/capabilities/discovery-tools#list-regions), [`list_models`](/es/mcp/capabilities/discovery-tools#list-models), [`list_tags`](/es/mcp/capabilities/discovery-tools#list-tags), [`list_topics`](/es/mcp/capabilities/discovery-tools#list-topics) y [`list_prompts`](/es/mcp/capabilities/prompts-capabilities#list-prompts).
  </Step>

  <Step title="Ejecuta un informe">
    Pregunta por lo que quieres que se informe. El asistente obtiene datos de visibilidad, sentimiento, citas, respuestas a prompts, compras, referencias o rastreo de bots para el rango de fechas que indiques.
  </Step>
</Steps>

## Comportamiento y seguridad

Todas las herramientas son de solo lectura. Obtienen datos de análisis, pero no crean, actualizan ni eliminan nada en Profound.

| Comportamiento | Qué significa |
| - | - |
| No destructivo | Ninguna herramienta realiza actualizaciones destructivas |
| Datos en vivo | Las herramientas leen de la API de Profound, por lo que los resultados reflejan el acceso y los datos actuales de quien hace la llamada |

Todas las herramientas de informes establecen las siguientes sugerencias MCP:

| Sugerencia | Valor | Qué significa |
| - | - | - |
| `readOnlyHint` | `true` | La herramienta solo lee datos |
| `idempotentHint` | `true` | Es seguro reintentar la herramienta con los mismos argumentos |

Las fechas son cadenas ISO 8601 en formato `YYYY-MM-DD`. Los informes validan `start_date` y `end_date` y devuelven un error accionable si la ventana de fechas no es válida.

## Informes de visibilidad

Estas herramientas se limitan a un `category_id` y un rango de fechas. Úsalas para entender cómo aparecen las marcas en las respuestas de IA, tanto en las respuestas de texto normales como en los resultados del [modo de compras](https://help.tryprofound.com/articles/8862399588-about-shopping).

### Informes de visibilidad de marca

Usa estas herramientas para entender cómo aparecen las marcas en las respuestas de IA, qué tono tienen esas respuestas, qué tan precisas son y qué fuentes citan los motores de IA.

| Herramienta | Uso |
| - | - |
| `get_visibility_report` | Qué tan visible es una marca en las respuestas de IA y cómo varía por modelo, tema, región, prompt o persona |
| `get_sentiment_report` | Qué sentimiento expresan las respuestas de IA sobre una marca o competidor y qué temas y afirmaciones lo impulsan |
| `get_citations_report` | Qué dominios y páginas citan los motores de IA para esta categoría |
| `get_prompt_answers` | Qué respuestas de IA sin procesar observó Profound detrás de las métricas |
| `get_factcheck_report` | Puntuaciones de FactCheck para una categoría en un rango de fechas |
| `get_factcheck_claims` | Afirmaciones inexactas identificadas en una categoría en un rango de fechas |

<AccordionGroup>
  <Accordion title="get_visibility_report" id="get-visibility-report">
    Mide con qué frecuencia y con qué prominencia aparece una marca en las respuestas de IA para una categoría en un rango de fechas.

    **Prompts de ejemplo**:

    * "¿Qué tan visibles fuimos en las respuestas de IA el mes pasado, desglosado por modelo?"
    * "¿Estamos ganando o perdiendo visibilidad frente a los competidores este trimestre?"

    Métrica predeterminada: `visibility_score`. Las otras métricas son `share_of_voice` y `average_position`.

    `visibility_score` es un decimal sin procesar. Multiplícalo por 100 para que coincida con el porcentaje que muestra la plataforma de Profound, de modo que `0.42` es 42 %.

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría sobre la que informar |
    | `start_date` | Sí | - | Inicio de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `end_date` | Sí | - | Fin de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `group_by` | No | `null` | Agrupa los resultados por `date`, `model`, `topic`, `region`, `prompt` o `persona` |
    | `metrics` | No | `visibility_score` | Métricas que se devuelven: `visibility_score`, `share_of_voice` o `average_position` |
    | `interval` | No | `day` | Tamaño de cada intervalo de tiempo al agrupar por `date`: `day`, `week` o `month` |
    | `scope` | No | `owned` | `owned` para tus marcas rastreadas, o `all` para incluir a los competidores |
    | `assets` | No | `null` | Acota a una o más marcas, por nombre |
    | `topic_filter` | No | `null` | Acota a uno o más temas |
    | `tag_filter` | No | `null` | Acota a una o más etiquetas |
    | `region_filter` | No | `null` | Acota a una o más regiones |
    | `model_filter` | No | `null` | Acota a uno o más modelos de IA, por ID de `list_models` |
    | `persona_filter` | No | `null` | Acota a una o más personas, por ID |
    | `filter` | No | `null` | Expresión de filtro para condiciones que las demás entradas no pueden expresar, como excluir una región o coincidir con cualquiera de dos temas. Se combina con esas entradas mediante `and` |
    | `limit` | No | `null` | Grupos de nivel superior por página, hasta 50 |
    | `cursor` | No | `null` | Token de paginación de `info.next_cursor` |

    **Notas**:

    * Cada fila incluye un objeto `asset` de `{name, owned}`. Los resultados siempre se agrupan por marca además de por `group_by`, por lo que obtienes una fila por marca por intervalo.
    * `limit` limita los grupos de nivel superior en lugar de las filas, por lo que una consulta agrupada devuelve más filas que el límite que establezcas.
  </Accordion>

  <Accordion title="get_sentiment_report" id="get-sentiment-report">
    Mide el sentimiento que expresan las respuestas de IA sobre una marca o competidor en una categoría en un rango de fechas, o el sentimiento de las páginas que esas respuestas citan.

    **Prompts de ejemplo**:

    * "¿Qué tono tienen las respuestas de IA sobre nuestros precios?"
    * "¿Qué páginas citadas son más negativas sobre nuestra marca?"

    El sentimiento proviene de las propias respuestas o de las páginas que citan, y `source` selecciona cuál.

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría sobre la que informar |
    | `asset` | Sí | - | Nombre de la marca o competidor que se analizará |
    | `start_date` | Sí | - | Inicio de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `end_date` | Sí | - | Fin de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `source` | No | `response` | `response` para el tono en las respuestas de IA, `citation` para el tono en las páginas citadas |
    | `group_by` | No | `[]` | Agrupa las filas de respuesta por `date`, `model`, `topic`, `region`, `prompt`, `persona`, `tag`, `theme` o `claim`. Admite como máximo dos agrupaciones que no sean de fecha, más `date` para una serie temporal |
    | `theme` | No | `null` | Acota a un tema de sentimiento, como los precios |
    | `claim` | No | `null` | Acota a una afirmación |
    | `model` | No | `null` | Acota a uno o más modelos de IA |
    | `citation_category` | No | `null` | Acota a una o más categorías de citas, incluidos los nombres de categorías personalizadas |
    | `page_contains` | No | `null` | Acota a las páginas cuya URL contiene este texto. No distingue entre mayúsculas y minúsculas |
    | `citation_sort_by` | No | `citation_share` | Ordena las filas de citas por `citation_share` o `positive_sentiment` |
    | `citation_sort_direction` | No | `desc` | Dirección de ordenación, `asc` o `desc` |
    | `limit` | No | `10` | Filas por página, hasta 50 |
    | `cursor` | No | `null` | Token de paginación de `info.next_cursor` |

    **Notas**:

    * `citation_category`, `page_contains`, `citation_sort_by` y `citation_sort_direction` solo están disponibles cuando `source` es `citation`; de lo contrario, devuelven un error.
    * Los filtros acotan los resultados, pero nunca los agrupan. Cuando `source` es `citation`, `model` cambia qué páginas califican y su cuota de citas, pero el sentimiento sigue siendo el de la página, no el del modelo.
  </Accordion>

  <Accordion title="get_citations_report" id="get-citations-report">
    Muestra qué fuentes citan los motores de IA para una categoría, y con qué frecuencia, en un rango de fechas.

    **Prompts de ejemplo**:

    * "¿Qué sitios citan más los motores de IA en nuestra categoría?"
    * "¿Con qué frecuencia citan las respuestas de IA nuestro propio dominio?"

    Métricas predeterminadas: `count` y `citation_share`. `count` es la frecuencia de citas sin procesar, y `citation_share` se promedia por modelo de IA para que siga siendo comparable entre modelos.

    Sin `group_by`, cada fila es un dominio citado, ordenado del más citado al menos citado. Usa este valor predeterminado para encontrar qué sitios citan más los motores de IA.

    <Note>
      `group_by: ["page"]` devuelve una fila por página citada y no se puede combinar con `scope: "owned"` ni con `domain_filter`, ya que ambos acotan a un dominio.
    </Note>

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría sobre la que informar |
    | `start_date` | Sí | - | Inicio de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `end_date` | Sí | - | Fin de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `group_by` | No | `null` | Agrupa los resultados por `page`, `date`, `model`, `topic`, `region`, `persona` o `prompt` |
    | `metrics` | No | `count`, `citation_share` | Métricas que se devuelven: `count`, `citation_share`, `rank` o `first_cited_at` |
    | `interval` | No | `day` | Tamaño de cada intervalo de tiempo al agrupar por `date`: `day`, `week` o `month` |
    | `scope` | No | `all` | `all` para cubrir todos los dominios citados, u `owned` para acotar a tus propios dominios |
    | `topic_filter` | No | `null` | Acota a uno o más temas |
    | `region_filter` | No | `null` | Acota a una o más regiones |
    | `model_filter` | No | `null` | Acota a uno o más modelos de IA, por ID de `list_models` |
    | `persona_filter` | No | `null` | Acota a una o más personas, por ID |
    | `domain_filter` | No | `null` | Acota a uno o más dominios, incluidos sus subdominios |
    | `page_filter` | No | `null` | Acota a una o más URL de página |
    | `citation_category_filter` | No | `null` | Acota a una o más categorías de citas, como `owned` o `social` |
    | `analysis_type_filter` | No | `null` | Acota a un tipo de análisis: `visibility`, `sentiment`, `factcheck` o `all` |
    | `filter` | No | `null` | Expresión de filtro para condiciones que las demás entradas no pueden expresar, como excluir una región o coincidir con cualquiera de dos temas. Se combina con las demás entradas de filtro mediante `and` |
    | `limit` | No | `null` | Grupos de nivel superior por página, hasta 50 |
    | `cursor` | No | `null` | Token de paginación de `info.next_cursor` |

    **Notas**:

    * Cada fila incluye un `rank`, donde `1` es el más citado. `first_cited_at` solo se devuelve en las filas de página.
    * `limit` limita los grupos de nivel superior en lugar de las filas, por lo que una consulta agrupada devuelve más filas que el límite que establezcas.
  </Accordion>

  <Accordion title="get_prompt_answers">
    Obtiene las respuestas que dieron los motores de IA a los prompts de una categoría en un rango de fechas: el texto sin procesar detrás de las métricas de visibilidad.

    **Prompts de ejemplo**:

    * "¿Qué respondieron los motores de IA a nuestros prompts de ahorro la semana pasada?"
    * "Trae las respuestas detrás de la caída de visibilidad del mes pasado."

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría para la que se obtienen las respuestas a prompts |
    | `start_date` | Sí | - | Inicio de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `end_date` | Sí | - | Fin de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `prompt_id` | No | `null` | Acota los resultados a un solo prompt |
    | `country` | No | `null` | Acota a uno o más países, por nombre o ID. No se puede combinar con `region` |
    | `region` | No | `null` | Acota a una o más regiones, por nombre o ID. No se puede combinar con `country` |
    | `topic_ids` | No | `null` | Acota a uno o más temas, por ID de `list_topics` |
    | `model_ids` | No | `null` | Acota a uno o más modelos de IA que respondieron, por ID de `list_models` |
    | `limit` | No | `100` | Filas por página |
    | `offset` | No | `0` | Desplazamiento de filas para la paginación |

    **Notas**:

    * Varios ID en una lista coinciden con cualquiera de esos ID. Cuando se establecen ambas entradas, una respuesta debe coincidir con ambas.
    * Los filtros se aplican antes de la paginación, por lo que una llamada filtrada solo pagina entre las respuestas que coinciden.
  </Accordion>

  <Accordion title="get_factcheck_report" id="get-factcheck-report">
    Informa con qué precisión describen las respuestas de IA una categoría en un rango de fechas: la puntuación de FactCheck, su tendencia y los recuentos de afirmaciones precisas e inexactas que la sustentan.

    **Prompts de ejemplo**:

    * "¿Cuál es nuestra puntuación de FactCheck del mes pasado?"
    * "¿Está mejorando la precisión y qué modelos son los menos precisos?"

    Las filas siempre devuelven `accuracy`, `accurate` e `inaccurate`. Sin `group_by`, el informe devuelve la puntuación principal de la categoría.

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría sobre la que informar |
    | `start_date` | Sí | - | Inicio de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `end_date` | Sí | - | Fin de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `group_by` | No | `[]` | Agrupa los resultados por `date`, `model`, `region`, `persona`, `prompt`, `topic`, `tag`, `citation` o `theme`. Admite hasta dos valores, y `citation` no se puede combinar con otro valor |
    | `model` | No | `null` | Acota a uno o más modelos de IA, por nombre exacto |
    | `topic` | No | `null` | Acota a uno o más temas, por nombre exacto de `list_topics` |
    | `topic_negate` | No | `false` | Cuando es `true`, excluye los temas de `topic` en lugar de acotar a ellos |
    | `region` | No | `null` | Acota a una o más regiones, por nombre exacto |
    | `persona` | No | `null` | Acota a una o más personas, por nombre exacto |
    | `prompt` | No | `null` | Acota a uno o más prompts, por nombre exacto |
    | `tag` | No | `null` | Acota a una o más etiquetas, por nombre exacto |
    | `limit` | No | `100` | Filas por página, hasta 100 |
    | `cursor` | No | `null` | Token de paginación de `info.next_cursor` |

    **Notas**:

    * FactCheck se limita a una categoría, por lo que no hay entrada de marca ni de competidor.
    * Los filtros coinciden con los nombres de forma exacta.
    * `topic_negate` solo se aplica a `topic` y deja que los demás filtros acoten como de costumbre.
  </Accordion>

  <Accordion title="get_factcheck_claims" id="get-factcheck-claims">
    Enumera las afirmaciones inexactas que hicieron las respuestas de IA sobre una categoría en un rango de fechas.

    **Prompts de ejemplo**:

    * "¿Qué afirmaciones inexactas surgieron en nuestra categoría el mes pasado?"
    * "¿Cuál es la evidencia detrás de la afirmación inexacta más común y qué páginas se citan para ella?"

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría sobre la que informar |
    | `start_date` | Sí | - | Inicio de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `end_date` | Sí | - | Fin de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `group_by` | No | `[]` | Agrupa los resultados por uno de `model`, `region`, `persona`, `prompt`, `topic`, `tag` o `theme` |
    | `include` | No | `[]` | Detalle adicional por afirmación: `theme`, `reasoning`, `models`, `evidence` o `citation_sources` |
    | `model` | No | `null` | Acota a uno o más modelos de IA, por nombre exacto |
    | `topic` | No | `null` | Acota a uno o más temas, por nombre exacto de `list_topics` |
    | `topic_negate` | No | `false` | Cuando es `true`, excluye los temas de `topic` en lugar de acotar a ellos |
    | `region` | No | `null` | Acota a una o más regiones, por nombre exacto |
    | `persona` | No | `null` | Acota a una o más personas, por nombre exacto |
    | `prompt` | No | `null` | Acota a uno o más prompts, por nombre exacto |
    | `tag` | No | `null` | Acota a una o más etiquetas, por nombre exacto |
    | `limit` | No | `25` | Filas por página, hasta 100, o hasta 5 cuando `include` contiene `citation_sources` |
    | `cursor` | No | `null` | Token de paginación de `info.next_cursor` |

    **Notas**:

    * `group_by` admite un solo valor, y `group_by: ["tag"]` no se puede combinar con un filtro `tag`. No se admite agrupar por fecha, cita o afirmación.
    * `citation_sources` agrega las páginas citadas para cada afirmación, por lo que no se puede combinar con `group_by`, y `limit` debe ser 5 o menos. Un límite mayor devuelve un error en lugar de reducirse automáticamente.
    * Los valores de `include` agregan por qué cada afirmación es inexacta, qué modelos la repitieron y qué páginas se citan para ella. Esos valores se pueden combinar, por lo que una sola llamada sin agrupar puede devolver juntos el tema, el razonamiento, los modelos, la evidencia y las fuentes de citas de una afirmación.
    * Para obtener la puntuación, su tendencia o los recuentos de afirmaciones precisas e inexactas, usa [`get_factcheck_report`](#get-factcheck-report) en su lugar.
  </Accordion>
</AccordionGroup>

### Informes heredados de visibilidad y citas

`get_visibility_report` y `get_citations_report` tienen cada uno una versión anterior que devuelve la forma de respuesta heredada: filas como valores posicionales, agrupadas con `dimensions` en lugar de `group_by`, y sin la delimitación por marca de `scope` y `assets`. Ambas siguen disponibles para las integraciones creadas con la forma anterior.

<Note>
  Estas herramientas usan una ventana de fechas semiabierta: `start_date` es inclusivo y `end_date` es exclusivo. Para cubrir todo abril de 2026, pasa `start_date: 2026-04-01` y `end_date: 2026-05-01`. Las herramientas actuales tratan ambos extremos como inclusivos, por lo que las mismas fechas cubren una ventana diferente.
</Note>

| Herramienta | Uso |
| - | - |
| `get_visibility_report_v1` | Visibilidad de una categoría, en la forma de respuesta heredada |
| `get_citations_report_v1` | Citas de una categoría, en la forma de respuesta heredada |

<AccordionGroup>
  <Accordion title="get_visibility_report_v1" id="get-visibility-report-v1">
    Mide con qué frecuencia y con qué prominencia aparece una marca en las respuestas de IA para una categoría en un rango de fechas, y devuelve la forma de respuesta heredada. Para integraciones nuevas, usa [`get_visibility_report`](#get-visibility-report) en su lugar.

    Métrica predeterminada: `visibility_score`.

    Otras métricas útiles incluyen `share_of_voice`, `mentions_count`, `executions` y `average_position`. Las dimensiones útiles incluyen `date`, `region`, `topic`, `model`, `prompt`, `tag`, `persona` y `asset_name`.

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría sobre la que informar |
    | `start_date` | Sí | - | Inicio de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `end_date` | Sí | - | Fin de la ventana (exclusivo) en formato `YYYY-MM-DD` |
    | `metrics` | No | `visibility_score` | Métricas que se devuelven |
    | `dimensions` | No | `null` | Campos de agrupación |
    | `filters` | No | `null` | Predicados avanzados `{ "field", "operator", "value" }` |
    | `limit` | No | `null` | Límite de las N filas principales. Cuando se establece, `next_cursor` siempre es `null` |
    | `topic_filter` | No | `null` | Acota a uno o más temas |
    | `tag_filter` | No | `null` | Acota a una o más etiquetas |
    | `region_filter` | No | `null` | Acota a una o más regiones |
    | `model_filter` | No | `null` | Acota a uno o más modelos de IA |
    | `persona_filter` | No | `null` | Acota a una o más personas |
    | `asset_filter` | No | `null` | Acota a uno o más activos de marca o competidor |
    | `cursor` | No | `null` | Token de paginación de una respuesta anterior |
    | `page_size` | No | `500` | Tamaño de la primera página, hasta 10,000 |

    **Notas**:

    * `visibility_score` es un decimal sin procesar. Multiplícalo por 100 para que coincida con el porcentaje que muestra la plataforma de Profound.
    * Sin un filtro de activos ni `asset_name` en `dimensions`, `visibility_score` se suma entre todas las marcas rastreadas de la categoría, por lo que el total puede superar 1. Para limitar el informe a una marca, pasa `asset_filter` o agrega `asset_name` a `dimensions`.
  </Accordion>

  <Accordion title="get_citations_report_v1" id="get-citations-report-v1">
    Muestra qué fuentes citan los motores de IA para una categoría, y con qué frecuencia, en un rango de fechas, y devuelve la forma de respuesta heredada. Para integraciones nuevas, usa [`get_citations_report`](#get-citations-report) en su lugar.

    Métricas predeterminadas: `count` y `citation_share`. Las dimensiones incluyen `hostname`, `path`, `root_domain`, `url`, `model`, `topic`, `prompt`, `tag` y `persona`.

    <Note>
      `root_domain_filter` debe ir acompañado de `dimensions: ["root_domain"]`.
    </Note>

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría sobre la que informar |
    | `start_date` | Sí | - | Inicio de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `end_date` | Sí | - | Fin de la ventana (exclusivo) en formato `YYYY-MM-DD` |
    | `metrics` | No | `count`, `citation_share` | Métricas que se devuelven |
    | `dimensions` | No | `null` | Campos de agrupación |
    | `filters` | No | `null` | Predicados avanzados `{ "field", "operator", "value" }` |
    | `limit` | No | `null` | Límite de las N filas principales. Cuando se establece, `next_cursor` siempre es `null` |
    | `topic_filter` | No | `null` | Acota a uno o más temas |
    | `tag_filter` | No | `null` | Acota a una o más etiquetas |
    | `region_filter` | No | `null` | Acota a una o más regiones |
    | `model_filter` | No | `null` | Acota a uno o más modelos de IA |
    | `persona_filter` | No | `null` | Acota a una o más personas |
    | `root_domain_filter` | No | `null` | Acota a uno o más dominios raíz. Requiere `root_domain` en `dimensions` |
    | `hostname_filter` | No | `null` | Acota a uno o más nombres de host |
    | `citation_category_filter` | No | `null` | Acota a una o más categorías de citas |
    | `cursor` | No | `null` | Token de paginación de una respuesta anterior |
    | `page_size` | No | `500` | Tamaño de la primera página, hasta 10,000 |
  </Accordion>
</AccordionGroup>

### Informes de visibilidad en compras

<Note>
  Actualmente, los datos de análisis de compras solo están disponibles para ChatGPT.
</Note>

Usa estas herramientas para entender cómo aparecen las marcas, los productos y los minoristas cuando la IA responde a un prompt con resultados del modo de compras.

| Herramienta | Uso |
| - | - |
| `get_shopping_brands_report` | Visibilidad de marca dentro de los resultados de compras de IA |
| `get_shopping_products_report` | Visibilidad, cuota de posición y ofertas por producto |
| `get_shopping_merchants_report` | Qué minoristas muestra ChatGPT |
| `get_shopping_trigger_rate_report` | Con qué frecuencia los prompts devuelven resultados de compras |

<Tip>
  Empieza por preguntarle al asistente con qué frecuencia los prompts de la categoría devuelven resultados de compras (`get_shopping_trigger_rate_report`). Si rara vez lo hacen, los demás informes de compras tendrán pocos datos que mostrar.
</Tip>

<AccordionGroup>
  <Accordion title="get_shopping_brands_report">
    Mide con qué frecuencia aparece cada marca cuando ChatGPT devuelve resultados de compras. Es el equivalente de compras de `get_visibility_report`.

    **Prompts de ejemplo**:

    * "¿Qué marcas aparecen más en los resultados de compras de ChatGPT para nuestra categoría?"
    * "¿Cómo se compara nuestra visibilidad en compras con la de los competidores, día a día?"

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría rastreada, de `list_categories` |
    | `start_date` | Sí | - | Inicio de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `end_date` | Sí | - | Fin de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `group_by` | No | `null` | Agrupa los resultados por `date`, `topic`, `region` o `prompt` |
    | `metrics` | No | todas | Métricas que se devuelven |
    | `interval` | No | `day` | Tamaño de cada intervalo de tiempo al agrupar por `date`: `day`, `week` o `month` |
    | `scope` | No | `null` | `owned` para tus marcas rastreadas, o `all` para incluir a los competidores. Si no se establece, el informe cubre tus marcas rastreadas |
    | `assets` | No | `null` | Acota a una o más marcas, por nombre. Una selección de `assets` devuelve una sola página e ignora `limit` |
    | `topic_filter` | No | `null` | Acota a uno o más temas |
    | `region_filter` | No | `null` | Acota a una o más regiones |
    | `persona_filter` | No | `null` | Acota a una o más personas |
    | `prompt_filter` | No | `null` | Acota a uno o más prompts |
    | `tag_filter` | No | `null` | Acota a una o más etiquetas |
    | `filter` | No | `null` | Expresión de filtro para condiciones que las demás entradas no pueden expresar, como excluir una región o coincidir con cualquiera de dos temas. Se combina con esas entradas mediante `and` |
    | `limit` | No | `null` | Grupos de nivel superior por página, hasta 50 |
    | `cursor` | No | `null` | Token de paginación de `info.next_cursor` |

    **Notas**:

    * Cada fila incluye un objeto `asset` de `{name, owned}`, y el activo siempre es una clave de agrupación implícita: los resultados son una fila por activo e intervalo de agrupación.
  </Accordion>

  <Accordion title="get_shopping_products_report">
    Mide la visibilidad de productos individuales dentro de los resultados de compras de IA, con una fila por producto más cualquier intervalo de agrupación.

    **Prompts de ejemplo**:

    * "¿Qué tan visibles son nuestros productos en los resultados de compras de ChatGPT?"
    * "¿Dónde se vende nuestro producto estrella y a qué precio?"

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría rastreada, de `list_categories` |
    | `start_date` | Sí | - | Inicio de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `end_date` | Sí | - | Fin de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `group_by` | No | `null` | Agrupa los resultados por `date`, `topic` o `prompt`. No se puede combinar con `target_product` ni con `include_merchants` |
    | `metrics` | No | todas | Métricas que se devuelven |
    | `interval` | No | `day` | Tamaño de cada intervalo de tiempo al agrupar por `date`: `day`, `week` o `month` |
    | `target_product` | No | `null` | Cambia a la vista de artículo: un producto más sus competidores más cercanos. No se puede combinar con `group_by` ni con `include_merchants` |
    | `include_merchants` | No | `false` | `true` agrega las ofertas de cada producto como `merchants`, una lista de `{name, price}`, además de `product_url` y `product_image_urls` en la fila del producto. No se puede combinar con `group_by` ni con `target_product` |
    | `topic_filter` | No | `null` | Acota a uno o más temas |
    | `region_filter` | No | `null` | Acota a una o más regiones |
    | `persona_filter` | No | `null` | Acota a una o más personas |
    | `prompt_filter` | No | `null` | Acota a uno o más prompts |
    | `tag_filter` | No | `null` | Acota a una o más etiquetas |
    | `brand_filter` | No | `null` | Acota a los productos de una marca |
    | `merchant_filter` | No | `null` | Acota a los productos que muestra un minorista |
    | `filter` | No | `null` | Expresión de filtro para condiciones que las demás entradas no pueden expresar, como excluir una región o coincidir con cualquiera de dos temas |
    | `limit` | No | `null` | Grupos de nivel superior por página, hasta 50 |
    | `cursor` | No | `null` | Token de paginación de `info.next_cursor` |

    **Notas y consejos**:

    * Las métricas predeterminadas son `visibility_score`, `average_position`, `visibility_rank`, `position1_percentage`, `position2_percentage`, `position3_percentage`, `position_above3_percentage`, `product_rating` y `product_num_reviews`.
    * Las métricas `position` son la forma en que tu asistente distingue entre "siempre se muestra, siempre en cuarto lugar" y "a veces se muestra en primer lugar". Cada una es una fracción sin procesar de 0 a 1 de las apariciones del producto en esa posición, y juntas suman aproximadamente 1, por lo que 0.30 es 30 %.
    * El modo `include_merchants` no acepta `group_by` ni `target_product`, y las métricas de frecuencia de posición no están disponibles en él.
  </Accordion>

  <Accordion title="get_shopping_merchants_report">
    Mide qué minoristas aparecen en los resultados de compras de una categoría.

    **Prompt de ejemplo**:

    * "¿Qué minoristas muestra ChatGPT para nuestra categoría?"

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría rastreada, de `list_categories` |
    | `start_date` | Sí | - | Inicio de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `end_date` | Sí | - | Fin de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `view` | No | `distribution` | `distribution`, `brand_share` o `top_products` |
    | `by_date` | No | `false` | `true` devuelve una serie temporal. Solo se admite en la vista `distribution` |
    | `metrics` | No | el conjunto completo de la vista | Métricas que se devuelven: las válidas para la vista elegida |
    | `interval` | No | `day` | Tamaño de cada intervalo de tiempo al agrupar por `date`: `day`, `week` o `month` |
    | `topic_filter` | No | `null` | Acota a uno o más temas |
    | `region_filter` | No | `null` | Acota a una o más regiones |
    | `persona_filter` | No | `null` | Acota a una o más personas |
    | `prompt_filter` | No | `null` | Acota a uno o más prompts |
    | `tag_filter` | No | `null` | Acota a una o más etiquetas |
    | `filter` | No | `null` | Expresión de filtro para condiciones que las demás entradas no pueden expresar, como excluir una región o coincidir con cualquiera de dos temas |
    | `limit` | No | `null` | Grupos de nivel superior por página, hasta 50 |
    | `cursor` | No | `null` | Token de paginación de `info.next_cursor` |

    La entrada `view` decide qué representa cada fila y qué métricas están disponibles.

    | Vista | Filas | Responde |
    | - | - | - |
    | `distribution` | Una fila por minorista | Qué minoristas dominan esta categoría |
    | `brand_share` | Una fila por minorista y marca | De quién son los productos que muestra un minorista |
    | `top_products` | Una fila por minorista y producto | Qué es lo que más lista un minorista |

    Cada vista acepta sus propias métricas, y el servidor rechaza cualquier cosa fuera de ese conjunto:

    | Vista | Métricas |
    | - | - |
    | `distribution` | `merchant_share`, `merchant_share_rank`, `merchant_visibility`, `merchant_visibility_rank` |
    | `brand_share` | `brand_share`, `merchant_share`, `visibility_rank` |
    | `top_products` | `merchant_visibility`, `product_visibility`, `product_rank` |

    **Notas y consejos**:

    * Este informe no tiene filtro de minorista ni de producto, por lo que no puedes acotar los resultados a un solo minorista. En su lugar, acota por tema, región, persona, prompt o etiqueta y luego busca el minorista que te interesa en las filas devueltas.
    * El campo de metadatos `info.view` indica la vista que aplicó el servidor. `view` es opcional y su valor predeterminado es `distribution`, así que si las filas no se ven como esperabas, revisa `info.view` para ver qué vista las generó.
  </Accordion>

  <Accordion title="get_shopping_trigger_rate_report">
    Mide con qué frecuencia los prompts devuelven resultados del modo de compras. Es el denominador detrás de los demás informes de compras; el asistente puede usarlo para explicar un resultado escaso o vacío.

    **Prompts de ejemplo**:

    * "¿Con qué frecuencia nuestros prompts activan resultados del modo de compras?"
    * "¿Qué temas activan el modo de compras con más frecuencia?"

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `category_id` | Sí | - | Categoría rastreada, de `list_categories` |
    | `start_date` | Sí | - | Inicio de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `end_date` | Sí | - | Fin de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `group_by` | No | `null` | Agrupa los resultados por `date`, `topic`, `region`, `persona` o `prompt` |
    | `metrics` | No | todas | Métricas que se devuelven |
    | `interval` | No | `day` | Tamaño de cada intervalo de tiempo al agrupar por `date`: `day`, `week` o `month` |
    | `topic_filter` | No | `null` | Acota a uno o más temas |
    | `region_filter` | No | `null` | Acota a una o más regiones |
    | `persona_filter` | No | `null` | Acota a una o más personas |
    | `prompt_filter` | No | `null` | Acota a uno o más prompts |
    | `tag_filter` | No | `null` | Acota a una o más etiquetas |
    | `filter` | No | `null` | Expresión de filtro para condiciones que las demás entradas no pueden expresar, como excluir una región o coincidir con cualquiera de dos temas |
    | `limit` | No | `null` | Grupos de nivel superior por página, hasta 50 |
    | `cursor` | No | `null` | Token de paginación de `info.next_cursor` |

    **Notas y consejos**:

    * Las métricas predeterminadas son `total_runs`, `shopping_triggered_runs` y `trigger_rate_percentage`.
    * A pesar de su nombre, `trigger_rate_percentage` es una fracción decimal entre 0 y 1, por lo que 0.17 significa 17 %.
    * Agrupa los resultados por `prompt` o `topic` para ver qué prompts o temas activan resultados de compras con más frecuencia. Esos son los lugares donde vale la pena optimizar la visibilidad en compras.
  </Accordion>
</AccordionGroup>

## Informes de tráfico

Estas herramientas se limitan a un dominio rastreado, no a una categoría. El asistente primero resuelve el dominio con [`list_domains`](/es/mcp/capabilities/discovery-tools#list-domains) y pasa el nombre de host exacto que devuelve Profound.

| Herramienta | Uso |
| - | - |
| `get_referrals_report` | Cuántas visitas recibió un dominio desde motores de IA y qué referentes las generaron |
| `get_bots_report` | Qué rastreadores de IA visitan un dominio y con qué frecuencia |

<AccordionGroup>
  <Accordion title="get_referrals_report">
    Mide las visitas que recibió un dominio desde motores de IA, como ChatGPT y Perplexity, en un rango de fechas.

    Métrica predeterminada: `visits`. Las dimensiones útiles incluyen `referral_type`, `referral_source` y `date`.

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `domain` | Sí | - | Dominio rastreado, con el nombre de host exacto de `list_domains` |
    | `start_date` | Sí | - | Inicio de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `end_date` | Sí | - | Fin de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `metrics` | No | `visits` | Métricas que se devuelven |
    | `dimensions` | No | `null` | Campos de agrupación, como `referral_type`, `referral_source` o `date` |
    | `organization_id` | No | `null` | Desambigua el dominio cuando quien hace la llamada pertenece a varias organizaciones |
    | `filters` | No | `null` | Predicados avanzados `{ "field", "operator", "value" }` |
    | `limit` | No | `null` | Límite de las N filas principales. Cuando se establece, `next_cursor` siempre es `null` |
    | `referral_source_filter` | No | `null` | Acota a uno o más proveedores referentes, como `openai` |
    | `referral_type_filter` | No | `null` | Acota a una o más categorías de referencia: `internal`, `referer`, `utm` o `none` |
    | `cursor` | No | `null` | Token de paginación de una respuesta anterior |
    | `page_size` | No | `500` | Tamaño de la primera página, hasta 10,000 |
  </Accordion>

  <Accordion title="get_bots_report">
    Mide la actividad de los rastreadores de IA en un dominio en un rango de fechas, incluidos bots como GPTBot y PerplexityBot.

    **Prompts de ejemplo**:

    * "¿Qué rastreadores de IA visitan nuestro dominio?"
    * "¿GPTBot nos está rastreando más desde la actualización del sitio?"

    Métricas predeterminadas: `count` y `citations`. Las dimensiones útiles incluyen `bot_provider`, `bot_name`, `bot_type` y `date`.

    **Entradas**

    | Entrada | Obligatoria | Predeterminado | Descripción |
    | - | - | - | - |
    | `domain` | Sí | - | Dominio rastreado, con el nombre de host exacto de `list_domains` |
    | `start_date` | Sí | - | Inicio de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `end_date` | Sí | - | Fin de la ventana (inclusivo) en formato `YYYY-MM-DD` |
    | `metrics` | No | `count`, `citations` | Métricas que se devuelven |
    | `dimensions` | No | `null` | Campos de agrupación, como `bot_provider`, `bot_name`, `bot_type` o `date` |
    | `organization_id` | No | `null` | Desambigua el dominio cuando quien hace la llamada pertenece a varias organizaciones |
    | `filters` | No | `null` | Predicados avanzados `{ "field", "operator", "value" }` |
    | `limit` | No | `null` | Límite de las N filas principales. Cuando se establece, `next_cursor` siempre es `null` |
    | `bot_provider_filter` | No | `null` | Acota a uno o más proveedores, como `openai` o `anthropic` |
    | `bot_name_filter` | No | `null` | Acota a uno o más bots individuales, como `GPTBot` |
    | `bot_type_filter` | No | `null` | Acota a una o más categorías de bots: `ai_assistant`, `ai_training`, `index` o `ai_agent` |
    | `cursor` | No | `null` | Token de paginación de una respuesta anterior |
    | `page_size` | No | `500` | Tamaño de la primera página, hasta 10,000 |
  </Accordion>
</AccordionGroup>

## Recursos

Profound MCP también expone recursos MCP de solo lectura: material de referencia estático que un cliente MCP puede cargar en el contexto.

| URI del recurso | Audiencia | Úsalo para |
| - | - | - |
| `file:///profound/glossary` | Asistente | Índice compacto de términos específicos de Profound para cargar una vez por sesión |
| `file:///profound/glossary/full` | Usuario | Glosario completo con definiciones y ejemplos, más extenso que el índice |
| `file:///profound/glossary/{term}` | Asistente | Definición completa de un término del glosario |
| `file:///profound/sentiment-guide` | Asistente | Cómo elegir una fuente de sentimiento e interpretar sus métricas, filtros y ordenación, antes de llamar a `get_sentiment_report` |

El espacio `{term}` acepta cualquier slug del índice del glosario, que incluye las métricas y los conceptos de informes detrás de las herramientas de esta página:

| Informe | Recursos de términos |
| - | - |
| Visibilidad | `visibility-score`, `visibility`, `mentions`, `share-of-voice` |
| Citas | `citations`, `citation-share` |
| Sentimiento | `sentiment`, `aggregated-sentiment-score`, `sentiment-theme` |
| FactCheck | `factcheck-score`, `inaccurate-claim`, `factcheck-theme` |
| Compras | `shopping-trigger-rate`, `product-visibility`, `merchant-share` |
| Bots | `bot-tracker` |
| Cualquier informe | `date-range`, `prompt-volume`, `executions` |