Git Product home page Git Product logo

garimpeiro-olx's Introduction

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
  • 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?

garimpeiro-olx's People

Contributors

mrocha98 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

Forkers

tespechit rdvid

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.