VTEX Companion

Identifica a tecnologia VTEX do site, abre o preview do FastStore no localhost e chama as APIs com a sessão da aba.

VTEX Companion lê a stack, o catálogo e o SEO da loja VTEX que você já tem aberta, chama as APIs dessa loja com a sessão da própria aba e abre o preview do CMS do FastStore no seu servidor local. É 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