US Crowding Radar (Português)

US Crowding Radar

Use a CLI Python testada neste repositório. Não reimplemente a pontuação nem chame interfaces não documentadas diretamente.

Segurança

• Esta é uma inteligência de mercado somente leitura, não uma execução de negociação.
• Nunca solicite, imprima, registre ou coloque CLAWBY_API_KEY em argumentos de comando.
• O painel aceita a chave através da sua interface local, valida-a contra o endpoint oficial /api/account do Clawby, e pode salvá-la no arquivo de credenciais local ignorado pelo Git com modo 600.
• A automação CLI lê a chave apenas do ambiente ou do arquivo .env ignorado.
• Nunca descreva a pontuação de crowding como uma previsão de preço ou conselho de investimento.

Comandos

A partir da raiz do repositório:

python3 -m us_crowding_radar doctor
python3 -m us_crowding_radar watchlist list
python3 -m us_crowding_radar watchlist add TICKER --label "Company"
python3 -m us_crowding_radar watchlist remove TICKER
python3 -m us_crowding_radar scan
python3 -m us_crowding_radar scan --refresh
python3 -m us_crowding_radar scan --notify
python3 -m us_crowding_radar serve --port 8786

Fluxo de trabalho

1. Para o painel, peça ao usuário para inserir sua própria Chave na interface local; nunca a repita ou registre. Uma validação bem-sucedida pode ser restaurada a partir do arquivo de credenciais local protegido.
2. Para automação CLI, execute doctor e informe apenas se a chave do ambiente está configurada.
3. Confirme a watchlist antes de uma varredura ativa.
4. Use scan para uma execução somente leitura autorizada em cache ou scan --refresh para dados remotos atualizados.
5. Relate pontuação, direção, cobertura, evidências dos componentes, timestamps das fontes e dimensões falhadas juntos.
6. Use --notify apenas quando o usuário tiver configurado e autorizado o destino de notificação.

Validação

python3 -m unittest discover -s tests -v
node --check us_crowding_radar/web/app.js
python3 -m compileall -q us_crowding_radar