Equity Research Agent의 기능
Equity Research Agent는 날짜가 기록된 공개 재무 데이터를 편집 가능한 Word 출력물과 이에 대응하는 PDF가 포함된 영문 주식 리서치 보고서로 변환합니다. 미국 주식, 상하이 A주, 홍콩 주식을 지원하며, 수치로 제시된 핵심 요점을 유지하고 수익성, 현금 전환, 가치평가 요인을 설명합니다.
이 프로젝트는 데이터 수집, 재무 계산, 가정 검토, 문서 서식을 분리합니다. 결정론적 재무 엔진은 가치평가 결과를 로컬에서 계산하며, DeepSeek는 투자 논리를 검토하고 가능한 DCF 가정을 제안하는 데 활용할 수 있습니다.
주요 기능
- 3개 시장 지원: 미국 티커, 6자리 상하이 종목 코드 또는 홍콩 종목 코드를 선택합니다.
- 명시적 가치평가 입력값: 성장률, 마진, 세율, 재투자, WACC, 영구 성장률, ROIC 및 주주가치 조정 가정을 설정합니다.
- 3개 시나리오 DCF: 시나리오별 성장률, 마진, 자본적 지출 및 운전자본 변동을 반영한 강세, 기본, 약세 사례를 검토합니다.
- 편집 가능한 결과물: Word 보고서를 내보내며, 지원되는 Windows 설치 환경에서는 이에 대응하는 PDF도 생성합니다.
- 근거 및 출처 추적: 원본 스냅샷, 날짜, 통화, 해시 및 검증 요약을 보존합니다.
- 오프라인 재현: LLM 요청 없이 포함된 재무 스냅샷을 다시 계산합니다.
워크스페이스 설치 및 시작
Python 3.10 이상이 필요합니다. 압축을 푼 저장소 디렉터리에서 가상 환경을 만들고, 테스트 의존성과 함께 프로젝트를 설치한 다음 로컬 워크스페이스를 시작합니다.
python -m venv .venv
.venv/Scripts/python.exe -m pip install -e ".[test]"
.venv/Scripts/python.exe -m equity_research_agent.cli serve --port 8766
브라우저에서 http://127.0.0.1:8766을 엽니다. Windows에서는 설치 후 Start Workspace.cmd를 실행할 수도 있습니다.
공개 데이터를 실시간으로 수집하려면 인터넷 연결이 필요하지만 별도의 데이터 API 키는 필요하지 않습니다. DeepSeek는 선택 사항입니다. 사용하려면 .env.example을 .env로 복사하고 로컬에서 키를 추가합니다. 인증 정보는 로컬 환경에 유지됩니다.
기본 기업 보고서 작성
워크스페이스에서 시장과 정확한 종목을 선택합니다. 보고서를 생성하기 전에 불러온 기업 식별 정보, 보고 통화, 호가 통화, 데이터 범위 및 사용 가능한 가치평가 필드를 확인합니다.
재현 가능한 오프라인 예제로 제공된 NVIDIA 고정 스냅샷을 사용합니다.
.venv/Scripts/python.exe -m equity_research_agent.cli company --market US --symbol NVDA --snapshot examples/nvda/company_snapshot.json --skip-pdf이 명령은 저장된 기업 스냅샷을 사용하고 모델 요청을 건너뛰며 PDF 변환을 시도하지 않고 Word 보고서를 생성합니다. 적절한 시장, 종목 코드, 스냅샷 또는 실시간 공개 데이터 입력값을 사용하면 지원되는 다른 증권에도 동일한 워크플로를 적용할 수 있습니다.
DCF 가정 구성
가치평가를 좌우하는 가정을 워크스페이스에서 직접 설정합니다. 사용 가능한 입력값에는 매출 성장률, 영업 마진, 세율, 재투자, WACC, 영구 성장률, ROIC 및 기업가치에서 주주가치로의 조정이 포함됩니다. 시나리오 제어 기능을 사용하면 강세 및 약세 시나리오의 성장률, 마진, 자본적 지출 및 운전자본 변동을 조정할 수 있습니다.
재무 엔진은 검토된 입력값을 사용해 세 가지 현금흐름 시나리오를 계산합니다. 보고서는 가치평가 로직을 하나의 목표 수치 뒤에 숨기지 않고 가정, 연도별 FCFF 계산, 할인된 현금흐름, 말기 재투자 및 기업가치에서 주주가치로의 조정 내역을 공개합니다.
DeepSeek로 가정 논의
단순히 가정을 입력하는 대신 투자 논리를 검증하려면 논의 인터페이스를 사용합니다. 질문이나 투자 논리를 입력하고 필요에 따라 공개 출처 링크를 제공합니다. DeepSeek는 검색된 근거를 검토하고, 관점을 반박하며, 범위, 이유, 참고 자료 및 반론이 포함된 가정을 제안합니다.
- 투자 논리 또는 가치평가 질문을 입력합니다.
- 가능한 경우 관련 공개 출처 링크를 추가합니다.
- 제안된 범위, 근거 및 반론을 검토합니다.
- 적용할 제안만 선택합니다.
- 로컬 재무 엔진에서 변경된 가치평가 결과를 확인합니다.
- 보고서를 생성하기 전에 필요한 필드를 수동으로 수정합니다.
모델은 제안하고 작성하며, 숫자는 로컬 엔진이 계산합니다. DeepSeek는 고급 추론 모드와 누적 CNY 100 예산 한도를 기본으로 사용합니다. 인터페이스는 제안을 모델에 자동으로 강제 적용하지 않으며, 적용은 사용자가 명시적으로 수행해야 합니다.
생성된 보고서 검토
완성된 보고서에는 재무 분석, DCF 시각화, 계산표, 민감도 정보, 출처의 한계 및 공개된 시나리오 가정이 포함됩니다. 가치평가 페이지는 세 가지 현금흐름 시나리오를 날짜가 기록된 주가 종가, 주주가치 조정 내역 및 말기 가정과 함께 보여줍니다.
보고 통화와 평가 통화가 명확한지, 주가 종가에 기준일이 표시되어 있는지, 가정이 검토하려는 시나리오와 일치하는지 확인하세요. 지원되는 Windows 환경에서는 PDF 내보내기를 위해 Microsoft Word와 PATH에 등록된 Poppler의 pdftoppm이 필요하며, 또는 EQUITY_PDFTOPPM 환경 변수를 사용할 수 있습니다. 다른 시스템에서는 --skip-pdf를 사용해 Word 문서를 생성할 수 있습니다.
설치 확인
설치 후 저장소의 공개 테스트 모음을 실행하세요:
.venv/Scripts/python.exe -m pytest tests -q저장소에는 재무 엔진, 기업 보고서, 레이아웃, 가정 논의, 로컬 HTTP 라우트 및 예산 제어를 다루는 35개의 공개 테스트가 문서화되어 있습니다. 릴리스 검증에서는 재무 재계산, DuPont 항등식, 통화 변환, 차트 값, 문서 일관성 및 데이터 출처도 확인합니다.
검증은 계산과 문서의 일관성을 확립하지만, 발행사 공시 대조나 기업별 투자 조사를 대신하지는 않습니다.
고급 사용법 및 중요 제한 사항
재현성을 위해 고정 스냅샷 사용
포함된 예제는 저장된 재무 스냅샷과 시나리오를 오프라인에서 재실행할 수 있도록 지원합니다. 이를 활용하면 새 모델 요청 없이 테스트하고, 보고서 레이아웃을 검토하며, 제공된 예제를 재현할 수 있습니다.
가정을 수용하기 전에 근거 검토
DeepSeek의 제안은 범위, 이유, 참고 자료 및 반론과 함께 검토해야 합니다. 일반적인 가정은 기업별 검토가 필요하며, 보조 데이터 필드는 발행사 공시와 대조해야 할 수 있습니다.
섹터 범위 이해
은행, 보험사, REIT 및 기타 금융 섹터 종목을 선택한 경우 기업 FCFF가 비활성화됩니다. 연간 잔액은 이후 배당, 자금 조달 및 희석을 반영하기 위해 업데이트해야 할 수도 있습니다.
새 내보내기 결과를 시각적으로 검토
저장소에는 제공된 보고서에 대한 검증이 포함되어 있지만, 새로 생성된 서술 및 레이아웃 내보내기는 별도의 시각적 검토가 필요합니다. 차트, 계산표, 통화, 날짜 및 다운로드한 파일이 선택한 입력값과 일치하는지 확인하세요.
결론
Equity Research Agent는 기준일이 있는 공개 사실에서 투명하고 편집 가능한 리서치로 이어지는 구조화된 경로를 제공합니다. 로컬에 설치하고, 지원되는 증권을 선택한 뒤, DCF 가정을 검토하거나 논의하고, 결정론적 엔진으로 시나리오를 계산한 다음, 생성된 Word 또는 PDF 보고서를 검토하세요. 결과물은 투자 등급이나 확정된 목표 주가가 아니라 조건부 리서치 초안으로 취급해야 합니다.