%

Área administrativa

← Voltar aos preços
%

Preços com cupom

Administração
Operação
Visão geral Contas Automação
Mercado Livre
Cupons Listas de links
Lista de desejos
Revisar sugestões Itens Alertas enviados Estatísticas IA e Telegram
Promoções
Canal de promoções Alertas pessoais
Sistema
Logs Configurações
Central de promoções ↗ Ver preços ↗

Visão geral

…

Varrer agora

Carteira, cupons novos e produtos, dentro do limite por varredura.

Contas

Gerenciar

Resumo

Ver logs

Execuções recentes

# Tipo Conta Início Duração Resultado Cupons Ofertas Detalhe
As contas ligadas dividem a leitura dos produtos e das listas. A carteira (cupons ativos, checagem) fica com uma só: a principal, ou a próxima ligada. Desligar tira a conta das varreduras sem sair dela; um captcha pausa só a conta que o recebeu. Entrar abre o navegador nesta máquina e a janela fecha sozinha quando a página de cupons carregar.

        

Rotinas automáticas

Varredura completa

Carteira, cupons novos e produtos dos cupons.

a cada h
· descanso min

Contínua: emenda uma varredura na outra, com o descanso entre elas. Pausas e modo calmo continuam valendo.

Revezamento: cada conta tem o seu ciclo. A que descansou volta a ler sem esperar as outras; se nenhuma estiver trabalhando, a que descansou há mais tempo começa na hora. A da carteira fica com a varredura completa.

Checar cupons novos

Lê só a carteira e abre os cupons adicionados por fora.

a cada min
Listas de links

Preço das listas de links, nas contas livres; prioridade baixa só a cada poucas horas.

a cada h
Site de cupons

Cupom novo da comunidade é ativado em cada conta e lido na hora, mesmo no meio de uma varredura. Funciona o dia todo.

consultar a cada s
Horário das às h · atraso aleatório de até min

Varredura completa, checagem e listas só rodam no horário. Os interruptores salvam na hora; números e horário, no botão. Execuções automáticas são puladas por algumas horas depois de um captcha.

Usa os timers do systemd? O agendador roda dentro do servidor (npm run serve). Se também ativou meli-cupons-scrape.timer, meli-cupons-check.timer ou meli-cupons-watch.service, desligue-os para não rodar em dobro.

Cupons da comunidade

Código Situação Quando

Agendador

últimos eventos
—

Cupons da carteira

★ prioriza o cupom nas varreduras. O link é o destino do botão "Conferir"; grave à mão quando o clique não capturar.

Cupom Desconto Mín. Limite Vencimento Produtos Lido Link

Listas de links

Categorias, páginas de ofertas, buscas ou anúncios para acompanhar o preço. Os produtos aparecem na página de preços com o filtro Lista. Listagens são lidas até o limite de páginas das Configurações; links de anúncio leem uma página só. Ficam em data/lists.json.

Só nela: produtos que nenhuma outra lista nem as páginas de cupom trazem. Lista com 0 aí (em cinza) não traz nada novo e pode ser desligada sem perder produto. Casam com a lista de desejos: produtos ligados a um item; entre parênteses, os que se perdem desligando a lista. Contam os produtos da última leitura de cada lista.

Alertas (7 dias): mensagens enviadas ao Telegram com o preço lido nesta lista; o número com ~ é estimado (alertas de antes de a fonte ser gravada, de anúncios que estão nela hoje). Prioridade: alta é lida primeiro em toda leitura de listas; baixa só a cada 6 h (Configurações → Varredura: o que ler), deixando a rodada mais curta para as outras.

Ligada Lista Tipo Prioridade Alertas (7 dias) Produtos Só nela Casam com a lista de desejos Lido
Importar JSON

Cole uma lista no formato [{"nome": "...", "url": "...", "enabled": true, "type": "direct"}]. Links que já existem são ignorados.

Fila de revisão

Marcar:
Como funciona

É este liga o produto ao item (entra nos alertas); Não é descarta para sempre. Os dois ensinam o cruzamento. Depois do Não é, um clique no motivo (variante, medida…) grava o porquê: o juiz da IA usa como exemplo em casos parecidos. Em destaque assim: palavras e números do item que não estão no título do produto (e números do título que não estão no item). O botão com borda tracejada é o que o juiz responderia. Passe o mouse na foto para ampliar. Ver por item junta as sugestões de cada item num cartão, com Nenhum destes para recusar todas de uma vez. As caixinhas marcam várias sugestões para confirmar ou recusar juntas. Em Mais impacto para a IA vêm primeiro os pares que mais ensinam; nada sai da fila, só muda a ordem.

Itens

Adicionar item
Atualizar pela API

Busca a planilha na API (colunas A–D no formato do CSV) e importa com as mesmas regras: inclui e atualiza itens; os que saíram da planilha continuam. Endereço e intervalo em Configurações → Lista de desejos; a chave fica no .env (PRODUCTS_API_KEY).

Importar CSV / planilha

Colunas: Gênero;Produtos;Alvo de maior valor validado;Alvo do analista (com ou sem cabeçalho; gênero Feminino, Masculino ou N/A). Vale o alvo do analista; vazio, entra o validado. Aceita separador ;, tab (copiado do Excel/Sheets) ou ,, preço como 1.299,90 e o formato antigo nome;preço. Mesmo produto e gênero atualiza; até 5 MB (cerca de 50 mil linhas).

Avisa no Telegram quando o melhor preço com cupom de um produto ligado (casado ou ✓) fica no alvo ou abaixo, por unidade.
Ligado Gênero Produto Alvo validado Alvo do analista Melhor agora Ligados

Produtos

Últimos alertas

Quando Item Produto Preço Alvo Motivo Envio

Canal de promoções

Qualquer produto lido (esteja ou não na lista de desejos) no menor preço já visto ou com queda forte sobre o preço usual do histórico (o que vigorou a maior parte do tempo) e o anterior. Sai na hora em que a varredura lê o produto, como os alertas da lista de desejos. Limites em Configurações → Canal de promoções. Para usar outro bot (recomendado: limite de envios próprio), crie um no @BotFather, ponha o token no .env (TELEGRAM_DEALS_BOT_TOKEN=...), reinicie e adicione o bot como administrador do canal. Depois "Descobrir chat id".

Quando Produto Preço Referência Motivo Envio

Alertas pessoais

Palavra-chave com as regras da busca (todas as palavras em qualquer ordem, "termo" no começo de palavra ou frase exata, -termo exclui, sem diferença de acento). Avisa no seu chat pessoal quando um anúncio que bate é lido e: é a primeira vez que o alerta o vê (cada anúncio uma vez, inclusive os que já estavam no banco), está no menor preço já visto ou teve a queda pedida. "Preço até" vale para todas as condições. Use "Prévia" para ver quantos anúncios batem antes de salvar.

Ligado Palavra-chave Avisa Preço até Enviados Último

Últimos envios pessoais

Quando Palavra-chave Produto Preço Motivo Envio

Alertas de preço enviados

Por dia

Por motivo

Por leitura

A varredura que leu o preço e mandou o alerta.

Itens que mais saem

Item Alertas Anúncios Lembretes Menor preço Alvo

Por fonte

Lista ou cupom Prioridade Alertas

O que segura o Match por IA

Produtos ligados

Notas das sugestões

Itens sem nenhum candidato

Nenhum anúncio lido chegou perto o bastante nem para virar sugestão. Pela palavra mais rara do nome (quase sempre a marca ou a linha): se ela aparece em poucos títulos, o produto provavelmente não está entre os anúncios lidos, e o caminho é a varredura (listas de links, cupons), não a IA.

Item Palavra mais rara Em títulos lidos

Cobertura por marca

para as marcas com mais itens sem candidato (que ainda não têm busca)

Cada busca vira uma lista de links (aba Listas de links), lida até o limite de páginas das Configurações. Marca com muitos tipos de produto (ex.: Nivea) rende mais com buscas por marca e tipo ("nivea desodorante"): crie à mão na aba Listas de links.

Marca Itens na lista Com produto ligado Sem candidato Anúncios lidos com a marca Busca
Itens sem marca reconhecida

Nenhuma marca da lista aparece no nome. Muitos são genéricos ("Cesto Bambu 60L"); se achar uma marca aqui, acrescente na lista abaixo.

    Candidatas a marcas equivalentes (white label)

    Pares de marcas em que o casamento parou só na marca: barradas = sugestões com nota alta (≥ 0,85) do item de uma marca com anúncio da outra; mesmo título = anúncios das duas com o título igual fora a marca. A maioria é concorrente (Raid × SBP não é white label): só junte as que você sabe que são o mesmo produto com outra etiqueta. Marca com (?) é uma palavra do anúncio fora da lista de marcas: talvez uma marca nova (ou grafia errada de uma conhecida).

    Marcas Barradas Mesmo título Exemplo

    Lista de marcas

    Uma marca por linha; grafias alternativas depois de vírgula (Oral-B, Oral B); # começa um comentário. Linha que começa com = junta marcas equivalentes (white label), ex.: = Agratto, Kian, Bak: qualquer uma vale pela outra, e o juiz é avisado. Acha a marca de cada item pelo nome: o anúncio precisa trazer uma delas para casar sozinho ou pelo juiz. Evite palavras comuns ("Original", "Fresh"): viram marca de qualquer item que as tenha. Salvar recalcula o cruzamento inteiro na próxima vez.

    Cruzamento com IA

    Telegram

    1) No Telegram, fale com o @BotFather → /newbot e copie o token para o .env (TELEGRAM_BOT_TOKEN=...); reinicie o servidor. 2) Mande /start para o seu bot. 3) "Descobrir chat id" e clique no seu chat. Avisos do sistema (captcha) em outro chat: mande /start nele (ou ponha o bot no grupo), "Descobrir chat id" e use "→ sistema".

    Ensinamentos

    —

    Exportar CSV Exportar JSONL
    Importar ensinamentos

    CSV exportado daqui (cabeçalho item;alvo;titulo;resposta, resposta sim/não) ou JSONL. Item que não existe é criado com o alvo do arquivo; a resposta importada vale por cima da atual.

    Diagnóstico de desempenho

    Ative a coleta em Configurações → Diagnóstico de desempenho. CPU e memória por processo a cada 30 segundos; eventos por etapa e consultas SQLite acima de 25 ms. Limites podem truncar o histórico exportado. Revise os logs antes de compartilhar.

    —

    Cruzamento da lista de desejos

    —

    Revisão do juiz

    —

    Alertas de preço

    Avisos do sistema (Telegram)

    Ficam no config.json. Mudanças valem na hora para o agendador e a partir da próxima varredura para o scraper. ↺ volta ao padrão. Porta, endereço e caminhos ficam só no config.json; senhas e chaves, no .env.