YoungCan-Wang/WyckoffTradingAgent

WyckoffAgent – 중국, 홍콩, 미국 주식 시장을 위한 AI 기반 트레이딩 어시스턴트

기능

• 대화형 '위코프 마스터' 역할을 합니다. 자연어 질문을 입력하면 에이전트가 위코프 가격-거래량 방법론에 기반한 시장 분석으로 응답합니다.
• TickFlow에서 실시간 일일 시세를 가져오고, 사용자별 데이터(포트폴리오, 신호 피드백, 백테스트 결과 등)를 Supabase에 저장하며, 다음 도구 체인을 실행합니다:
  1. A주, 홍콩주, 미국주 일일 바에서 위코프 구조를 식별합니다.
  2. 해당 구조를 AI 생성 리서치 보고서, 위험 관리 점검, 퍼널 스크리닝 로직과 결합합니다.
  3. 결과를 웹 UI, CLI 대시보드, Electron 데스크톱 앱 또는 외부 MCP 도구로 전송합니다.

주요 구성 요소

구성 요소	역할
TickFlow	실시간 시장 데이터 제공자(Supabase 캐시 없음).
Supabase	사용자 구성, 포트폴리오, 백테스트 로그, 신호 피드백, 작업 결과를 저장합니다.
LLM 백엔드	Gemini, Claude, OpenAI, DeepSeek V4 – 자연어 대화 및 AI 기반 리서치 보고서에 사용됩니다.
React 웹 앱	대화형 채팅, 퍼널 스크린, 포트폴리오 보기, 뉴스 오버레이 등.
CLI / TUI	wyckoff 명령은 터미널 UI, 대시보드(wyckoff dashboard) 또는 일회성 작업(wyckoff run …)을 시작합니다.
Electron 데스크톱	Windows/macOS용 동일한 UI와 도구를 번들로 제공하며, 대화 상자 내 쓰기 작업을 지원합니다.
MCP(Model-Context-Protocol) 서버	GitHub, 파일 시스템 또는 사용자 정의 데이터 소스에서 추가할 수 있는 19개의 공개 도구를 노출합니다. 모든 작업은 승인 대기열을 거칩니다.
Cloudflare Workers + Vercel 샌드박스	무거운 리서치 계산을 안전하고 수명이 짧은 환경에서 실행합니다.

주요 워크플로우

1. 데이터 수집 – TickFlow의 /v1/quotes는 전체 시장 스냅샷을 반환합니다. 에이전트는 로컬에서 필터링합니다.
2. 위코프 퍼널 – A주 시장(약 5,000개 종목)을 스캔하여 개념 수준의 '메인라인' 구조, 8채널 강도, 후보 레인, 매수 시점 확인을 식별합니다.
3. AI 리서치 – LLM이 3계층 보고서(로직 분석, 예비 캠프, 런치 패드)를 생성하고 평가합니다.
4. 신호 피드백 루프 – 시장 마감 후 관찰 결과를 피드백하여 퍼널을 개선하고 섀도우 전략 검증을 허용합니다.
5. 실행 가드 – '일일 퍼널 × 다음 날 시가' 규칙은 시가가 모델 생성 구간 내에 있을 때만 거래를 허용합니다. 그렇지 않으면 신호를 경고로 기록합니다.
6. 사용자 상호작용 – 채팅을 통해 포트폴리오 진단, 백테스트 그리드 요청 또는 사용자 정의 /screen, /checkup, /report, /backtest 스킬 실행이 가능합니다. 모든 쓰기 작업은 수동 승인을 위해 대기열에 들어갑니다.

설치 및 사용법

# 원클릭 설치
curl -fsSL https://raw.githubusercontent.com/YoungCan-Wang/WyckoffTradingAgent/main/install.sh | bash
# 또는 Homebrew / pip를 통해
brew tap YoungCan-Wang/wyckoff && brew install wyckoff
uv pip install youngcan-wyckoff-analysis

wyckoff                # 대화형 에이전트 시작
wyckoff dashboard      # 로컬 시각 패널 실행

첫 실행 시 LLM 모델을 선택하고 API 키를 제공하면 에이전트가 준비됩니다.

비용 및 라이선스

• 코드는 AGPL-3.0이며 완전히 오픈 소스입니다. 자체 호스팅이 가능합니다.
• 호스팅 서비스 실행에는 클라우드 비용이 발생합니다(데이터 제공자, Supabase, LLM 사용, Cloudflare Workers). 자세한 비용 모델은 docs/COST_MODEL.md에 문서화되어 있습니다.
• 선택적 '지식 플래닛' 멤버십(연간 518위안)은 공유 인프라를 보조합니다. 투자 조언을 구성하지 않습니다.

대상 사용자

• 위코프 방법을 따르며 AI 지원 패턴 감지와 리서치를 원하는 트레이더.
• LLM 채팅, 실시간 시장 데이터, 데이터베이스 백엔드, 다중 플랫폼 프론트엔드를 결합한 풀스택 예제에 관심이 있는 개발자.
• 규제되고 승인 기반의 거래 자동화 파이프라인의 참조 구현을 찾는 모든 사람.

자세한 정보

• 아키텍처: docs/ARCHITECTURE.md
• 퍼널 흐름: docs/A_SHARE_FUNNEL_FLOW.md
• 신호 피드백 루프: docs/SIGNAL_FEEDBACK_LOOP.md
• 공개 데모 비디오와 스크린샷은 README에 포함되어 있습니다.