chjm-ai/stock-monitor

O que stock-monitor faz?

Sistema inteligente de monitoramento e alerta de ações com suporte completo a 7 regras de alerta: porcentagem de custo, cruzamento de médias móveis (ouro/morte), RSI sobrecomprado/sobrevendido, anomalias de volume, gaps de abertura e trailing stop dinâmico. Adaptado aos hábitos de investidores chineses (alta em vermelho, queda em verde).

Visão Geral

O chjm-ai/stock-monitor permite que você monitore múltiplas ações em tempo real com regras de alerta personalizáveis. Ele é ideal para traders que desejam automatizar a detecção de oportunidades e riscos sem precisar ficar olhando para a tela o tempo todo.

Regras de Alerta Suportadas

Regra	Descrição
Porcentagem de custo	Alerta quando o preço atinge um percentual fixo acima ou abaixo do seu custo médio
Cruzamento de médias móveis (ouro/morte)	Detecta quando uma média móvel rápida cruza acima (ouro) ou abaixo (morte) de uma média lenta
RSI sobrecomprado/sobrevendido	Alerta quando o RSI ultrapassa níveis de 70 (sobrecomprado) ou 30 (sobrevendido)
Anomalias de volume	Identifica picos de volume significativos em relação à média histórica
Gaps de abertura	Detecta gaps de preço entre o fechamento anterior e a abertura atual
Trailing stop dinâmico	Ajusta automaticamente o stop-loss conforme o preço sobe, maximizando ganhos

Como Funciona

1. Configuração: Edite o arquivo config.yaml com suas ações e regras.
2. Execução: Execute o monitor usando o comando:

python monitor.py --config config.yaml

3. Alertas: O sistema pode notificar via console, e-mail ou webhook.

Integração com Agentes de IA

Este skill pode ser usado com agentes como Claude Code, Cursor ou Codex. Basta solicitar ao agente:

"Monitore a ação AAPL com regra de RSI sobrecomprado e me alerte quando o RSI ultrapassar 70."

O agente irá configurar as regras e iniciar o monitoramento automaticamente.

Pré-requisitos

• Python 3.8+
• Bibliotecas: pandas, numpy, requests, yfinance
• Conta na Alpha Vantage (opcional, para dados em tempo real)

Instalação

pip install chjm-ai-stock-monitor

Exemplo de Configuração (config.yaml)

actions:
  - ticker: "AAPL"
    rules:
      - tipo: "rsi"
        parametros:
          periodo: 14
          sobrecomprado: 70
          sobrevendido: 30
  - ticker: "PETR4.SA"
    rules:
      - tipo: "media_movel"
        parametros:
          rapida: 5
          lenta: 20

Personalização

Você pode adicionar novas regras editando o arquivo rules.py. Contribuições são bem-vindas!

Licença

MIT