NewNo plan feeNo plan fee. Just 2.9% + $0.30 per card sale, and signing up is free.Try now →

Comércio agêntico

Como saber se minha loja já suporta checkout por agente?

Atualizado em

Faça uma requisição a /.well-known/ucp no domínio da sua loja. Um documento JSON que nomeia uma versão e manipuladores de pagamento significa que os agentes já podem descobrir sua loja; um 404 significa que não podem. Se a primeira requisição for bem-sucedida, envie uma requisição tools/list para o endpoint MCP que esse documento nomeia para ver as ferramentas de comércio expostas. Das 147 marcas DTC verificadas em agosto de 2026, 70 responderam a ambas — quase sempre porque a plataforma as habilitou, não o comerciante.

As duas requisições

Nenhuma delas precisa de uma chave, um sandbox ou um acordo de parceria, e ambas são seguras para executar no seu próprio storefront de produção — elas leem um documento de descoberta e listam capacidades. Nada é criado e nenhum pedido é feito.

Execute-as no domínio que os clientes realmente digitam. Esse detalhe importa mais do que parece: um front-end headless no domínio do seu cliente pode não fazer proxy dos caminhos que seu backend de comércio serve, então verificar o host do backend pode dizer o oposto do que um agente chegando ao domínio da sua marca encontraria.

  • GET https://yourdomain.com/.well-known/ucp — um perfil JSON significa que a descoberta está ativa.
  • POST uma requisição JSON-RPC tools/list para o endpoint MCP que esse perfil nomeia — a resposta lista as ferramentas de comércio que um agente pode chamar.
  • Leia o content-type em ambas. Um 200 que retorna text/html é sua página de captura geral, não um documento.

Interpretando o resultado honestamente

Uma resposta de descoberta bem-sucedida não é prova de que um agente pode comprar de você. Em todas as lojas que testamos, listar as ferramentas estava aberto, enquanto chamá-las exigia que o agente chamador apresentasse sua própria identidade resolúvel — então um script anônimo recebe uma recusa mesmo onde um agente genuíno não receberia.

Um 404 também não é prova de ausência. Ele informa que nada está sendo servido nesse caminho nesse host hoje. Várias lojas que verificamos usam a mesma plataforma de comércio que as 70 que responderam, e retornaram 404 de qualquer forma, o que aponta para o front-end em vez da plataforma.

O que a verificação realmente resolve é a questão que vale a pena resolver: se a superfície existe sem que ninguém em sua empresa decida que deveria.

O que fazer se a resposta for sim

Trate-o como um canal ativo que surgiu sem um lançamento. As premissas operacionais por trás dele são as mesmas de qualquer outro canal de vendas, e nenhuma delas foi revisada para este.

As perguntas que valem a pena fazer na primeira semana são pouco glamorosas e todas podem ser respondidas internamente.

  • O estoque é preciso o suficiente para ser cotado por uma máquina que não verificará novamente antes de confirmar?
  • Quais métodos de pagamento estão registrados, e alguém os escolheu pensando em agentes?
  • Quem lida com um reembolso ou uma solicitação de suporte para um pedido que ninguém navegou para?
  • Sua análise distingue esses pedidos de alguma forma, ou eles estão caindo em um balde existente sem rótulo?

O que o arquivo em /llms.txt não informa

É tentador auditar isso a partir de llms.txt, porque é o arquivo sobre o qual todos falam. É um proxy ruim. Doze das 70 lojas que responderam a uma requisição de descoberta publicaram um llms.txt que nunca menciona os endpoints, e sete delas não serviram nenhum llms.txt.

Então uma loja pode ser totalmente transacionável por agente e pontuar zero em uma auditoria de llms.txt. Verifique o caminho de descoberta diretamente.

Perguntas frequentes

Executar essas requisições fará um pedido?
Não. Ambas as requisições somente leitura buscam um documento e listam as capacidades disponíveis. Criar um carrinho ou um checkout requer chamadas separadas e diferentes que você teria que fazer deliberadamente.
Meu documento de descoberta retorna 404. Isso é um problema?
Não por si só. Significa que os agentes não podem descobrir sua loja por esse caminho hoje. Se isso importa, depende se você quer esse canal, e a solução é uma questão de plataforma ou front-end, em vez de algo que você adiciona a uma página.
Um documento de descoberta ativo significa que estou nos resultados do ChatGPT ou Gemini?
Não. Descoberta e visibilidade em motores de resposta são separadas. Um documento de descoberta informa a um agente como transacionar depois que ele decide fazê-lo; ser citado em uma resposta de IA é sobre se suas páginas são rastreáveis e citáveis.

Fontes

Relacionado