Universal Commerce Protocol: preparar o WooCommerce para agentes de IA

O que entregamos

• Auditoria do catálogo WooCommerce ou WordPress existente quanto à legibilidade para agentes, incluindo o estado dos endpoints REST em /wp-json/wc/v3/ e os dados estruturados já presentes na página.
• Enriquecimento Schema.org por produto: Product, Offer e AggregateOffer com hasMerchantReturnPolicy, ItemAvailability e PriceSpecification. O resultado é JSON-LD na página, validado contra schema.org.
• Servidor opcional Model Context Protocol com endpoints de catálogo e intenção de compra para clientes agênticos autenticados, a correr ao lado da WordPress REST API e não em sua substituição.
• Arnês de testes ligado à API da Anthropic Claude que percorre o fluxo do agente de ponta a ponta, da pesquisa de produto até à intenção de compra, com transcrições gravadas como base de regressão.
• Observabilidade que separa o tráfego de agentes do tráfego humano na camada analítica, para que atribuição, conversão e custo possam ser reportados por tipo de público.

Porque é que isto não é apenas mais um ajuste de schema.org

Os agentes de IA começam a comportar-se como compradores. Os assistentes residentes no navegador e as superfícies agênticas dentro do Claude e do ChatGPT atuam cada vez mais em nome do utilizador: filtram, comparam e, eventualmente, fecham a transação. A interface de que precisam não é a página visual, mas sim uma superfície legível por máquina para o catálogo e para o fluxo transacional que assenta sobre ele.

Schema.org Product, Offer e AggregateOffer cobrem o lado descritivo. Dizem ao agente o que é um produto, quanto custa, se está em stock e qual a política de devoluções aplicável. Não descrevem como é que um agente se deve autenticar, como sinalizar intenção de compra, ou como é que a loja deve responder quando muitos agentes consultam o stock em simultâneo. É essa lacuna que as normas convergentes estão a preencher.

O Model Context Protocol da Anthropic, publicado pela primeira vez como especificação aberta em novembro de 2024, é um dos passos rumo a interfaces legíveis para agentes. O texto de posição da Automattic de 2026-04-21, que enquadra o WordPress como candidato a sistema operativo da web agêntica, aponta na mesma direção a partir do lado do CMS. A conclusão prática: um catálogo apenas legível por humanos está a ser reavaliado em baixa pelo mercado.

A quem se destina

• Lojas WooCommerce em que o tráfego conduzido por agentes já aparece nos logs e o catálogo não está construído para lhe responder.
• Catálogos B2B com fluxos de proposta, preços regionais e produtos por subscrição, em que uma superfície tipada para agentes ganha ao frágil screen-scraping.
• Sites de conteúdo com afiliação, onde a página é o catálogo e os Offers legíveis por agentes determinam se o site é citado ou ignorado.
• Marcas multi-região com um único CMS a alimentar várias lojas, que precisam de uma fonte única de verdade que os agentes consigam resolver de forma consistente entre línguas.

Modelo de colaboração

B2B senior sob jurisdição da UE. Discovery, scoping, fixed-scope ou time-and-materials. Âmbito e preço são individuais por projeto; não publicamos tabelas-padrão porque o passo de auditoria costuma alterar o custo da implementação.