Herramientas del MCP
Las 14 herramientas del servidor MCP de Turbodato, qué pregunta contesta cada una, sus parámetros y qué pantalla del tablero habilita cada una.
El servidor tiene una herramienta por pregunta. Cada una usa el mismo cálculo que la pantalla del tablero que contesta esa pregunta, así el número que te da el asistente es el que ves vos. Todas son de solo lectura.
No hace falta que elijas la herramienta: el asistente la elige leyendo tu pregunta. Esta página sirve para saber qué se puede preguntar, para entender una respuesta o para armar un agente propio.
Resumen
| Herramienta | Contesta | Se activa con |
|---|---|---|
list_clients | ¿Qué tableros tengo? | Siempre |
get_price_gaps | ¿Dónde me ganan? ¿Dónde soy el más barato? | Siempre |
get_price_position_summary | ¿Cuántos productos tengo en rojo, amarillo y verde? | Siempre |
get_suggested_price | ¿Quién rompe el PVP, producto por producto? | Control de PVP |
get_pvp_breakers_by_seller | ¿Qué sellers rompen más el PVP? | Rupturas de PVP por seller |
get_price_changes | ¿Qué cambió de precio desde ayer? | Siempre |
get_product | ¿Cómo está este producto y cómo vino su precio? | Siempre |
get_seller_ranking | ¿Qué sellers de mi marketplace venden más barato afuera? | Sellers |
get_category_summary | Lo mismo, por categoría o por marca | Sellers |
get_stockouts | ¿Qué dejé de publicar? ¿Qué dejó de publicar la competencia? | Quiebres de stock |
get_data | La matriz de precios, para preguntas abiertas | Siempre |
export_data | La matriz entera, para análisis de muchos productos | Siempre |
get_filters | Marcas, categorías, sellers y sitios válidos | Siempre |
get_dates | Días con precios relevados | Siempre |
Se activa por tablero
Las herramientas de Control de PVP, Rupturas de PVP por seller, Sellers y Quiebres de stock aparecen solo si alguno de tus tableros tiene esa pantalla. Si la pedís en un tablero que no la tiene, el asistente te dice que no está habilitada; no inventa una respuesta. Para activarla, hablá con tu contacto de Turbodato.
Cómo funcionan todas
- El tablero. Todas, salvo
list_clients, recibenclientId: el id del tablero o su nombre exacto ("Mirgor", sin importar mayúsculas). Si tu usuario ve un solo tablero, se puede omitir. - El día. Sin
date, contestan con el último día con datos, que es lo que casi siempre quiere decir "hoy". Las comparaciones son siempre entre precios del mismo día. - Packs. En tableros con productos que se venden por pack, se compara el precio por unidad.
- Moneda. Pesos, salvo que el tablero esté en otra moneda; en ese caso cada respuesta con
precios trae
currency. - Argumentos estrictos. Un argumento desconocido, un valor fuera de la lista o una fecha mal escrita no se ignoran: devuelven un error que dice qué valores son válidos, y el asistente reintenta bien. Lo mismo pasa con un filtro que tu tablero no tiene.
- Tamaño. Ninguna respuesta pasa de 100.000 caracteres. Si una pregunta trae más, la herramienta pide acotarla en vez de devolver datos cortados.
Filtros comunes
Varias herramientas aceptan estos filtros. Cada sección dice cuáles.
Campo
Tipo
Los valores exactos de marca, categoría, sitio y seller salen de get_filters.
list_clients
Lista los tableros a los que tenés acceso: id, nombre, moneda y qué herramientas opcionales tiene cada uno. El asistente la usa cuando tenés más de un tablero, para saber a cuál preguntarle y qué puede preguntar antes de equivocarse.
No recibe parámetros.
get_price_gaps
"¿Dónde me ganan?" y "¿dónde soy el más barato?". Una fila por producto con tu precio, el competidor más barato (sitio y seller) y la diferencia en porcentaje, ordenada de mayor a menor sobre todo el catálogo.
Es la herramienta para cualquier pregunta de quién es más barato. El semáforo no alcanza para eso: un producto con un competidor abajo y otro arriba es amarillo.
La diferencia se mide sobre el mayor de los dos precios, así las dos direcciones se leen igual.
Si tu precio es $ 1.000.000 y el competidor más barato está en $ 926.000, la diferencia es 7,4%.
Cada fila dice también contra cuántos competidores se comparó y, con undercut, cuántos están
por debajo.
Campo
Tipo
Acepta todos los filtros comunes.
get_price_position_summary
El semáforo contado sobre el catálogo filtrado: cuántos productos están en cada color, siempre contra tu sitio propio.
- rojo: tu precio es el más alto de todos los sitios que tienen el producto.
- verde: tu precio es el más bajo.
- amarillo: estás en el medio, o empatado.
Es la lectura general más rápida. Para ver los productos detrás de los números, el asistente
sigue con get_price_gaps.
Acepta todos los filtros comunes.
get_suggested_price
Se activa por tablero
Necesita Control de PVP en el tablero.
"¿Quién vende debajo de mi precio sugerido?", contado igual que la pantalla de Control de PVP. Devuelve los contadores (productos que se rompen, ofertas que lo rompen, productos que cumplen, productos sin comparación) y una entrada por producto que se rompe, del peor al menos grave, con todos los sellers que lo rompen adentro.
- Los productos que no tienen PVP cargado se miden contra tu propio precio de ese día. La respuesta lo marca, y el asistente debería decírtelo en vez de contarlos como ruptura del PVP de la marca.
- Si tu propio sitio está debajo del PVP, aparece marcado como tuyo.
- La tolerancia es la del parámetro, no la que guardaste en la pantalla. Así el asistente puede decirte con qué regla contó.
Campo
Tipo
Acepta todos los filtros comunes.
get_pvp_breakers_by_seller
Se activa por tablero
Necesita Control de PVP y Rupturas de PVP por seller en el tablero.
"¿Qué sellers rompen más el PVP?". Un ranking de sellers por cantidad de productos que
venden debajo del precio sugerido, con la profundidad promedio y la comparación contra una
semana antes. Con seller, devuelve las publicaciones de ese seller que rompen el PVP, con
link y si ya lo rompían hace una semana.
Campo
Tipo
Acepta los filtros comunes salvo site (y seller, que acá tiene el significado de arriba).
get_price_changes
"¿Qué cambió desde ayer?". Compara el último día con el día anterior con datos, o con el día que le digas. Una fila por producto, sitio y seller que movió el precio, del cambio más grande al más chico, con el precio anterior y el nuevo. Incluye tu propio sitio, marcado como tuyo.
En productos por pack, un seller que pasó de vender el pack de 6 al de 12 no cuenta como una baja a la mitad: se compara cada tamaño de pack con el mismo tamaño.
Campo
Tipo
Acepta todos los filtros comunes.
get_product
Un producto puntual: todas sus ofertas del día y la historia de precio por sitio, con el precio más barato que tuvo cada sitio cada día. Se busca por nombre, EAN, SKU o tu código. Un código exacto gana; si el texto coincide con varios productos, devuelve la lista de candidatos para elegir.
Campo
Tipo
get_seller_ranking
Se activa por tablero
Necesita la pantalla de Sellers en el tablero.
Para tableros cuyo sitio propio es un marketplace donde publican otros sellers, como la tienda de un banco. Lista cada seller que vende en tu sitio y también afuera, con en cuántos productos su precio afuera es más bajo que en tu sitio, parecido (dentro de 1%) o más alto. Ordenado por los que venden más barato afuera.
Compara a cada seller contra sí mismo, no contra vos: un seller que publica el mismo
lavarropas a $ 899.999 en tu tienda y a $ 849.999 en Mercado Libre. Para "¿quién es más barato
que yo?" la herramienta es get_price_gaps.
Campo
Tipo
get_category_summary
Se activa por tablero
Necesita la pantalla de Sellers en el tablero.
La solapa Categorías de la pantalla de Sellers: por categoría o por marca, cuántos pares de
seller y producto están más baratos afuera que en tu sitio, parecidos o más caros. Se lee igual
que get_seller_ranking.
Campo
Tipo
get_stockouts
Se activa por tablero
Necesita Quiebres de stock en el tablero.
Quién dejó de publicar qué en los últimos siete días. Devuelve los contadores de las tres vistas y una página de la que elijas, con el último día y el último precio de cada sitio que dejó de publicar.
Campo
Tipo
Acepta brand, category, text, favorites y date.
get_data
La matriz de precios: tus productos con cada oferta relevada por sitio y seller, paginada.
Es para preguntas abiertas sobre productos puntuales. Para quién es más barato está
get_price_gaps; para el PVP, get_suggested_price.
En productos por pack, cada sitio y seller trae la escalera de packs con su precio por unidad. En marcas con precio sugerido, cada producto trae su PVP y las ofertas debajo vienen marcadas.
Campo
Tipo
Acepta todos los filtros comunes.
export_data
La matriz en bloque, en JSON, hasta 500 productos por llamada. Para análisis sobre muchos
productos a la vez: "exportá Samsung y resumime las brechas por categoría". Para un puñado de
productos, get_data es más liviana.
Campo
Tipo
Acepta los filtros comunes salvo date: exporta el último día con datos.
get_filters
Los valores válidos para filtrar: categorías, marcas, sellers y sitios. Si una lista pasa el
limit, trae también cuántos valores hay en total. Sirve
para escribir bien una marca o encontrar un seller entre cientos.
Campo
Tipo
get_dates
Los días que tienen precios relevados en el tablero. Sirve para elegir un date válido o para
saber desde cuándo hay historia.
No recibe parámetros además de clientId.