Visão geral
…Varrer agora
Carteira, cupons novos e produtos, dentro do limite por varredura.
Contas
GerenciarLog
—
Execuções recentes
| # | Tipo | Conta | Início | Duração | Resultado | Cupons | Ofertas | Detalhe |
|---|
Varredura completa
Emenda uma varredura na outra: mais produtos atualizados, mais tempo com o navegador aberto. Pausas e modo calmo continuam valendo.
Checar cupons novos
Lê só a carteira e abre os cupons que você adicionou por fora.
Listas de links
Atualiza o preço das listas de links. Roda pelo próprio intervalo, nas contas que estiverem livres.
Site de cupons
Cupom novo da comunidade é ativado em cada conta e lido na hora. Durante uma varredura, ela pausa entre uma página e outra para ativar e depois continua.
Varredura completa, checagem e listas de links só rodam no horário; o site de cupons é acompanhado o dia todo. Execuções automáticas são puladas por algumas horas depois de um captcha.
Cupons da comunidade
| Código | Situação | Quando |
|---|
Agendador
—
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.
| Ligada | Lista | Tipo | 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 |
|---|
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.
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.