Documentação

O que você escolheu ganha um quadro verde, com uma etiqueta “🎯 Local escolhido” acima e uma marca × que o descarta. Só essas duas coisas ficam sobre o quadro (qualquer coisa a mais cobriria justamente o que você está olhando). Escolha dois ou mais locais a tirar e cada etiqueta ganha um número ① ②, com o mesmo número na linha abaixo.

• Para ir mais para dentro, clique diretamente nesse elemento. Não há botão para isso.
• Para ampliar para fora, aperte “↔ Ampliar a área” no painel. Clicar não leva você de volta a um elemento pai.
• Se ampliou demais, “↩ Desfazer um passo” ao lado volta à escolha anterior.
• Para recomeçar, aperte “Remover o local que está sendo escolhido”. Só o atual sai. Para limpar tudo, use “Remover todos os locais”.
• Para partes sobre as quais você não quer ser avisado, como anúncios ou horários, mude primeiro a linha no topo do painel para “Locais a remover” e depois escolha-as.
• Para juntar duas ou mais áreas separadas em um só monitoramento, use “＋ Adicionar um local” no pé do painel.
• Se uma lista está dividida em páginas, “Paginador” na mesma linha permite apontar o link da paginação.

As cores dos quadros significam coisas diferentes. Diferencie-as pelo nome acima do quadro.

• 🎯 Local escolhido (verde) — o que você escolheu
• 🚫 Local a tirar (vermelho) — mudanças aqui são ignoradas
• 📦 Local adicionado (roxo) — uma segunda escolha ou mais
• Paginador (laranja) — o link usado para a paginação

Se aparecer uma etiqueta com contagem, como ⚠ 3 correspondências, outros elementos têm a mesma forma. Salvar assim significa que uma simples mudança na estrutura da página o faz olhar para outro lugar. Tentar “Ampliar a área” para pegar os arredores costuma resolver.

“Remover todos os locais” no pé do painel limpa as escolhas, as exclusões e o link da paginação de uma vez. Para remover só o atual, use “Remover o local que está sendo escolhido” ao lado.

Quando há demais, siga esta lista.

1. Coloque espaços de anúncios, e lugares como “há 3 minutos”, em “Locais a remover”. Horários relativos já são ignorados automaticamente por padrão.
2. Mude o modo para “Mudanças no texto”.
3. Em “❸ Ajustes finos” → “O que é comparado”, use “Mudanças a ignorar” para definir quantos caracteres precisam mudar antes de você ser avisado.
4. Em “❹ Configurar as notificações”, use “Quando não notificar” para ficar em silêncio quando certas palavras aparecem.

Quando chegam poucas, ou nenhuma, olhe primeiro o estado no cartão. Se disser “Sem alterações”, nada mudou de fato. Em qualquer outro caso, leia os itens abaixo.

Uma página que exige login não pode ser obtida por uma verificação comum. A sessão que você tem no navegador não é levada para a obtenção em segundo plano que uma verificação usa.

Ative “Esperar a página carregar mais” em “❸ Ajustes finos” → “Como é obtido” desse monitoramento, e a página é aberta com a mesma sessão do seu navegador normal. Se você estiver conectado nesse site, ela é obtida nesse estado.

Sites que respondem com uma verificação de robôs ou uma tela de confirmação (“você é um robô?” e afins) são recusados no momento em que você tenta adicioná-los. Escolher outra área não resolve.

Se estiver em dúvida, deixe em “Mudanças no conteúdo (incluindo imagens e destinos de links)”. Comece por ali e mude quando as notificações parecerem demais.

• Avisar quando o conteúdo muda — o texto, e também imagens e destinos de links (o padrão).
• Avisar quando o texto muda — só o texto. É o que menos tropeça em anúncios rotativos, então dá menos alarmes falsos.
• Acompanhar um preço ou um estoque — permite definir uma condição como “quando cair abaixo de 1.000”. Ao apertar “Conferir o conteúdo”, o separador decimal é definido pelo jeito como a página escreve os números (como R$ 1.299,99), e “Como ler o número” mostra o valor lido. Você pode escolher de novo se estiver errado.
• Avisar quando a contagem sobe ou desce — fica em silêncio se o conteúdo mudou mas a contagem não.
• Avisar quando links aparecem ou somem — fica em silêncio se só o texto do link mudou.
• Ler os dados internos da página — resiste a mudanças nos nomes de classe, mas você precisa dizer qual parte dos dados ler.

Um item da lista não precisa ser uma tabela. Linhas de tabela, listas com marcadores, caixas separadas — se uma linha é um item, você escolhe do mesmo jeito.

O que não funciona é uma tabela em que uma linha não é um item. Uma previsão do tempo da semana, por exemplo, coloca os dias nas colunas, então o conteúdo de um dia fica dividido em várias linhas. Com essa forma, o que quer que você escolha dá um só tipo de valor.

Você é avisado no momento em que escolhe. Se você clicar em dois “itens da lista” na página e a disposição não parecer de uma linha por item, um quadro amarelo avisa. Ele não impede você — às vezes é exatamente o que você quer.

Coloque o link de “próxima” em “Onde está o paginador” em “❸ Ajustes finos” → “Como é obtido”, e as páginas são juntadas e tratadas como um só monitoramento. O jeito mais seguro é a aba “Paginador” na tela de escolha.

Por padrão ele junta 3 páginas, até 5 páginas. Quanto mais páginas, mais demora cada obtenção.

Um botão de “mostrar mais” que precisa ser apertado também funciona. Nesse caso, o botão é apertado a cada obtenção. Botões dentro de um formulário não podem ser escolhidos, porque isso arrisca enviar ou comprar várias vezes.

⚠️ Se uma das páginas não puder ser obtida, o monitoramento inteiro é tratado como falha. Comparar com uma lista que voltou incompleta informaria “menos itens” sem que nada tivesse sumido de verdade.

Os navegadores param de desenhar páginas que não estão na tela. Então uma verificação comum pode descobrir que rolar não traz nada novo.

Quando um cartão disser “Pode não ter sido lida por inteiro”, ative “Esperar a página carregar mais” em “❸ Ajustes finos” → “Como é obtido” desse monitoramento. Uma janela pequena abre por um instante a cada obtenção; ela abre atrás das suas outras janelas e se fecha sozinha.

Comparar duas obtenções que foram ambas interrompidas informaria “mudou” para sempre sem que nada acontecesse. Para evitar isso, só o trecho que com certeza está presente nas duas obtenções é comparado e, se essa parte for igual, você vê “Sem alterações no que conseguimos ler”.

O padrão geral é definido em Configurações. O mais curto é 1 minuto. O intervalo de uma página é mudado no cabeçalho da tela desse monitoramento.

Mais curto significa ser avisado antes, mas também pesa mais no site e no seu navegador. Não faz sentido verificar a cada cinco minutos uma página que muda uma vez por mês. Encurtar só as páginas que mudam rápido é o que menos desperdiça.

Nas verificações automáticas, o horário da obtenção é deslocado alguns segundos a cada vez, então cada intervalo varia um pouco (→ As regras que seguimos com os sites).

Por que não pode ser menor que 1 minuto. Três motivos.

1. O navegador não nos acorda com mais frequência que isso. O mecanismo que uma extensão usa para rodar em intervalos fixos tem um mínimo definido pelo navegador. Mesmo que um valor menor pudesse ser escolhido, na prática ele seria espaçado até esse mínimo.
2. Não pode ser menor que uma rodada completa. Estima-se quantos segundos leva para visitar todos os monitoramentos que você adicionou, e intervalos abaixo disso não são oferecidos. Se fossem, o próximo horário chegaria antes de a rodada anterior terminar, e ele seria simplesmente pulado em silêncio. A estimativa é em segundos e o intervalo é em minutos, então ela é arredondada para cima (40 segundos significam um mínimo de um minuto).
3. Por consideração aos sites. Mesmo uma vez por minuto são 1.440 visitas por dia. Encurtar só as páginas que mudam rápido é o que menos desperdiça.

O mínimo sobe sozinho com o número e o tipo de monitoramentos que você adicionou. A tela de Configurações mostra qual é o mínimo atual e em que esse número se baseia.

⚠️ As verificações param enquanto o computador está em suspensão. Para que continuem, desative a suspensão do sistema e deixe que só a tela se apague.

Acima de “Páginas monitoradas” há abas que filtram por estado (Todos / Não lidos / Sem alterações / Requer atenção / Parados, mais 🗑 Lixeira quando há monitoramentos excluídos), e na ponta direita três botões: buscar, ordenar e selecionar. As contagens aparecem nas abas, então você vê quantos estão falhando sem abrir nada.

O botão de busca abre uma caixa de busca abaixo das abas; fechá-la limpa a busca. O botão de ordenar abre um menu: escolha entre “Por data de adição”, “Pela última obtenção”, “Pelo intervalo entre verificações” e “Por nome”, e alterne ↑↓ abaixo deles. Quando a ordem é diferente do padrão (data de adição, decrescente), aparece um ponto no botão. Sua escolha é lembrada para a próxima vez. Linhas com o mesmo valor ficam em ordem de nome.

Para agir sobre vários de uma vez, aperte “Selecionar”. As linhas ganham caixas de seleção, e você pode marcar como lidos, pausar, retomar ou excluir em lote. Aperte “Concluir” quando terminar. Monitoramentos ocultos pela busca ou por uma aba saem da seleção, então as ações em lote só afetam o que você vê.

⚠️ “Marcar como lidos” pergunta antes. Ficar como lido não é irreversível em si, mas depois não dá mais para saber quais tinham atualizações.

Quando você exclui um monitoramento, uma aba “🗑 Lixeira” aparece no fim das abas de “Páginas monitoradas”. Aperte “Restaurar” para trazê-lo de volta com as configurações e o histórico de atualizações.

Escolha por quanto tempo guardá-los em “Dias na lixeira” em “Configurações” (30 dias por padrão). Depois disso, são excluídos definitivamente. Para excluí-los antes, aperte “Excluir definitivamente” ou “Esvaziar a lixeira”.

Com a escolha na página (“👀 Escolher na página”) você nunca precisa escrever um, mas às vezes digitar é mais rápido, ou você quer ser mais preciso.

Quase todo seletor CSS que o seu navegador entende pode ser escrito como está. Um id como #news-list, uma classe como .item-card .price, um atributo como li[data-kind="item"], e também :has() e :not() — o bastante para dizer “só as linhas que contêm um link de produto”.

Algumas formas não funcionam. Qualquer coisa que dependa do estado do mouse, como :hover, e o texto acrescentado por ::before, não podem ser lidos. O que é olhado é a página como ela carregou.

Apontar para a coisa errada nunca volta como “Sem alterações”. Quando nada é encontrado, o cartão diz “Requer atenção”.

Evite nomes de classe em que não dá para ler um significado. Classes com caracteres aleatórios, como .css-7f3a1b ou .Row-sc-8kf2d1, mudam no momento em que o site é publicado de novo. Um id, ou um atributo que começa com data-, dura muito mais.

Mais uma coisa: o que lê a página depende de como ela foi obtida. Quando esperamos a página carregar, vemos o que o próprio navegador montou; caso contrário, nós mesmos relemos o HTML obtido. Em seletores complicados, a contagem que a escolha na página mostrou e a contagem durante uma verificação podem às vezes não bater. Use “Conferir o conteúdo” para confirmar que ele lê antes de cadastrar.

Coloque uma palavra como Carregando em “Texto que adia a comparação” em “❸ Ajustes finos” → “O que é comparado” e, quando uma obtenção pegar a página antes de ela produzir o conteúdo de verdade, a comparação é pulada por inteiro.

⚠️ Se você indicar um texto que está sempre na página, o monitoramento fica suspenso. Enquanto estiver retido, o cartão avisa, e se continuar, você é notificado.

Quando você monitora uma lista, o que há na página é reduzido em três etapas: ler → registrar → mostrar. O que é descartado em uma etapa não chega à seguinte. As duas primeiras são definidas em “🗂 O que um monitoramento lê e registra” nas Configurações.

• ① Linhas lidas de uma página — quantas linhas são lidas por obtenção. Se a página lista 500 e isto é 300, só 300 são olhadas.
• ② Itens registrados por atualização — dos que foram lidos, quantos dos adicionados ou alterados ficam no registro.

Enquanto ① estiver sendo atingido, “sumiu” não é informado. Não há como saber se um item realmente saiu da página ou só foi empurrado para além do limite. Para uma lista em que você quer acompanhar remoções, defina ① acima da contagem real.

Enquanto ① estiver atingido, o que informamos como novo também pode conter repetições. Um item que entra no limite quando a ordem muda parece recém-chegado mesmo sem nada nele ter mudado.

Escolha em “🎨 Aparência” → “Idioma da interface” nas Configurações. Há dez opções: seguir o navegador, ou um dos nove idiomas. Escolher um recarrega a tela.

Não tem nada a ver com o idioma das páginas que você monitora. Você pode monitorar uma página em inglês com a interface em português, e vice-versa.

As mensagens de webhook também são montadas no idioma da interface daquele momento. Mudar o idioma depois não reescreve mensagens já enviadas, nem registros passados. Eles ficam nas palavras em que foram registrados.

Cadastre uma URL de webhook em “Notificações”. Cinco serviços são compatíveis.

• Discord — Abra as configurações do canal em que você quer os avisos → “Integrações” → “Criar webhook” → “Copiar URL do webhook”. Ajuda oficial (Discord)
• Slack — Adicione o app “Incoming Webhooks” ao seu espaço de trabalho → escolha o canal em que publicar → copie a URL de webhook que ele fornece. Ajuda oficial (Slack)
• Microsoft Teams — No canal em que você quer os avisos, “…” → “Fluxos de trabalho” → escolha “Enviar alertas de webhook para um canal”, selecione a equipe e o canal e salve → copie a URL de webhook mostrada. Você pode criá-lo em um canal do Teams para trabalho (como o Microsoft 365). A versão gratuita do Teams pode não ter essa opção. Documentação oficial (Microsoft Teams)
• Google Chat — Clique no nome do espaço → “Apps e integrações” → “Adicionar webhooks” → dê um nome e salve → “Mais” → “Copiar link”. É preciso uma conta do Google Workspace (Business ou Enterprise); contas pessoais do Gmail não conseguem criar. O administrador da sua organização também precisa permitir webhooks. Documentação oficial (Google Chat)
• ntfy — Cadastre um nome de tópico à sua escolha no app ntfy do celular (iOS / Android) e informe https://ntfy.sh/seu-topico. Prático para chegar ao celular. Site oficial (ntfy.sh)

Você pode cadastrar vários destinos e dar nomes a eles. Separar Trabalho e Compras significa que cada monitoramento pode escolher para onde vai.

A escolha fica em “❹ Configurar as notificações” → “Destino” desse monitoramento. Deixe sem definir e ele vai para o primeiro destino da lista.

Três opções em “❹ Configurar as notificações” → “Como as notificações são divididas”.

• Um aviso com tudo (padrão) — as atualizações chegam juntas. Nos webhooks, os itens alterados são enviados de 10 em 10 por mensagem, e todos chegam.
• Um aviso por item da lista — as notificações do navegador avisam sobre cada item da lista separadamente (dependendo das configurações do sistema e do navegador, elas podem ser agrupadas quando forem muitas). O ntfy também recebe uma mensagem por item, mas elas podem ser combinadas quando forem muitas. Os outros webhooks recebem todos os itens, de 10 em 10 por mensagem.
• Só que houve uma atualização — diz que houve uma atualização, sem dizer qual item (o histórico de atualizações ainda registra).

“Um aviso por item da lista” combina com você se você quer decidir só pela notificação.

⚠️ Os webhooks recebem os itens alterados de 10 em 10 por mensagem, e todos chegam. Para evitar uma enxurrada de mensagens de uma vez, ajuste o local a monitorar ou as linhas lidas de uma página.

⚠️ O ntfy.sh gratuito permite 250 mensagens por dia. O que passar disso espera o limite ser renovado.

Em “Notificações”, escolha os dias e horários em “🌙 Horário de silêncio”. Se o horário de fim for anterior ao de início, o silêncio vai até a manhã seguinte (por exemplo, 23:00–07:00).

• As verificações continuam. As atualizações aparecem em “Páginas monitoradas” como sempre.
• Avisos como “Não foi possível obter” também são retidos. Eles entram no resumo com ⚠️.
• O resumo lista até 20 itens e dá só a contagem do resto. Você pode ler os detalhes no histórico de atualizações de cada monitoramento.
• Menções e mensagens de abertura de cada monitoramento não são acrescentadas ao resumo.
• Se o horário de silêncio terminou com o navegador fechado, o resumo chega na próxima vez que você o abrir.

Quando o envio para um webhook falha, estes painéis aparecem no topo de “Páginas monitoradas”.

• ⚠️ As notificações não vão chegar até esses destinos serem corrigidos — a URL foi excluída (HTTP 404), não é uma URL de destino compatível, o acesso não foi permitido, o destino escolhido não existe mais, e assim por diante. Cada destino mostra o motivo e um botão “Corrigir o destino”, “Permitir” ou “Escolher um destino de novo”. Depois que você corrigir, ele some na próxima vez que uma mensagem passar.
• ⏳ “… itens ainda não foram enviados” — quando o destino não processou uma mensagem corretamente, ou o limite diário de envios do ntfy foi atingido. O envio é tentado de novo em intervalos e continua quando passar. “Excluir o que está aguardando” remove o que está aguardando.
• ⚠️ Algumas notificações não puderam ser enviadas — por exemplo, quando nada passou em até 24 horas depois de encontrar a atualização. Cada destino mostra a contagem e quando foram as atualizações. “Dispensar” fecha o painel.

A atualização em si não se perde. O que foi detectado está no histórico, então você pode abrir esse monitoramento e ver.

1. Obter o HTML da página como ele é (o mais leve, e o padrão)
2. Ler os dados estruturados que a página carrega internamente (resistente a mudanças nos nomes de classe)
3. Só quando nenhum dos dois funciona, renderizar de fato a página em uma aba oculta

Qual usar é decidido quando você adiciona o monitoramento, e não é decidido de novo a cada verificação. O ícone no cartão mostra qual está em uso.

Uma página desenhada por JavaScript fica vazia se você só pegar o HTML dela. Então a página é aberta de verdade em uma aba oculta e fechada assim que termina de ser desenhada.

Isso não enche o seu histórico de navegação. A entrada do histórico de uma página aberta por uma verificação é removida quando a aba fecha.

Porém, remove mais do que as nossas. A função de remoção que o navegador oferece apaga todas as visitas a essa página. Não há como remover uma única visita. Então as suas próprias visitas a essa página também vão embora. Quanto mais provável for você mesmo visitar uma página, mais isso pode importar.

Se isso incomodar, desative “Esperar a página carregar mais” em “❸ Ajustes finos” → “Como é obtido” desse monitoramento. A página então nunca é aberta para renderizar, e o histórico nunca é tocado.

Se “Esperar a página carregar mais” estiver ativado para esse monitoramento, o que abre por um instante é uma janela pequena em vez de uma aba oculta. Ela abre atrás das suas outras janelas, então não atrapalha, mas aparece.

Nada é feito nas configurações de segurança dos sites que você monitora. Você pode continuar usando-os exatamente como antes.

• As requisições ao mesmo site são feitas uma de cada vez, em ordem. Ele nunca bate num site tudo de uma vez.
• Quando visitamos o mesmo site mais de uma vez seguida, deixamos um pequeno espaço entre as visitas. Se o site declara uma espera no robots.txt dele, seguimos essa espera (até 15 segundos).
• O intervalo mais curto entre verificações é de um minuto, e não pode ser menor.
• O robots.txt é lido, e os lugares recusados não são obtidos. Só os monitoramentos que realmente precisam podem visitar mesmo assim, um a um (“Monitorar uma página” → “❸ Ajustes finos” → “Como é obtido” → “Visitar a página mesmo que o robots.txt recuse”; para um monitoramento existente, comece por “⋯” → “✏️ Configurações e edição”). Você anota um motivo ao criar a exceção. Visitá-la mesmo assim é decisão e responsabilidade sua.
• Depois de uma obtenção que falhou, ele espera mais antes de tentar de novo. Ele não fica martelando uma página que continua falhando.
• Nas verificações automáticas, o início de cada visita a um site é deslocado alguns segundos a cada vez. Obter sempre no mesmo segundo parece mecânico. Por isso, cada intervalo fica um pouco mais curto ou mais longo que o definido (na média, bate com o definido). Nada é deslocado quando você aperta “Verificar agora”.

⚠️ Estas são cortesias com os sites, não uma garantia de que o acesso não será considerado mecânico. Como ele é avaliado e tratado depende de cada site.

⚠️ Conferir os termos dos sites que você monitora é responsabilidade sua.

Não há limite de quantidade, nem de quanto é guardado. A extensão pede permissão ao navegador para tirar o limite de armazenamento, então ela nunca é parada pela capacidade.

Se algo merece atenção, é a velocidade. Cada verificação começa lendo todas as configurações dos monitoramentos, e a lista na tela também. Cada uma é pequena, porém: mesmo várias centenas de monitoramentos não deixam nenhuma das duas visivelmente mais lenta (nós mesmos conferimos isso).

O conteúdo obtido e o histórico de atualizações ficam separados das configurações dos monitoramentos, então, por mais que cresçam, a lista e as verificações não ficam mais pesadas. Eles só ocupam espaço no dispositivo; quanto está em uso agora aparece em “🗂 O que um monitoramento lê e registra” nas “Configurações”. Quanto histórico é guardado é definido por ① e ② no mesmo cartão e por “Atualizações guardadas no histórico” em cada monitoramento.

Guardar o texto completo de cada obtenção ficaria pesado, então só a geração anterior é guardada para comparar. Se o próprio salvamento falhar, o cartão avisa.