Conector de IA
Herramientas del conector de Cuestio
Esta página documenta las 17 herramientas del conector de Cuestio al Price Radar. Es para las organizaciones que conectan Claude u otro asistente de IA al Price Radar y para quienes revisan directorios de asistentes de IA. Los pasos para conectar están en la página Conecta tu asistente de IA al Price Radar de Cuestio. Son precios y listados en línea de las tiendas de Panamá, nunca ventas ni participaciones de mercado.
Cómo leer las clases
- Lectura. La herramienta solo lee.
- Escritura. La herramienta agrega o cambia datos.
- Escritura sensible. La herramienta quita, reemplaza o mueve algo. Los asistentes suelen preguntar antes de ejecutar una.
Cada herramienta lleva las anotaciones MCP readOnlyHint y destructiveHint, y son las que el asistente lee para decidir cuándo preguntar. Una herramienta de lectura tiene readOnlyHint en true. Una de escritura sensible tiene destructiveHint en true. Toda otra herramienta que cambia datos es de escritura. price_watch cambia una lista que comparte toda la organización, por eso es de escritura sensible.
Reglas comunes
- Estado. Cada herramienta devuelve un resultado de herramienta MCP con contenido estructurado (
structuredContent) y una copia en texto JSON. Un rechazo es un resultado conisError: truey un texto en español e inglés, nunca un error HTTP. - Rechazos de la organización. Tu acceso a Cuestio en esa organización terminó y un administrador debe invitarte de nuevo (en inglés, el texto dice "Your access to Cuestio in this organization has ended. Ask an administrator to invite you again."). La organización no tiene el Price Radar activo y un administrador debe activarlo (en inglés, "Your organization has no active Price Radar in Cuestio. Ask an administrator to activate it."). El conector no está disponible por ahora y conviene reintentar en unos minutos (en inglés, "The Cuestio connector is not currently available. Try again in a few minutes.").
- Límite de solicitudes. Demasiadas solicitudes seguidas. El texto, en inglés, dice "Too many requests in a row, wait a moment and retry."
- Argumentos rechazados. Un argumento desconocido o inválido se rechaza con la razón, antes de que la herramienta se ejecute.
- Herramientas de escritura y tokens de solo lectura. Una herramienta de escritura llamada con un token de solo lectura recibe el error "Tool not found" del SDK de MCP. Un token con
prices:writelista las 17 herramientas. - Límites. Las herramientas de precios del plan Cuestio comparten un límite de ráfagas, con una capacidad y una reposición por segundo. La cifra exacta no se publica en esta página. No hay un tope diario de llamadas de precios en el plan Cuestio. Las exportaciones tienen un límite diario: por defecto 50 exportaciones y 2,000,000 de filas al día. La configuración en vivo puede cambiar estas cifras.
Cuenta
whoami Lectura
- Devuelve: El identificador de la cuenta y su nivel (gratuito o de pago). En un plan gratuito añade una línea sobre lo que incluye el plan.
- Recibe: ninguno
- Campos de salida:
uid,tier,message - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con el alcance
prices:read. - Qué cambia: Ninguno, solo lee.
- Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), argumento rechazado
- Anotaciones:
readOnlyHinttrue,destructiveHintfalse
Precios en línea
price_search Lectura
- Devuelve: Los productos que coinciden, cada uno con su número de tiendas, la tienda y el precio más bajo y más alto, paginados con un cursor.
- Recibe:
query*,limit,cursor - Campos de salida:
products,total,relaxed,cursor,quota,asOf,sources - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con el alcance
prices:read. - Qué cambia: Ninguno, solo lee.
- Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), argumento rechazado
- Anotaciones:
readOnlyHinttrue,destructiveHintfalse
price_offers Lectura
- Devuelve: Todas las ofertas en línea vigentes de un producto, de la más barata a la más cara: tienda, sucursal, precio, precio anterior, página del producto, el día en que se leyó y el día en que cambió, y las marcas de existencias si se piden.
- Recibe:
product*,includeOutOfStock,stock,include_hidden - Campos de salida:
product,offers,notes,storeCount,offerCount,hidden_count,quota,asOf,sources - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con el alcance
prices:read. - Qué cambia: Ninguno, solo lee.
- Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), argumento rechazado
- Anotaciones:
readOnlyHinttrue,destructiveHintfalse
price_history Lectura
- Devuelve: El precio en línea de un producto en cada tienda, como tramos de precio constante o un punto por día. Por defecto cubre los últimos 30 días y como máximo 400 días.
- Recibe:
product*,stores,from,to,granularity - Campos de salida:
product,from,to,granularity,series,clampedTo,sparseBefore,note,quota,asOf,sources - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con el alcance
prices:read. - Qué cambia: Ninguno, solo lee.
- Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), argumento rechazado
- Anotaciones:
readOnlyHinttrue,destructiveHintfalse
price_basket Lectura
- Devuelve: El total de cada tienda sobre los productos que tiene con precio, los productos que le faltan, la tienda más barata y una matriz de precios paginada.
- Recibe:
products,basketId,watchList,stores,inStockOnly,limit,cursor - Campos de salida:
scope,stores,cheapestStore,matrix,total,cursor,unmatched,unmatchedCount,unpriced,unpricedCount,notes,quota,asOf,sources - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con el alcance
prices:read. - Qué cambia: Ninguno, solo lee.
- Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), argumento rechazado
- Anotaciones:
readOnlyHinttrue,destructiveHintfalse
price_changes Lectura
- Devuelve: Bajas de precio, alzas, ofertas nuevas y productos retirados de un ámbito, cada uno con el precio antes y después, el cambio en porcentaje y su día.
- Recibe:
scope*,from,to,kinds,limit,cursor - Campos de salida:
changes,counts,window,total,cursor,scope,scopeKind,notes,quota,asOf,sources - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con el alcance
prices:read. - Qué cambia: Ninguno, solo lee.
- Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), argumento rechazado
- Anotaciones:
readOnlyHinttrue,destructiveHintfalse
price_watch Escritura sensible
- Devuelve: Los elementos de la lista de seguimiento (acción
list), o la lista después de una acciónset,addoremove. - Recibe:
action*,items,limit,cursor - Campos de salida:
action,items,total,cursor,count,removed,watchMax,used,unresolved,notes,quota,asOf,sources - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con un token de alcance
prices:write. La lista es de la organización y la comparten sus miembros. - Qué cambia:
setreemplaza toda la lista,addsuma elementos,removequita elementos ylistno cambia nada. - Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), argumento rechazado
- Anotaciones:
readOnlyHintfalse,destructiveHinttrue
price_index Lectura
- Devuelve: Por competidor, los productos emparejados, la mediana y el promedio de la razón de precios, la proporción de productos más baratos, más caros e iguales, y las diez mayores diferencias en cada sentido.
- Recibe:
reference*,competitors,scope,inStockOnly - Campos de salida:
reference,competitors,inStockOnly,scope,scopeKind,notes,quota,asOf,sources - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con el alcance
prices:read. - Qué cambia: Ninguno, solo lee.
- Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), argumento rechazado
- Anotaciones:
readOnlyHinttrue,destructiveHintfalse
price_promotions Lectura
- Devuelve: Las promociones vigentes de los supermercados en línea, cada una con su profundidad en porcentaje, su día de inicio y su tienda.
- Recibe:
stores,scope,from,to,rule,includeEnded,limit,cursor - Campos de salida:
promotions,counts,byStore,suspectPromotions,window,rule,includeEnded,total,cursor,scope,scopeKind,notes,quota,asOf,sources,partial - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con el alcance
prices:read. - Qué cambia: Ninguno, solo lee.
- Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), argumento rechazado
- Anotaciones:
readOnlyHinttrue,destructiveHintfalse
price_availability Lectura
- Devuelve: Por producto y tienda, si está listado, su marca de existencias en línea, su precio y el día, con un resumen por tienda.
- Recibe:
brand,basketId,watchList,products,stores,limit,cursor - Campos de salida:
products,summary,total,cursor,scope,notes,quota,asOf,sources - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con el alcance
prices:read. - Qué cambia: Ninguno, solo lee.
- Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), argumento rechazado
- Anotaciones:
readOnlyHinttrue,destructiveHintfalse
price_export Escritura
- Devuelve: Un enlace de descarga privado a un archivo CSV de un informe de precios, válido por 15 minutos, en partes si pasa de 200,000 filas.
- Recibe:
report*,args,format,part - Campos de salida:
report,part,parts,rows,bytes,url,expiresAt,exportBudget,quota,asOf,sources,partial - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con un token de alcance
prices:write. - Qué cambia: Escribe un archivo CSV en el servidor de facturillo detrás de un enlace privado que vence a los 15 minutos, borra el archivo después de un día y cuenta contra el presupuesto de exportación del plan.
- Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), presupuesto de exportación, argumento rechazado
- Anotaciones:
readOnlyHintfalse,destructiveHintfalse
price_stores Lectura
- Devuelve: Las tiendas en línea cubiertas, con sus banners, sucursales, números de ofertas y de productos, categorías principales y si cada una publica existencias.
- Recibe: ninguno
- Campos de salida:
stores,total,quota,asOf,sources - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con el alcance
prices:read. - Qué cambia: Ninguno, solo lee.
- Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), argumento rechazado
- Anotaciones:
readOnlyHinttrue,destructiveHintfalse
Canastas
basket_list Lectura
- Devuelve: Las canastas de la cuenta (nombre, ícono, color, número de líneas, última actualización y mejor compra), o una canasta con sus productos.
- Recibe:
basketId,limit,cursor - Campos de salida:
baskets,total,cursor,basket,lines,caps,quota,asOf,sources - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con el alcance
prices:read. Las canastas viven en la propia cuenta de facturillo de la persona. - Qué cambia: Ninguno, solo lee.
- Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), argumento rechazado
- Anotaciones:
readOnlyHinttrue,destructiveHintfalse
basket_create Escritura
- Devuelve: La canasta nueva, el resultado de cada producto (
added,duplicate,capReached,notFound) y los límites del plan. - Recibe:
name*,icon,color,products - Campos de salida:
basketId,name,lines,linesAdded,notes,caps,quota,asOf,sources - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con un token de alcance
prices:write. Las canastas viven en la propia cuenta de facturillo de la persona. - Qué cambia: Crea una canasta en la cuenta, que se ve de inmediato en la app de facturillo.
- Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), límites de las canastas, argumento rechazado
- Anotaciones:
readOnlyHintfalse,destructiveHintfalse
basket_add_products Escritura
- Devuelve: El resultado de cada producto (
added,duplicate,capReached,notFoundoerror) y la canasta después del cambio. - Recibe:
basketId*,products* - Campos de salida:
basketId,results,lineCount,linesMax,notes,quota,asOf,sources - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con un token de alcance
prices:write. Las canastas viven en la propia cuenta de facturillo de la persona. - Qué cambia: Agrega líneas de producto a una canasta, que se ven en la app.
- Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), límites de las canastas, argumento rechazado
- Anotaciones:
readOnlyHintfalse,destructiveHintfalse
basket_remove_product Escritura sensible
- Devuelve: El número de líneas de la canasta después del cambio.
- Recibe:
basketId*,product* - Campos de salida:
basketId,removed,lineCount,notes,quota,asOf,sources - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con un token de alcance
prices:write. Las canastas viven en la propia cuenta de facturillo de la persona. - Qué cambia: Quita una línea de producto de una canasta.
- Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), límites de las canastas, argumento rechazado
- Anotaciones:
readOnlyHintfalse,destructiveHinttrue
basket_delete Escritura sensible
- Devuelve: Los límites del plan después del cambio.
- Recibe:
basketId* - Campos de salida:
basketId,deleted,caps,quota,asOf,sources - Quién puede llamarla: Un miembro activo de una organización con el Price Radar activo, con un token de alcance
prices:write. Las canastas viven en la propia cuenta de facturillo de la persona. - Qué cambia: Borra una canasta de la cuenta y de la app.
- Errores: límite de solicitudes, rechazo de la organización (acceso terminado, Price Radar no activo, conector no disponible), límites de las canastas, argumento rechazado
- Anotaciones:
readOnlyHintfalse,destructiveHinttrue
Privacidad y soporte
Lo que el asistente puede hacer con tu cuenta, qué recibe y cómo revocar la conexión está en la política de privacidad de facturillo, en la sección "Conexiones con Asistentes de IA (Conector de IA de facturillo)" y en su parte "Cuestio: el panel de organizaciones y su conexión al Price Radar". Cuestio es un producto de facturillo Inc.
Soporte: info@facturillo.com