Verificador UCP
Digite o endereço de uma loja e veja se o arquivo de descoberta UCP realmente existe — e se é realmente válido.
UCP (Universal Commerce Protocol) é o padrão aberto que permite que um assistente de IA compre em nome de uma loja. Uma loja que fala UCP publica um perfil JSON legível por máquina em /.well-known/ucp — sua versão do protocolo, os serviços que oferece, os processadores de pagamento que aceita e as chaves públicas com que assina. Este verificador baixa esse arquivo do nosso servidor, confere-o com as regras de hospedagem e de perfil da especificação oficial e testa os endpoints que ele declara. O verificador de prontidão para agentes procura o arquivo de descoberta como um sinal entre muitos; esta ferramenta é a análise aprofundada do UCP. O artigo o que é UCP e como verificá-lo examina um documento real passo a passo.
Última atualização:
Verificar uma loja
Resultados
Achados
Documento analisado
Documento original (JSON)
Copiado.
Não há documento a mostrar — a transferência não devolveu um perfil utilizável.
🔒 O destino é baixado pelo nosso servidor de verificação, nunca pelo seu navegador — sem bloqueio CORS, e a loja vê a requisição do verificador, não a sua. Nada sobre você é enviado à loja.
O que há em /.well-known/ucp
Um perfil UCP é um objeto JSON com um membro ucp obrigatório. Dentro dele, ucp.version, ucp.services e ucp.payment_handlers são obrigatórios — os dois últimos devem estar presentes mesmo quando vazios. ucp.capabilities é opcional, embora um perfil comercial útil normalmente anuncie pelo menos uma. Um array keys[] de nível superior pode publicar as chaves públicas de assinatura da loja como um conjunto JWK segundo a RFC 7517.
As versões são datas, nunca palavras como "draft": a primeira versão foi 2026-01-11 e a versão estável mais recente é 2026-08-25. Um perfil que declara uma versão antiga ainda valida, mas este verificador avisa — e lista abaixo as mudanças incompatíveis — porque as contrapartes podem rejeitar entradas cuja versão não corresponda à do perfil. Uma loja que ainda serve versões antigas lista-as em supported_versions, cada uma apontando para o seu próprio perfil de versão.
Entre as mudanças incompatíveis de 2026-08-25, estas afetam um perfil publicado: o campo antigo signing_keys[] foi removido e substituído pelo array keys[] de nível superior; a configuração de fulfillment foi reestruturada (as opções perderam o prefixo allows_ e multi_destination passou de mapa para array); o consentimento do comprador passou de opções booleanas fixas para um mapa dinâmico com chaves de domínio reverso; e as extensões de pagamento passaram de dev.ucp.shopping.* para dev.ucp.common.payment.*.
As regras de hospedagem são rígidas porque os perfis são material de confiança: um perfil deve ser servido por HTTPS, não deve redirecionar (qualquer 3xx é uma falha) e deve trazer Cache-Control: public com max-age de pelo menos 60 segundos — nunca private, no-store nem no-cache. As lojas Shopify servem um perfil 2026-08-25 em /.well-known/ucp por padrão — experimente o botão de demonstração.
O que este verificador faz — e o que não faz
Ele baixa, valida e testa — a partir do servidor. O verificador solicita https://<domínio>/.well-known/ucp diretamente (uma requisição, sem seguir redirecionamentos), valida o documento com as regras desta página e testa cada endpoint declarado com uma requisição HEAD (GET quando HEAD é recusado). Seu navegador nunca contata o destino, então a verificação não é bloqueada por CORS.
Ele não faz pedidos, não se autentica como comprador e não valida a criptografia dos processadores de pagamento. Um perfil aprovado aqui prova que a loja pode ser descoberta e que seus endpoints são alcançáveis — não que o pagamento vá funcionar, que o preço esteja certo ou que um processador de pagamento seja confiável.
Ele não verifica documentos ACP, AP2 ou x402 — apenas UCP. Um endpoint declarado inalcançável é um aviso, não um erro: o endpoint pode exigir autenticação, e uma resposta 401 ou 404 ainda conta como alcançável, porque o servidor respondeu. Só uma conexão que falha completamente conta como inalcançável.
Seja honesto consigo mesmo antes de confiar em um perfil
Um perfil válido não é um pagamento que funciona. A descoberta é o primeiro passo: o perfil diz o que a loja oferece e onde estão seus endpoints. Se esses endpoints aceitam requisições reais, devolvem preços reais e concluem um pedido real é outra questão, e este verificador não a responde.
Uma versão antiga é um aviso, não uma falha, por um motivo. Uma loja em 2026-04-08 ainda pode operar com uma plataforma que fale 2026-04-08 — mas uma plataforma que só fale 2026-08-25 deve rejeitar as entradas cuja versão não corresponda, então um perfil antigo reduz quem pode comprar ali.
Um 404 geralmente significa "aqui não há UCP", não "loja quebrada". A maioria dos sites da internet não publica nenhum perfil UCP — a demonstração negativa mostra exatamente isso. Trate um perfil ausente como um fato sobre a prontidão da loja para agentes, não como um erro da loja em si.
Fatos principais
| Universal Commerce Protocol | O padrão aberto que permite que um assistente de IA descubra o catálogo, o checkout e o pós-venda de uma loja, e compre em nome de um comprador. |
| Arquivo de descoberta | O perfil JSON publicado em /.well-known/ucp no próprio domínio da loja. |
| Versão mais recente | 2026-08-25. As versões são datas; a primeira versão foi 2026-01-11. |
| Campos obrigatórios | ucp.version, ucp.services, ucp.payment_handlers — os dois últimos devem estar presentes mesmo quando vazios. ucp.capabilities é opcional. |
| Regra de cache | Cache-Control: public com max-age de pelo menos 60 segundos; nunca private, no-store nem no-cache. |
| Regra de redirecionamento | Os perfis devem ser servidos por HTTPS sem redirecionamentos — qualquer resposta 3xx é uma falha. |
| Especificação oficial | Universal Commerce Protocol (UCP) Official Specification |
Perguntas frequentes
Por que a verificação roda em um servidor e não no meu navegador?
Porque os navegadores bloqueiam leituras entre origens. Uma página em sysosx.com não pode baixar o /.well-known/ucp de outra loja diretamente — o servidor da loja teria de permitir com cabeçalhos CORS, e a maioria não permite. O verificador baixa o arquivo do seu próprio servidor, onde essa restrição não se aplica, e devolve o resultado ao seu navegador.
Minha loja está na Shopify — preciso publicar alguma coisa?
Não. A Shopify serve um perfil 2026-08-25 em /.well-known/ucp em todas as lojas por padrão — experimente o botão de demonstração, que verifica allbirds.com. Se a sua loja está na Shopify e a verificação falha, o problema está em outro lugar (um redirecionamento na frente da loja, ou um domínio personalizado que não serve a loja).
O documento existe, mas o veredito é "parcial" — o que corrijo primeiro?
Corrija primeiro os achados marcados como Falha: um campo obrigatório ausente (versão, serviços ou processadores de pagamento), um documento que não é JSON válido ou um redirecionamento. Os avisos — um cabeçalho de cache abaixo de 60 segundos, uma versão antiga, um endpoint inalcançável — são apenas orientações e por si sós não impedem um veredito de pronto para UCP.