VTEX Companion by leocadio.dev

É uma ferramenta de diagnóstico para quem desenvolve em VTEX. Não há servidor: a extensão lê a aba sob demanda e descarta quando o painel fecha. Nada é coletado, nada é transmitido.

DETECÇÃO DA STACK
• É VTEX? Com que confiança e por quais sinais
• Tecnologia: VTEX IO (Store Framework), FastStore, CMS Legacy Portal ou headless
• Account, workspace e binding
• Admin x loja final, e se a URL está num workspace de desenvolvimento
• Tipo de página: home, PDP, listagem, busca, checkout, order placed, login

CATÁLOGO DA PÁGINA
• PDP: produto, referência, marca, categoria e a lista de SKUs com EAN, refId, seller, disponibilidade e preço — mais atalho para o admin
• Listagem e busca: categoria, caminho, termo, map, ordenação e página

SEO DA PÁGINA
• Indexação (robots, googlebot), title, description, canonical, lang
• Open Graph, Twitter, hreflang, JSON-LD, headings e imagens sem alt
• Regras por tipo de página: PDP sem Product, listagem sem ItemList

SCRIPTS DE TERCEIROS
• Quais tags de analytics, publicidade, remarketing e monitoramento a página carrega, com o id da conta quando ele está exposto no próprio script
• Origens de terceiros que a extensão não reconhece, agrupadas por volume de requisições

FETCH RUNNER
• Chame as APIs da loja de dentro da própria aba, com a sessão que ela já tem
• Presets prontos para as APIs de sessão, checkout, catálogo, busca, pedidos e master data da loja
• Confirmação explícita antes de qualquer método que altera dados
• Resposta formatada com realce ou o corpo cru, histórico da sessão e cópia como JSON ou CSV
• Disponível no popup e num painel VTEX Companion dentro do DevTools

SESSÃO
• Os cookies de sessão presentes na origem, com o escopo de cada um
• Clonar a sessão de {account}.myvtex.com para o domínio da loja, sem o token passar pela área de transferência
• Entrar numa origem colando um token, e limpar todos os cookies de sessão de uma vez
• O token nunca é gravado pela extensão nem sai da máquina, e os controles só aparecem em domínio reconhecido como VTEX

PREVIEW DO FASTSTORE NO LOCALHOST
O botão Pré-visualização do CMS do FastStore — o Headless CMS (legacy) e o Storefront > Content — abre a loja publicada. A extensão injeta um botão Localhost ao lado dele que abre a mesma URL no seu dev server, com a query inteira preservada, nas duas versões do CMS e sem depender do cmsDevMode. Também há redirecionamento automático da aba de preview, a última URL capturada com copiar/abrir, e o liga/desliga do cmsDevMode com status por frame.

Lojas em VTEX IO e no portal legacy pré-visualizam por workspace e não usam esse fluxo — a aba Preview diz isso em vez de oferecer controles inertes.

PRIVACIDADE
Não há servidor e nenhum dado é coletado, armazenado remotamente ou transmitido. Não existe content script global: a leitura da página é injetada sob demanda quando você abre o painel, e por isso a instalação não pede "ler dados em todos os sites". O acesso fixo é só a *.myvtex.com e localhost; o domínio da loja é opcional e concedido por você, site a site.
Política de privacidade: https://leocadio.dev/vtex-companion/privacy/

Projeto independente e de código aberto. Não é um produto oficial da VTEX e não usa a identidade visual da VTEX.
Código-fonte: https://github.com/Leocadio94/vtex-companion-extension