Has construido tu catálogo de Shopify para humanos. Ahora también necesita funcionar para los rastreadores agénticos.
Published: March 23, 2026
La mejor guía para empezar a trabajar con el Catalog MCP y el Catalog API de Shopify
La tesis
Tu catálogo de productos de Shopify está siendo leído por dos audiencias fundamentalmente diferentes: humanos que navegan por tu tienda, y agentes de IA que consultan los datos de tus productos de forma programática para hacer recomendaciones en nombre de otra persona.
La mayoría de las marcas han pasado años optimizando para la primera audiencia. Descripciones de productos ricas, fotografía de estilo de vida, PDPs optimizados para conversión. Nada de eso ayuda mucho a la segunda audiencia.
Este artículo usa un producto real, la crema de ojos Full Orbit de Glossier, para mostrar cómo se ve esa brecha en la práctica y qué significa para las marcas que piensan en el comercio agéntico.
La capa de infraestructura que la mayoría de las marcas aún no han notado
Shopify ha construido el Catalog MCP, un servidor de Model Context Protocol que sirve como la infraestructura principal de descubrimiento de productos para el comercio agéntico en la plataforma Shopify. Está construido alrededor del Universal Commerce Protocol (UCP), un estándar para cómo los agentes de IA encuentran, evalúan y realizan transacciones con productos.
El Catalog MCP envuelve el Catalog REST API de Shopify y le da a cualquier agente construido según el estándar UCP una forma de:
- Buscar en todos los productos elegibles de Shopify basándose en palabras clave, rango de precios y ubicación de envío
- Consultar los detalles completos de variantes de productos específicos, incluyendo descripciones, características, especificaciones y URLs de checkout
Los comerciantes elegibles de Shopify ya están en este catálogo. La pregunta no es si tus productos están siendo consultados. Es qué encuentran los agentes cuando los consultan.
Agentic storefronts
Your active products are automatically discoverable.
Review how your product data is sent to the Shopify Catalog for agentic storefronts
La vista de Agentic storefronts en el panel de administración de Shopify: ChatGPT y Microsoft Copilot son las dos primeras superficies de IA conectadas.
ChatGPT
Free
By selling on this sales channel, you agree to Agentic Storefronts Supplemental Terms
Checkout
Products
Publishing
Shopify catalog is used to send product data to this sales channel
Al hacer clic en ChatGPT se muestran los detalles del canal de ventas: el checkout se queda en tu tienda y los datos de producto fluyen a través del Shopify Catalog.
Ambas pantallas se encuentran en Settings > Sales channels en el panel de administración de Shopify.
Hay tres vías que un agente puede tomar para llegar a tu catálogo:
| Vía | Alcance | Autenticación requerida |
|---|---|---|
| Catalog MCP | Todos los comerciantes elegibles de Shopify a nivel global | Sí (JWT) |
| Storefront MCP | Solo una tienda individual | No |
| Catalog REST API | Todos los comerciantes elegibles de Shopify a nivel global | Sí |
Shopify describe el Catalog MCP como la vía recomendada para la mayoría de las implementaciones de comercio agéntico.
Dos endpoints. Dos imágenes muy diferentes.
Cuando un agente de IA quiere saber sobre un producto en tu tienda de Shopify, tiene dos vías principales para acceder a tus datos. La vía heredada es el endpoint público /products.json. Es accesible sin autenticación, estructurado como JSON, y la forma predeterminada en que los bots y scrapers han leído los catálogos de Shopify durante años. La vía moderna es el Catalog MCP y el Catalog API, diseñados específicamente para el consumo agéntico.
Aquí está la comparación completa lado a lado para el Full Orbit de Glossier, extraída directamente de ambos endpoints:
| Campo | /products.json |
Catalog API | Estado del campo en Catalog API |
|---|---|---|---|
| Product ID | 8185258410229 | gid://shopify/p/5vhkcE78u4c7P2hhO30zEh | Required |
| Title | Full Orbit | Full Orbit | Required |
| Vendor | Glossier | Glossier | Required |
| Description | Bloque HTML de 4,000 caracteres | “A hydrating, brightening eye cream that smooths fine lines and reduces dark circles and puffiness.” (98 caracteres) | Generado por IA (sin override del comerciante) |
| Unique Selling Point | No presente | “Combines brightening, hydrating, and smoothing effects in one tube-packaged eye cream.” | Generado por IA (sin override del comerciante) |
| Top Feature 1 | No presente | Brightening formula reduces the appearance of dark circles for a more awake look | Generado por IA (sin override del comerciante) |
| Top Feature 2 | No presente | Hydrating ingredients keep the under-eye area moisturized and comfortable | Generado por IA (sin override del comerciante) |
| Top Feature 3 | No presente | Smoothing action helps minimize fine lines for a youthful appearance | Generado por IA (sin override del comerciante) |
| Top Feature 4 | No presente | Depuffing effect soothes and refreshes tired eyes | Generado por IA (sin override del comerciante) |
| Top Feature 5 | No presente | Tube dispenser allows for easy, mess-free application | Generado por IA (sin override del comerciante) |
| Tech Spec: Dispenser Type | No presente | Tube | Generado por IA (sin override del comerciante) |
| Tech Spec: Product Form | No presente | Cream | Generado por IA (sin override del comerciante) |
| Tech Spec: Skin Care Effects | No presente | Brightening, Hydrating, Smoothing, Anti-dark circle, Anti-puffiness | Generado por IA (sin override del comerciante) |
| Tech Spec: Brand | No presente | Glossier | Generado por IA (sin override del comerciante) |
| Secondhand | No presente | False | Generado por IA (sin override del comerciante) |
| Variant Description | No presente | 2,312 caracteres en texto plano (HTML eliminado) | Optional |
| Price | $28.00 | $28.00 USD | Required |
| Available for Sale | No presente | True | Required |
| Checkout URL | No presente | URL directa de checkout de variante | Required |
| Variant URL | No presente | URL de página de producto con parámetro de variante | Required |
| Rating | No presente | No presente | Optional |
| Image Count | 10 | 10 | Required |
| SKU | FOE-000-00-00 | No presente | — |
| Barcode | 810086254095 | No presente | — |
| Tags | 11 etiquetas internas (bfcm-eligible, pricing_export, etc.) | No presente | — |
| Product Type | Skincare | No presente | — |
Generado por IA (sin override del comerciante) significa que la IA de Shopify genera el valor. Los comerciantes no tienen un mecanismo directo para declarar o sobrescribir estos campos. Los campos Required son controlados por el comerciante o la plataforma y se garantiza que estén presentes. Los campos Optional están presentes cuando están disponibles. Los campos marcados con — existen solo en /products.json y no tienen equivalente en el Catalog API.
El endpoint /products.json le da a un agente un muro de HTML más campos de logística interna. El Catalog API le da un resumen estructurado, libre de etiquetas internas y enfocado en lo que un agente necesita para hacer una recomendación y completar una compra.
Un agente que intenta responder “¿cuál es una buena crema de ojos ligera para ojeras?” tiene que trabajar significativamente más cuando todo lo que tiene es HTML sin procesar. Los resultados tienen más probabilidades de no reflejar tu posicionamiento real.
Cómo se ve realmente la descripción HTML para un agente
La descripción HTML del Full Orbit comienza así, exactamente como aparece en /products.json:
<p class="pv-details__info-item pv-details__tagline">
<strong>A 360° reset for every, single eye.</strong>
</p>
<p id="description-item" class="pv-details__info-item">
A multi-benefit, 360° eye cream that tackles the concerns
you care about mostâimmediately hydrating for up to 24 hours...
Antes de que un agente pueda extraer una sola oración útil, tiene que eliminar nombres de clases CSS, etiquetas span, declaraciones inline de charset y artefactos de codificación rotos como ° y â. Los datos de estudios clínicos están incrustados en línea con las afirmaciones del producto. Las menciones de ingredientes están en elementos de lista mezclados con texto de marketing.
Compara eso con lo que devuelve el Catalog API como descripción corta:
“A hydrating, brightening eye cream that smooths fine lines and reduces dark circles and puffiness.”
Son 98 caracteres. Es directo, texto plano e inmediatamente analizable. Un agente puede usar eso en una recomendación sin ningún procesamiento.
La brecha no es solo cuestión de longitud. Es cuestión de densidad de señal. La descripción del Catalog API le dice a un agente exactamente qué hace el producto. La descripción HTML hace que un agente adivine.
El problema de los campos “Inferred”: cuando la IA de Shopify escribe el texto de tu producto
Esta es la parte con la que la mayoría de las marcas aún no se han enfrentado.
El Catalog API de Shopify marca ciertos campos con la etiqueta “Inferred” en su documentación de referencia. Son campos que la IA de Shopify genera automáticamente cuando un comerciante no los ha proporcionado explícitamente. La documentación señala que los campos inferidos pueden no estar siempre presentes y que la precisión varía según los datos de producto disponibles.
Estos son los campos exactos marcados como Inferred en los endpoints de Search y Lookup:
| Campo | Endpoint | Descripción |
|---|---|---|
description |
Search + Lookup | Descripción detallada del producto |
uniqueSellingPoint |
Search + Lookup | La propuesta de valor distintiva |
topFeatures |
Search + Lookup | Array de características principales del producto |
techSpecs |
Search + Lookup | Array de especificaciones técnicas |
options |
Search + Lookup | Array de opciones/variantes del producto |
attributes |
Search | Atributos del producto como pares nombre-valor |
secondhand |
Search + Lookup | Si la variante es de segunda mano |
A modo de contraste, los campos que Shopify marca como Required son los transaccionales: price, availableForSale, checkoutUrl, variantUrl, shop. Shopify controla la capa transaccional. La capa de descripción es tuya para completar, o la IA de Shopify la llena.
Los campos más importantes para las recomendaciones de agentes, description, uniqueSellingPoint, topFeatures y techSpecs, son todos generados por IA sin mecanismo de override por parte del comerciante.
Si tu marca no ha completado valores limpios y estructurados para estos campos, la versión de tu producto que ven los agentes está siendo escrita por la IA de Shopify. No por ti.
Los datos del Catalog API del Full Orbit en nuestra comparación en realidad muestran todos estos campos completados. Al observar los valores, se dividen en dos grupos que sugieren orígenes diferentes.
Algunos parecen datos de producto estructurados que Glossier probablemente proporcionó directamente:
secondhand: False, un indicador binario, no algo que generarías a partir de una descripcióntechSpecs: Brand: Glossier, metadatos básicos del productotechSpecs: Dispenser Type: Tube, un atributo físico del productotechSpecs: Product Form: Cream, un atributo de categoría de producto
Otros se leen como texto generado a partir de la descripción HTML:
uniqueSellingPoint: "Combines brightening, hydrating, and smoothing effects in one tube-packaged eye cream.", una oración sintetizada, no un campo de producto estándartopFeatures, cinco declaraciones de beneficios que reflejan de cerca el lenguaje de la descripción HTML pero reestructuradas en líneas discretasdescription: "A hydrating, brightening eye cream that smooths fine lines and reduces dark circles and puffiness.", una versión comprimida en texto plano del párrafo inicial del HTML
Este patrón sugiere que las especificaciones técnicas y los indicadores binarios pueden provenir de la taxonomía de productos de Shopify y de los campos estándar de producto, mientras que los campos con mucho texto (USP, características principales, descripción corta) probablemente se generan a partir de la descripción del producto. Nada está confirmado, solo Glossier y Shopify conocen el mecanismo de entrada real. Pero los datos son consistentes con esa división.
De cualquier manera, la salida del Full Orbit es coherente y útil para un agente. El riesgo está con los productos donde el material fuente es más escaso. Considera lo que sucede con:
- Un producto donde la descripción HTML es mayormente lenguaje de marketing con pocos detalles específicos
- Un producto nuevo donde la descripción aún no se ha desarrollado completamente
- Un producto reformulado donde el texto anterior sigue activo
- Un producto donde tu posicionamiento es sutil y requiere contexto para transmitirse con precisión
En cada uno de estos casos, una descripción inferida por IA puede perder completamente el punto. Esa es la descripción que los agentes usan cuando recomiendan tu producto a alguien.
No puedes revisar los valores de los campos inferidos antes de que se sirvan a los agentes. La única forma de asegurar que los agentes trabajen con descripciones precisas y controladas por la marca es completar los campos tú mismo.
Cómo los agentes realmente encuentran tus productos: Search, luego Lookup
El flujo de trabajo del Catalog MCP sigue un patrón de dos pasos que tiene implicaciones directas sobre cómo se usan los datos de tu catálogo.
Paso 1: Search. Un agente traduce un prompt del usuario como “encuéntrame una crema de ojos ligera que ayude con las ojeras por menos de $30” en una consulta de búsqueda contra el Catalog. Los resultados se agrupan por Universal Product ID (UPID), lo que previene duplicados cuando el mismo producto es vendido por múltiples comerciantes. Cada resultado de búsqueda incluye:
- Título y descripción del producto
- Rango de precios entre todos los vendedores
- Opciones disponibles (tamaño, tono, etc.)
- Una lista de comerciantes con sus precios específicos y URLs de checkout
Paso 2: Lookup. Usando el UPID del resultado de búsqueda, el agente recupera los detalles completos de variantes para el producto específico, incluyendo descripciones completas, características clave, especificaciones técnicas, todos los precios a nivel de variante y URLs de checkout para la oferta de cada comerciante.
La implicación de la agrupación por UPID merece una pausa. Si tu producto es el mismo SKU vendido por múltiples comerciantes de Shopify (a través de venta mayorista, revendedores autorizados o acuerdos de marketplace), esas ofertas se presentan juntas en un único resultado agrupado, con comparación de precios. El agente (y el usuario) pueden ver todos los precios disponibles a la vez. La calidad del catálogo afecta no solo si tu producto aparece, sino si tu oferta es la que se selecciona cuando múltiples comerciantes están vendiendo el mismo artículo.
Por qué esto importa a medida que los agentes se convierten en compradores
El cambio que está ocurriendo ahora es que los agentes de IA están pasando de ser asistentes de investigación a participantes en transacciones. Los agentes de compras no solo presentan información. Cada vez más pueden iniciar compras, usando exactamente el tipo de URL de checkout a nivel de variante que el Catalog API devuelve.
Cuando un agente puede agregar un producto a un carrito o generar un enlace de checkout, la calidad de los datos que tiene sobre tu producto afecta directamente si tu producto es recomendado y si la recomendación es precisa.
Hay tres cosas en juego:
Descubribilidad. Si un agente no puede analizar con confianza qué hace tu producto y para quién es, no lo mostrará en respuesta a consultas relevantes. Los campos limpios y estructurados le dan a los agentes la confianza para hacer una recomendación.
Precisión. Un agente que trabaja con HTML puede generar su propio resumen de tu producto basándose en lo que puede extraer. Ese resumen puede omitir afirmaciones clave, caracterizar erróneamente el caso de uso, o eliminar datos clínicamente validados por completo. No controlas lo que el agente dice sobre tu producto, pero sí controlas los insumos con los que trabaja.
Conversión. El Catalog API incluye una URL directa de checkout para cada variante. Los agentes con capacidad transaccional necesitan exactamente esto: una ruta legible por máquinas desde la recomendación hasta la compra. Si ese campo no está completado y es preciso, la ruta de conversión se rompe antes de comenzar.
Los campos que impulsan las decisiones de los agentes
No todos los campos del catálogo tienen el mismo peso para los endpoints agénticos. Según cómo los agentes de IA procesan y clasifican los datos de productos, estos son los que más importan:
| Campo | Nombre del campo en la API | Estado | Por qué importa |
|---|---|---|---|
| Descripción corta | description |
Generado por IA (sin override del comerciante) | Señal principal para coincidencia de consultas y texto de recomendación |
| Propuesta de valor única | uniqueSellingPoint |
Generado por IA (sin override del comerciante) | Diferencia tu producto en un contexto de comparación |
| Características principales | topFeatures |
Generado por IA (sin override del comerciante) | Se mapea a consultas de intención del usuario como “mejor para ojeras” |
| Especificaciones técnicas | techSpecs |
Generado por IA (sin override del comerciante) | Permite filtrado por formato, ingrediente o tipo de dispensador |
| Atributos del producto | attributes |
Generado por IA (sin override del comerciante) | Pares nombre-valor usados para filtrado estructurado |
| Disponible para venta | availableForSale |
Required | Los agentes depriorizan u omiten artículos agotados |
| URL de checkout | checkoutUrl |
Required | Requerido para cualquier capacidad transaccional del agente |
| URL de variante | variantUrl |
Required | Ruta alternativa cuando el checkout nativo no está disponible |
Los campos inferidos son los que describen qué es tu producto y por qué alguien debería comprarlo. Los campos requeridos son los que completan la transacción. Shopify garantiza el segundo grupo. El primer grupo es tu responsabilidad.
Qué auditar en tu catálogo hoy
Si eres propietario de una marca que gestiona un catálogo de Shopify, hay algunas cosas específicas que vale la pena verificar ahora, antes de que los agentes de IA se conviertan en una mayor proporción de tu tráfico y antes de que la IA transaccional sea la norma.
Revisa tu descripción corta. ¿Cada producto tiene un resumen conciso en texto plano que comienza con lo que hace el producto? No tu eslogan. No tu gancho de marketing. Una descripción funcional que un agente pueda usar para hacer coincidir el producto con la solicitud de un usuario.
Revisa tus campos de características. ¿Estás completando campos discretos de características principales, ya sea de forma nativa en Shopify o a través de un metafield o feed del Catalog API? Si toda la información de tu producto vive en un solo bloque de descripción HTML, le estás dando a los agentes un bloque indiferenciado con el cual trabajar.
Revisa tus datos de disponibilidad. Los productos agotados que aún aparecen como disponibles crean errores de recomendación. Los agentes que recomiendan productos que los usuarios no pueden comprar erosionan la confianza en el agente y en tu marca.
Revisa tus URLs de checkout. Si estás integrado con algún feed de compras o plataforma de comercio con IA, verifica que las URLs de checkout a nivel de variante se estén completando con precisión. Un enlace de checkout roto o genérico rompe la ruta de conversión por completo.
Revisa tus descripciones de variantes. Las páginas de producto a menudo tienen descripciones detalladas que no se llevan al nivel de variante. Para productos con múltiples SKUs, los agentes pueden estar consultando a nivel de variante y encontrando campos vacíos.
Revisa tus campos inferidos. El Catalog MCP de Shopify marca los campos como “Inferred” cuando los comerciantes no los han completado explícitamente. Para los campos que los agentes ponderan más (descripción corta, propuesta de valor única, características principales), verifica que tu marca haya completado valores explícitos en lugar de dejarlos a la inferencia de la IA. No existe un mecanismo para revisar o corregir los valores inferidos antes de que se sirvan a los agentes.
Revisa tus fuentes de Catalog Mapping. Si estás en el plan Agentic, el Shopify Catalog Mapping (Settings > Shopify Catalog Mapping) te permite redirigir la fuente de tres campos clave a un metafield o metaobject en lugar del atributo de producto predeterminado. Estos son los insumos que alimentan el pipeline de inferencia ML.
Product fields
Change the sources for standard fields on the Shopify Catalog
Shopify Catalog Mapping (Settings > Shopify Catalog Mapping). Cada fuente puede redirigirse a un metafield o metaobject. Esto controla lo que entra al pipeline de ML, no lo que el pipeline produce.
El cambio más amplio: el catálogo como infraestructura
Durante la mayor parte de la era de Shopify, el catálogo de productos era material de ventas, contenido que escribías para humanos que navegaban por tu tienda. El PDP era el punto final.
Ese modelo está cambiando. Tu catálogo ahora es infraestructura que múltiples tipos de consumidores leen: humanos en tu tienda, rastreadores de motores de búsqueda, motores de comparación de precios y, cada vez más, agentes de IA que hacen recomendaciones y compras en nombre de los usuarios.
Las marcas que inviertan en la calidad del catálogo ahora (campos estructurados, texto limpio, metadatos completos) tendrán una ventaja compuesta a medida que el comercio agéntico escale. Las marcas que no lo hagan encontrarán que sus productos están siendo resumidos de forma inexacta, depriorizados por agentes que no pueden analizar los datos, o ausentes de las recomendaciones por completo.
El ejemplo de Glossier es instructivo no porque Glossier haya hecho algo mal. Sus descripciones HTML son ricas, detalladas y claramente escritas para lectores humanos. Es instructivo porque muestra que el contenido escrito para lectura humana y los datos estructurados para consumo de agentes son dos cosas diferentes. Ambos importan ahora.
Referencia de documentación de Shopify
Las siguientes páginas de la documentación para desarrolladores de Shopify son las fuentes principales para la información del Catalog MCP y del Catalog API en este artículo.
Visión general del catálogo
- About Shopify Catalog, visión general del Catalog MCP, Storefront MCP y Catalog REST API, incluyendo la definición de campos Inferred
- Universal Commerce Protocol (UCP), el estándar sobre el cual se construye el Catalog MCP
Referencias del MCP
- Catalog MCP reference, herramientas, parámetros y esquemas de respuesta para
search_global_productsyget_global_product_details - Storefront MCP reference, alternativa de alcance de tienda única al Catalog MCP
Referencias del Catalog REST API
- Catalog REST API overview, autenticación, límites de tasa e índice de endpoints
- Search endpoint, esquema completo de campos para resultados de Search, incluyendo qué campos están marcados como Inferred
- Lookup endpoint, esquema completo de campos para respuestas de detalle de producto, incluyendo qué campos están marcados como Inferred
- Lookup by variant, esquema de lookup a nivel de variante
- Bulk lookup, recuperación de detalles de producto por lotes
Preguntas frecuentes
¿Qué es el comercio agéntico?
El comercio agéntico se refiere a agentes de IA que investigan, comparan y recomiendan productos de forma autónoma en nombre de los usuarios, y cada vez más, completan compras.
- Los agentes de compras leen datos de productos de forma programática, no navegando por una tienda
- Generan recomendaciones basadas en campos estructurados como descripciones, características y especificaciones
- Los agentes transaccionales pueden iniciar checkouts usando URLs de checkout a nivel de variante
- La calidad de tus datos de producto afecta directamente si tus productos son recomendados
¿Cómo leen los agentes de compras con IA un catálogo de Shopify?
El Catalog MCP de Shopify es la vía principal para el comercio agéntico. Sigue un flujo de Search, luego Lookup.
- Catalog MCP: La vía recomendada. Busca en todos los comerciantes elegibles de Shopify a nivel global; requiere autenticación JWT
- Catalog REST API: Los mismos datos que el MCP, consultables directamente
- Storefront MCP: Limitado a una sola tienda; sin autenticación requerida; útil para agentes de una sola marca
/products.json: Endpoint público heredado; devuelve HTML sin procesar; sin características estructuradas ni URLs de checkout- Los agentes que usan el Catalog MCP siguen un flujo de dos pasos: Search por palabra clave/preferencia para obtener UPIDs, luego Lookup por UPID para recuperar los detalles completos de variantes
¿Qué campos de producto son más importantes para los agentes de IA?
Los campos de mayor señal para los endpoints agénticos son los que se mapean directamente a cómo los agentes hacen coincidir los productos con la intención del usuario.
- Descripción corta en texto plano (el ejemplo del Full Orbit tiene 98 caracteres)
- Propuesta de valor única
- Características principales discretas
- Especificaciones técnicas estructuradas
- Estado de disponibilidad
- URL de checkout a nivel de variante
¿Importa si las descripciones de mis productos están escritas en HTML?
Sí. El marcado HTML añade ruido que los agentes deben eliminar antes de procesar.
- Una descripción HTML de 4,000 caracteres con clases CSS y etiquetas inline es más difícil de analizar que un resumen en texto plano de 100 caracteres
- El Catalog API elimina el HTML pero no puede arreglar descripciones que son semánticamente poco claras una vez que se elimina el marcado
- Las descripciones escritas para presentación visual pueden no ser efectivas cuando se renderizan como texto plano
- Las mejores descripciones son claras y fáciles de analizar tanto en contextos de lectura humana como de máquina