Visão geral
…Varrer agora
Carteira, cupons novos e produtos, dentro do limite por varredura.
Contas
GerenciarResumo
Ver logsExecuções recentes
| # | Tipo | Conta | Início | Duração | Resultado | Cupons | Ofertas | Detalhe |
|---|
Rotinas automáticas
Carteira, cupons novos e produtos dos cupons.
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.
Lê só a carteira e abre os cupons adicionados por fora.
Preço das listas de links, nas contas livres; prioridade baixa só a cada poucas horas.
Cupom novo da comunidade é ativado em cada conta e lido na hora, mesmo no meio de uma varredura. Funciona o dia todo.
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
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).
| 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
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
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.