VTEX Price Monitor — BR Stores

Monitora preços de produtos em lojas brasileiras feitas em VTEX (Americanas, Submarino, Shoptime e qualquer loja VTEX) e detecta mudanças de preço entre execuções via a API pública de catálogo. Sem browser, sem API key, sem proxy.

Por que usar

Consome a API REST de catálogo da VTEX (/api/catalog_system/pub/products/search), então o resultado é estável, tipado e rápido — nada de seletores HTML que quebram. O Actor é stateful: guarda um snapshot dos preços no Key-Value Store e, a cada execução, compara com a anterior. Perfeito para repricing, monitoramento de concorrência e revendedores que precisam saber quando um preço mexe.

Como funciona

1. Carrega o snapshot da última execução (vazio na primeira run).
2. Busca os preços atuais da loja (por palavra-chave ou por lista de URLs).
3. Compara produto a produto e marca priceChanged quando o valor difere.
4. Empilha todos os produtos no Dataset (com preço atual, anterior, delta e %).
5. Grava o snapshot novo para a próxima execução.

Primeira execução: ainda não há histórico, então previousPrice é null e priceChanged é false para todos os produtos. A partir da 2ª run o Actor já detecta variações.

Como rodar

1. Preencha storeDomain (ex.: www.americanas.com.br) e searchQuery (ex.: notebook) e clique em Start.
2. Acompanhe o run — os produtos aparecem no Dataset em tempo real.
3. Agende execuções recorrentes no Scheduler da Apify (ex.: a cada 6h) para monitoramento contínuo de preços.
4. Exporte em JSON / CSV / Excel ou consuma via API e MCP.

Input

Campo	Tipo	Obrigatório	Descrição
storeDomain	string	sim	Domínio da loja VTEX (sem https://). Ex.: www.americanas.com.br.
searchQuery	string	—	Palavra-chave a monitorar. Use isto OU productUrls.
productUrls	array	—	Lista de URLs de produtos VTEX específicos. Use isto OU searchQuery.
maxItems	integer	—	Máximo de produtos por execução (1–3000). Padrão 100.
sort	string	—	Ordenação VTEX (OrderByPriceASC, OrderByPriceDESC, etc.) ou vazio.

Exemplo de input

{
  "storeDomain": "www.americanas.com.br",
  "searchQuery": "notebook",
  "maxItems": 20
}

Output

Cada item no Dataset:

{
  "productId": "123456789",
  "name": "Notebook Acer Aspire 5",
  "brand": "Acer",
  "url": "https://www.americanas.com.br/produto/123456789/p",
  "currentPrice": 2799.0,
  "previousPrice": 2999.0,
  "priceChanged": true,
  "delta": -200.0,
  "deltaPercent": -6.67,
  "available": true,
  "currency": "BRL",
  "storeDomain": "www.americanas.com.br",
  "checkedAt": "2026-06-29T00:00:00.000Z"
}

Preço — Pay Per Event

Evento	Preço
price-change-detected	$0.01 por produto cujo preço mudou vs. a execução anterior

Você paga apenas pelo sinal de valor: a primeira execução e produtos com preço estável custam zero. Só há cobrança quando um preço efetivamente muda.

Use com agentes de IA (MCP)

Este Actor é compatível com o Apify MCP Server — agentes de IA (Claude, ChatGPT, Cursor) podem chamá-lo diretamente: conecte o MCP Server, o agente descobre o Actor pelo nome vtex-price-monitor, lê o input_schema e chama com o input desejado. O dataset_schema garante output tipado e estável.

FAQ

• Preciso de API key ou login? Não — a API de catálogo da VTEX é pública.
• Funciona com qual loja? Qualquer loja feita em VTEX (Americanas, Submarino, Shoptime e milhares de e-commerces BR).
• Como detecto mudanças? Rode em agendamento recorrente — o Actor mantém o histórico de preços entre execuções automaticamente.
• Em quais formatos exporto? JSON, CSV, Excel, HTML table, ou via API/MCP.
• O formato do output muda entre execuções? Não — o dataset_schema mantém os campos estáveis.

Changelog

• 0.1 — primeira versão: monitor de preços VTEX com diff entre execuções via Key-Value Store.