Cómo funcionan las herramientas en conjunto
La mayoría de las conversaciones comienzan con las herramientas de descubrimiento y luego pasan a los informes. Así es como suele verse:1
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.2
Encuentra el alcance adecuado
Pregunta por la marca o el sitio que te interesa. El asistente lo resuelve con
list_organizations y luego con list_categories para los informes de visibilidad o con list_domains para los informes de tráfico.3
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, list_models, list_tags, list_topics y list_prompts.4
Ejecuta un informe
Pregunta por lo que quieres que se informe. El asistente obtiene datos de visibilidad, sentimiento, citas, respuestas a prompts, compras, volumen de prompts, referencias o rastreo de bots para el rango de fechas que indiques.
Comportamiento y seguridad
Todas las herramientas son de solo lectura. Obtienen datos de análisis, pero no crean, actualizan ni eliminan nada en Profound.
Todas las herramientas de informes establecen las siguientes sugerencias MCP:
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 uncategory_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.
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.get_visibility_report
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?”
- “¿En qué posición estamos en Share of Voice en esta categoría?”
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 %.EntradasNotas:
- Cada fila incluye un objeto
assetde{name, owned}. Los resultados siempre se agrupan por marca además de porgroup_by, por lo que obtienes una fila por marca por intervalo. limitlimita 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.- Sin
group_by, elrankde cada fila es la posición de la marca en la métrica desort_byentre todas las marcas de la categoría con los filtros activos, incluso cuandoassetsacota los resultados a una sola marca. Los empates se resuelven alfabéticamente por nombre de marca, por lo que no hay dos marcas con el mismorank. Cuandosort_byesaverage_position, solo recibenranklas 50 marcas principales por visibilidad más las marcas indicadas enassets. - Para obtener la posición de Share of Voice de una marca, el asistente establece
assetsen esa marca ysort_byenshare_of_voicesingroup_by, y leeranken el resultado.
get_sentiment_report
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?”
source selecciona cuál.EntradasNotas:
citation_category,page_contains,citation_sort_byycitation_sort_directionsolo están disponibles cuandosourceescitation; de lo contrario, devuelven un error.- Los filtros acotan los resultados, pero nunca los agrupan. Cuando
sourceescitation,modelcambia qué páginas califican y su cuota de citas, pero el sentimiento sigue siendo el de la página, no el del modelo.
get_citations_report
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:Entradas
- “¿Qué sitios citan más los motores de IA en nuestra categoría?”
- “¿Con qué frecuencia citan las respuestas de IA nuestro propio dominio?”
- “¿Cómo se reparten las citas entre las categorías de citas?”
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. citation_coverage es la fracción de respuestas, de 0 a 1, que citan el dominio o la página al menos una vez, también promediada por modelo de IA.entity define qué representa cada fila. Sin entity, 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. entity: "page" devuelve una fila por URL de página citada, y entity: "citation_category" devuelve una fila por categoría de citas, con su id y name, ordenada por cuota de citas.scope: "owned" y domain_filter solo funcionan con filas de dominio, y page_filter y first_cited_at solo funcionan con filas de página. Las filas de categoría de citas no admiten group_by y solo admiten las métricas count y citation_share. Otras combinaciones devuelven un error.Notas:
- Las filas de dominio y de página incluyen un
rank, donde1es el más citado.first_cited_atsolo se devuelve en las filas de página. citation_coveragesolo se devuelve en las filas de dominio y de página, y su valor puede sernull. Se habilita por categoría. Cuando no está habilitada para la categoría que consultas, el informe sigue devolviendo las demás métricas que solicitaste, einfo.metricsomitecitation_coverage. Tu equipo de cuenta de Profound puede habilitarla.- Las filas de categoría de citas no incluyen
rank, y sus valores decitation_sharepueden sumar más del 100 %, porque una cita puede contar tanto en la categoría de su página como en la categoría de su dominio. info.entityen la respuesta indica qué entidad representan las filas.group_by: ["page"]sigue funcionando como antes: selecciona filas de página cuando se omiteentity. Establecerentityen cualquier valor distinto depagejunto con él devuelve un error.limitlimita 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.
get_prompt_answers
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.”
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.
get_factcheck_report
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?”
accuracy, accurate e inaccurate. Sin group_by, el informe devuelve la puntuación principal de la categoría.EntradasNotas:
- 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_negatesolo se aplica atopicy deja que los demás filtros acoten como de costumbre.
get_factcheck_claims
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?”
Notas:
group_byadmite un solo valor, ygroup_by: ["tag"]no se puede combinar con un filtrotag. No se admite agrupar por fecha, cita o afirmación.citation_sourcesagrega las páginas citadas para cada afirmación, por lo que no se puede combinar congroup_by, ylimitdebe ser 5 o menos. Un límite mayor devuelve un error en lugar de reducirse automáticamente.- Los valores de
includeagregan 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_reporten su lugar.
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.
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.get_visibility_report_v1
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 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.EntradasNotas:
visibility_scorees 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_nameendimensions,visibility_scorese 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, pasaasset_filtero agregaasset_nameadimensions.
get_citations_report_v1
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 Entradas
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.root_domain_filter debe ir acompañado de dimensions: ["root_domain"].Informes de visibilidad en compras
Actualmente, los datos de análisis de compras solo están disponibles para ChatGPT.
get_shopping_brands_report
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?”
Notas:
- Cada fila incluye un objeto
assetde{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.
get_shopping_products_report
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?”
Notas y consejos:
- Las métricas predeterminadas son
visibility_score,average_position,visibility_rank,position1_percentage,position2_percentage,position3_percentage,position_above3_percentage,product_ratingyproduct_num_reviews. - Las métricas
positionson 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_merchantsno aceptagroup_bynitarget_product, y las métricas de frecuencia de posición no están disponibles en él.
get_shopping_merchants_report
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?”
La entrada
view decide qué representa cada fila y qué métricas están disponibles.Cada vista acepta sus propias métricas, y el servidor rechaza cualquier cosa fuera de ese conjunto:
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.viewindica la vista que aplicó el servidor.viewes opcional y su valor predeterminado esdistribution, así que si las filas no se ven como esperabas, revisainfo.viewpara ver qué vista las generó.
get_shopping_trigger_rate_report
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?”
Notas y consejos:
- Las métricas predeterminadas son
total_runs,shopping_triggered_runsytrigger_rate_percentage. - A pesar de su nombre,
trigger_rate_percentagees una fracción decimal entre 0 y 1, por lo que 0.17 significa 17 %. - Agrupa los resultados por
promptotopicpara 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.
Informes de volumen de prompts
Estas herramientas miden la demanda de una palabra clave en todo lo que la gente pregunta a las plataformas de IA. Pregunta por una palabra clave a la vez; el asistente hace una llamada por palabra clave. Para ver cómo apareces en los prompts que rastreas, pide un informe de visibilidad.Cuando el asistente no informa ninguna estimación para una palabra clave, eso no significa que nadie pregunte por ella. O bien nada coincidió con la palabra clave en ese rango de fechas, o bien cada segmento tenía dos o menos usuarios distintos y Profound lo eliminó por motivos de privacidad.
get_prompt_volume
get_prompt_volume
Mide el volumen semanal y mensual proyectado de una palabra clave, por país y plataforma.Prompts de ejemplo:
- “¿Cuántas personas preguntaron a ChatGPT sobre zapatillas para correr el mes pasado?”
- “¿Está aumentando la demanda de ‘software de gestión de proyectos’ este trimestre?”
- Las cifras se devuelven como proyecciones semanales y mensuales, una por país y plataforma. Las cifras semanales se fechan con el lunes de esa semana y las mensuales con el primer día del mes. Solo existe una cifra mensual para un mes natural que quede completamente dentro del rango de fechas que consultas, nunca para el mes en curso, por lo que una pregunta sobre este mes obtiene solo cifras semanales. Una cifra mensual no es la suma de sus semanas, porque una semana que cruza el límite de un mes se reparte entre los dos meses. Cuando necesites un número mensual, pídelo en lugar de sumar semanas.
- Una pregunta amplia, como todos los países y plataformas durante varios meses, puede superar el límite de 10,000 filas. En ese caso, el asistente obtiene totales incompletos e
info.truncatedcon el valortrue. Acota la pregunta a un país, una plataforma o un rango de fechas más corto para obtener cifras completas. - Cada palabra clave nueva cuenta para el límite de tu organización de 1,000 palabras clave distintas por día UTC. Volver a preguntar por una palabra clave que ya consultaste ese día no cuenta. Si alcanzas el límite, espera y vuelve a preguntar por la misma palabra clave. Reformularla consume más de tu cupo.
get_prompt_volume_intents
get_prompt_volume_intents
Mide la proporción de conversaciones sobre una palabra clave que corresponden a cada intención, para que puedas saber si la gente está investigando o lista para comprar. No mide cuántas personas preguntan; eso lo hace
get_prompt_volume.Prompts de ejemplo:- “¿La gente está investigando software CRM o está lista para comprar?”
- “¿Qué intenciones impulsan las conversaciones de IA sobre bicicletas eléctricas?”
pct_conversation, de modo que 0.42 es 42 %. Las proporciones de todas las intenciones suman 100 %. Cuando una intención tiene subcategorías, cada subcategoría es su propia fila (main_classification más sub_category_classification), y la proporción de la intención principal es la suma de sus subcategorías.Entradas- Preguntar por intenciones no cuenta para el límite diario de palabras clave, pero comparte un límite de ráfaga con
get_prompt_volume. Si el asistente alcanza el límite de frecuencia, volver a preguntar por la misma palabra clave un poco más tarde funciona.
Informes de tráfico
Estas herramientas se limitan a un dominio rastreado, no a una categoría. El asistente primero resuelve el dominio conlist_domains y pasa el nombre de host exacto que devuelve Profound.
get_referrals_report
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.Entradasget_bots_report
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?”
count y citations. Las dimensiones útiles incluyen bot_provider, bot_name, bot_type y date.EntradasRecursos
Profound MCP también expone recursos MCP de solo lectura: material de referencia estático que un cliente MCP puede cargar en el contexto.
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: