Um catálogo de produtos pronto para agentes é um catálogo que um agente de IA pode recuperar, analisar, raciocinar e agir, sem raspagem, adivinhação ou inferência. Esta página define a forma alvo, o conjunto mínimo de atributos viáveis e as etapas de validação que separam um feed que "funciona" de um catálogo que interopera.
Definição de trabalho
Definição
Um catálogo de produtos está pronto para agentes quando cada SKU possui: um identificador canônico, uma URL endereçável, atributos tipados cobrindo a superfície de consulta da categoria, campos de política explícitos e um estado (preço + disponibilidade) que está atualizado dentro de um SLA de atualização bem definido.
Cinco propriedades de um catálogo pronto para agentes
- Identificável. Cada SKU resolve para um identificador canônico (GTIN, ou MPN+Marca, ou um SKU interno que é estável).
- Endereçável. Cada SKU tem uma URL permanente que retorna dados estruturados sem login ou paredes de consentimento.
- Tipado. Atributos têm nomes, unidades, valores enumerados, não apenas prosa de marketing.
- Consciente de Políticas. Devoluções, garantia, envio, restrições de idade/geo são expressas como dados estruturados, não apenas como texto legal.
- Atualizado. Preço e disponibilidade têm uma janela de atualização documentada, e os feeds correspondem a essa janela.
Conjunto mínimo de atributos viáveis
A lista exata depende da categoria. O seguinte é a linha de base que qualquer agente esperará para um bem de consumo físico.
| Campo | Exemplo | Por que os agentes precisam dele |
|---|---|---|
| id | SKU-39281 | Referência interna, deduplicação |
| gtin | 5012345678900 | Identidade entre comerciantes |
| brand | Patagonia | Filtrar, confiar, corresponder |
| title | Jaqueta de Chuva Feminina Torrentshell 3L | Orientado ao humano, correspondência de consulta |
| description | (semântica, rica em atributos) | Incorporação / recuperação |
| category | Vestuário > Agasalhos > Jaquetas de Chuva | Posicionamento na taxonomia |
| price | 129.00 EUR | Classificação, filtragem |
| price_effective_until | 2026-04-30T23:59:59Z | Honestidade da promoção |
| availability | em_estoque / pré_venda / fora_de_estoque | Confiabilidade |
| stock_qty | 14 | Sinal de escassez |
| shipping | {region, cost, handling_time, delivery_time} | Adequação às restrições do comprador |
| returns | {window, cost, method} | Confiança pré-venda |
| warranty | 2 anos do fabricante | Consideração |
| attributes | {material, waterproof_rating, weight_g, …} | Filtragem de consulta |
| variants | [{size, color, gtin, stock_qty, price}] | Resolver o SKU correto |
| images | [{url, role, alt}] | Verificação visual |
| url | https://merchant.com/p/torrentshell | Entrega / atribuição |
| locale | en-GB, fr-FR, … | Roteamento regional |
| updated_at | Carimbo de data/hora ISO 8601 | Atualização |
Anti-padrões
Padrões que vemos regularmente que degradam silenciosamente o desempenho do agente:
- Títulos apenas de marketing. "Proteção de Chuva Definitiva para Aventureiros Reais", impossível de pesquisar. Prefira "Jaqueta de Chuva Feminina 3L, Torrentshell, Patagonia".
- Atributos dentro da prosa da descrição. Um agente tem que extraí-los. Tipá-los.
- PDPs sensíveis à região sem localidade estruturada. O agente vê uma página francesa com preço em EUR para um comprador dos EUA.
- Incompatibilidade de preço entre o feed e o PDP. Os agentes fazem verificação cruzada; incompatibilidades matam a confiança.
- Estoque definido como "disponível" quando a janela de pedido em atraso é de 6 semanas. Use estados de disponibilidade estruturados.
- Política de devoluções como um único parágrafo de texto livre. Estruture-a.
As três expressões do mesmo catálogo
Um catálogo pronto para agentes deve ser expressável em três formas paralelas. Cada forma serve um canal de recuperação diferente; todas as três devem se reconciliar.
- Dados estruturados no PDP, JSON-LD usando schema.org Product, Offer, AggregateRating, MerchantReturnPolicy, ShippingRateSettings.
- Feed, Google Merchant Center XML/CSV (ou equivalente), enriquecido para cobrir campos de política.
- API / ferramenta MCP, endpoint programático para orquestradores de agentes. Endpoints somente leitura para catálogo, ofertas, inventário, política.
As três formas devem concordar em identificadores e preços. A reconciliação é uma disciplina operacional, não uma exportação única.
Validação e telemetria
Como você sabe que está pronto para agentes:
- Google Rich Results Test, JSON-LD é analisado como Produto e Oferta.
- Diagnósticos do Merchant Center, sem erros de alta gravidade.
- Cobertura do feed, >95% dos SKUs têm marca + GTIN (ou MPN+Marca).
- Paridade de preço, feed e PDP correspondem em >99% dos SKUs amostrados.
- Paridade de estoque, estados de disponibilidade correspondem ao comportamento de checkout em >98%.
- Devoluções / envio estruturados, JSON-LD presente em >90% dos PDPs.
- Volume de rastreamento do agente, tráfego mensurável de agentes OAI, Anthropic, Perplexity, Amazon, GoogleBot; você rastreia via logs do servidor.
Este conjunto é o cerne da nossa metodologia de auditoria.
Shopify, WooCommerce, Salesforce, pilhas personalizadas
Notas específicas da plataforma:
- Shopify, dados estruturados são parciais prontos para uso; metafields são a alavanca. Exponha atributos ricos via Shop / Shopify Shopping APIs à medida que os endpoints do agente evoluem.
- WooCommerce, plugins como RankMath / Yoast cobrem o básico do esquema; dados estruturados de devoluções/envio geralmente exigem trechos personalizados.
- BigCommerce / Adobe Commerce / Salesforce Commerce Cloud, APIs do lado do agente aparecendo nos roteiros de produtos; acompanhe as notas de lançamento do fornecedor.
- Personalizado, a oportunidade é maior e a disciplina exigida é maior. Invista na paridade de esquema, feed e API desde o primeiro dia.
Onde ir em seguida
- Veja o jogo completo do operador em melhores práticas.
- Use a lista de verificação de prontidão para avaliar a sua.
- Leia catálogo como API para o modelo mental mais profundo.
Aprofundamentos
- Dados estruturados Schema.org para agentes de IA: guia completo
- Otimização GEO: apareça em recomendações de produtos geradas por IA
- llms.txt: guia para comerciantes de e-commerce
- Catálogo Shopify otimizado para UCP: guia do comerciante
- Erros de dados de produtos que bloqueiam a descoberta agêntica
- GEO, LLMO, AEO: as novas disciplinas de visibilidade da IA