Community연구 & 데이터 분석github.com

US Crowding Radar (미국 주식 군집 리스크 모니터)

로컬 우선, 설명 가능한 미국 주식 군집 리스크 모니터 | Local-first, explainable US equity crowding-risk monitor

US Crowding Radar (미국 주식 군집 리스크 모니터)란 무엇인가요?

US Crowding Radar는 미국 주식 시장의 군집 리스크(Crowding Risk)를 모니터링하는 로컬 우선 도구입니다. 사용자는 자신의 Clawby API 키를 로컬 UI나 환경 변수로 제공하여, 특정 주식의 과도한 자금 집중도를 스코어, 방향, 커버리지 등 다양한 구성 요소로 분석할 수 있습니다. 이 도구는 Python CLI 기반으로 동작하며, `watchlist` 명령어로 관심 종목을 관리하고 `scan` 명령어로 군집 리스크를 평가합니다. 모든 데이터는 읽기 전용으로만 사용되며, 투자 조언이 아닌 시장 인텔리전스로 활용해야 합니다. 또한 알림 기능(`--notify`)을 지원하여 사용자가 설정한 조건에서 알림을 받을 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add lionman888/us-crowding-radar

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

US Crowding Radar

저장소에 포함된 검증된 Python CLI를 사용하십시오. 점수 계산을 직접 재구현하거나 문서화되지 않은 인터페이스를 호출하지 마십시오.

안전

  • 읽기 전용 시장 인텔리전스이며, 매매 실행이 아닙니다.
  • CLAWBY_API_KEY를 명령줄 인수에 포함시키거나, 출력, 로그, 인쇄하지 마십시오.
  • 대시보드는 로컬 UI를 통해 키를 입력받고, Clawby 공식 /api/account 엔드포인트로 검증하며, Git에서 무시되는 로컬 자격 증명 파일(모드 600)에 저장할 수 있습니다.
  • CLI 자동화는 환경 변수나 무시되는 .env 파일에서만 키를 읽습니다.
  • 군집 점수를 가격 예측이나 투자 조언으로 설명하지 마십시오.

명령어

저장소 루트에서 실행:

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

워크플로우

  1. 대시보드의 경우, 사용자에게 로컬 UI에서 자신의 키를 입력하도록 요청하고, 절대 반복하거나 로그에 남기지 마십시오. 성공적인 검증은 보호된 로컬 자격 증명 파일에서 복원할 수 있습니다.
  2. CLI 자동화의 경우, doctor를 실행하고 환경 키가 설정되었는지 여부만 보고하십시오.
  3. 실시간 스캔 전에 워치리스트를 확인하십시오.
  4. 캐시된 승인된 읽기 전용 실행을 위해 scan을, 최신 원격 데이터를 위해 scan --refresh를 사용하십시오.
  5. 점수, 방향, 커버리지, 구성 요소 증거, 소스 타임스탬프, 실패한 차원을 함께 보고하십시오.
  6. 사용자가 알림 대상을 설정하고 승인한 경우에만 --notify를 사용하십시오.

검증

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

관련 스킬