Integrá con tu agente

Tu agente integra, vos revisás el diff. Con la clave, esta documentación y el MCP de CrossUp, verifica la clave, escribe el snippet y prueba una recomendación y una señal. Dársela es seguro: la clave de storefront es pública y acotada. Por qué, en Claves y seguridad.

Lo que necesita tu agente

Qué	Para qué	De dónde
La clave `spk_…` y el `connection_id`	Pedir recomendaciones y mandar señales de prueba	El admin, en Configuración → Claves para tu storefront
Esta documentación	Saber cómo se integra	`llms.txt`: todo el sitio en un archivo, o cada página como Markdown
El MCP de CrossUp	Leer el catálogo y pedir recomendaciones desde el agente	El MCP
La skill de integrador	Seguir el recorrido de esta doc, con sus verificaciones	La skill

El prompt

Copiá esto en tu agente, con tu clave y tu conexión:

Integrá CrossUp en la página de producto de esta tienda.

Clave de storefront: spk_…
connection_id: cn_…
Documentación: https://docs.crossup.ai/llms.txt

1. Verificá la clave con un GET /v1/catalog/items de un ítem cualquiera.
2. Instalá @crossup/storefront y creá una instancia una sola vez.
3. Pedí una decisión con surface "pdp", placementKey "pdp-related" y el
   item_id del producto de la página. Mostrá results[].product con los componentes
   de la tienda; si no hay resultados, no muestres nada.
4. Reportá track.impression cuando la recomendación entre en pantalla y track.click al abrir un resultado.
5. Mostrame el decision_id de una decisión de prueba y el signal_id aceptado.

No inventes valores que la API no devuelve. Un campo ausente es desconocido, no cero.

Lo que un agente puede hacer hoy, y lo que no

Con la clave de storefront
Leer el catálogo canónico	Sí
Pedir recomendaciones para cualquier momento	Sí
Mandar señales	Sí, por la API; el MCP todavía no las expone
Activar o configurar momentos	No: es del admin
Leer analíticas	No: es del admin
Dar de alta un conector	No: pide una clave de conector

La clave tiene tres permisos y una cuota de 60 pedidos por minuto: un agente no puede hacer nada que la clave no permita.

Qué vas a ver

Un diff con la instancia, el pedido y las dos señales. En la respuesta del agente, un decision_id (el id de la recomendación) y un signal_id con accepted: la misma evidencia que pedirías a una persona.

Si no lo ves

Lo que pasa	Qué hacer
El agente inventa un endpoint o un campo	Dale `llms.txt` o el MCP de la doc
Muestra `0` donde no hay precio	Pegale la regla del modelo canónico: un campo ausente no es un cero
Reintenta en loop ante un `429`	Pegale Cuota y caché
Pide `store_id`	No existe: la tienda sale de la clave

El MCP

Las herramientas que un agente puede llamar.

La skill

El recorrido de integración, como archivo para tu agente.

​Lo que necesita tu agente

​El prompt

​Lo que un agente puede hacer hoy, y lo que no

​Qué vas a ver

​Si no lo ves