https://github.com/ravenastar-js/ravc
⚙️ CLI/NPM para Conversão de Moedas USD/BRL & Cotação em tempo real.
https://github.com/ravenastar-js/ravc
banco-central cli currency finance google-finance google-finance-scraper nodejs npm npm-package playwright ravenastar scrapping secguide tool tools
Last synced: about 2 months ago
JSON representation
⚙️ CLI/NPM para Conversão de Moedas USD/BRL & Cotação em tempo real.
- Host: GitHub
- URL: https://github.com/ravenastar-js/ravc
- Owner: ravenastar-js
- License: mit
- Created: 2025-10-17T13:35:54.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-10-23T12:43:08.000Z (8 months ago)
- Last Synced: 2025-10-26T02:52:01.968Z (8 months ago)
- Topics: banco-central, cli, currency, finance, google-finance, google-finance-scraper, nodejs, npm, npm-package, playwright, ravenastar, scrapping, secguide, tool, tools
- Language: JavaScript
- Homepage: https://secguide.pages.dev/
- Size: 1.3 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
---
## 🚀 RAVC
### ⚙️ CLI/NPM para Conversão de Moedas USD/BRL & Cotação em tempo real.
[](https://www.npmjs.com/package/ravc)
[](https://nodejs.org)
[](LICENSE)
*Biblioteca NPM + CLI*
---
## 📋 Visão Geral
O **RAVC** é uma ferramenta de linha de comando (CLI) e NPM que oferece conversão de moedas e monitoramento em tempo real das cotações USD/BRL, com interface interativa e visualmente atrativa.
## 📦 Instalação Rápida
📥 Como instalar o NodeJS?
- [COMO INSTALAR NODE JS NO WINDOWS?](https://youtu.be/-jft_9PlffQ)
```bash
# Instalar globalmente
npm i -g ravc # ✅ Recomendado
npm install -g ravc # ✅ Completo
```
## 🗑️ DESINSTALAR GLOBALMENTE
```bash
npm un -g ravc # ✅ Recomendado
npm uninstall -g ravc # ✅ Completo
npm remove -g ravc # ✅ Alternativo
```
## 💻 Como Usar
### 🎮 Modo Interativo (Recomendado)
```bash
ravc
```
*Menu completo com todas as funcionalidades*
### ⚡ Comandos Diretos
```bash
# Google Finance direto
ravc google
ravc -g
# Banco Central direto
ravc bacen
ravc -b
# Modo atualização contínua
ravc update
ravc -u
# Ajuda
ravc help
ravc -h
```
### 🔄 Modo Atualização Contínua
```bash
ravc update
```
*Atualiza automaticamente a cada minuto com logs em tempo real*
## 🎯 Funcionalidades
### 💱 Conversão de Moedas
- USD → BRL e BRL → USD
- Formatação monetária adequada
- Validação de entrada
### 📈 Monitoramento
- Variações em tempo real
- Direção (alta/baixa/estável)
- Percentuais de mudança
- Timestamps precisos
### 📊 Logs e Histórico
- Logs em arquivo .txt legíveis
- Histórico de sessões
- Estatísticas de variação
- Backups em JSON
## 🔧 Desenvolvimento
### 📦 Dependências Principais
- `playwright` - Web scraping
- `inquirer` - Interface interativa
- `boxen` - Boxes estilizados
- `chalk` - Cores no terminal
- `figlet` - Banner ASCII
## 🐛 Solução de Problemas
### 🔍 Debug Mode
```bash
# Ativar logs detalhados
DEBUG=1 ravc
# Debug específico do scraping
DEBUG_SCRAPING=1 ravc
```
### ❌ Problemas Comuns
**Erro de permissão no NPM:**
```bash
# Linux/Mac
sudo npm install -g ravc
# Windows (Admin)
npm install -g ravc
```
**Playwright não instalado:**
```bash
npx playwright install
```
## 🏗️ Estrutura do Projeto
```
ravc/ 🌟
├── 📁 bin/
│ └── 🚀 cli.js
├── 📁 lib/
│ ├── 📁 config/
│ │ ├── ⚙️ app.json
│ │ ├── 🎨 colors.js
│ │ ├── 🔧 logger.json
│ │ ├── 🕷️ scraping.json
│ │ └── 🎭 ui.json
│ ├── 📁 utils/
│ │ ├── 📦 box.js
│ │ ├── 📝 logger.js
│ │ └── 📦 packageInfo.js
│ ├── 💱 converter.js
│ ├── 🏠 index.js
│ ├── 🕷️ scraper.js
│ ├── 🎨 ui.js
│ └── 🔄 updater.js
├── 📄 package.json
└── 📖 README.md
```
## 📄 Licença
Este projeto está sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para detalhes.
---
**✨ Feito com 💚 por [RavenaStar](https://ravenastar.link)**
[⭐ Dê uma estrela no GitHub!](https://github.com/ravenastar-js/ravc)
---
## Star History
