Garimpeiro OLX

Procurando por algo na OLX? Seja avisado do melhor preço!

👀 Demonstração

Notificação de oferta via log

Notificação de oferta via desktop (Linux)

Loop enquanto não encontra ofertas

⚠ Requisitos

Instale o NodeJS em uma versão igual ou superior a 14.x. Se estiver utilizando Linux, certifique-se de ter o pacote notify-osd ou libnotify-bin para que as notificações Desktop funcionem (mais detalhes aqui).

📥 Instalação

Clone o repositório/extraia o zip no local de sua preferência.

Em um terminal/prompt de comando, navegue até o repositório execute:

cd caminho-do-repo
npm install
npm run build

🤖 Utilização

Consulte os comandos disponíveis executando:

npm start -- --help

Lista de comandos

Tendo conhecimento das opções, basta combiná-las como se você estivesse fazendo uma busca no site da OLX.

Exemplo:

npm start -- --uf sp --ddd 12 --zona 'vale do paraiba' --cidade 'sao jose dos campos' --produto apartamento --preco 1

Resulta em uma busca na URL:

https://sp.olx.com.br/vale-do-paraiba-e-litoral-norte/vale-do-paraiba/sao-jose-dos-campos?q=apartamento

📄 Licença e CopyLeft

Esse projeto segue a licença AGPL 3.0 ou superior. Em resumo, você é livre para fazer o que quiser com o código fonte, desde que distribua suas modificações sob a mesma licença.

Obs: Eu sou um programador, não um advogado.

🤝 Contribuições

Caso tenha sugestões ou dúvidas abra um issue.

Se gostou do projeto considere contribuir com um pull request e tenha a honra de preencher itens dessa lista:

TODO

• novos meios de notificação
  • SMS
  • Email
  • Whatsapp (venom bot)
• bot no telegram
• cache
  • status das urls
  • preço máximo e mínimo
• testes unitários
• melhorar a documentação
  • mais exemplos
  • prints de notificações desktop em Windows e OSX
• interface gráfica?