VTEX Price Monitor — BR Stores

Pricing

Rating

Developer

Actor stats

Categories

Share

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

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

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.