gather

엔진 역할

gather는 분석 엔진이 쓰는 외부/보조 데이터를 가져오는 L1 성격의 실행 엔진이다. 가격, 컨센서스, 수급, 뉴스, 배당/분할, 섹터, 내부자거래, 주요주주, 기관 보유, peer, 매크로 원자료를 다룬다.

gather는 원자료 수집과 snapshot 생성이 목적이다. 재무 해석은 analysis, 시장 매크로 해석은 macro, 후보 발굴은 scan이 담당한다.

공개 호출 방식

dartlab.gather 는 두 가지 형태로 쓴다 — 형태 A 가 권장 진입점, 형태 B 는 Gather 클래스 메서드를 직접 부를 때.

# 형태 A — 모듈 callable (권장). dartlab.gather 는 GatherEntry 인스턴스라 axis 디스패치.
import dartlab

dartlab.gather()                              # 가이드 DataFrame (전체 axis 목록)
dartlab.gather("price", "005930")             # KR OHLCV
dartlab.gather("price", "AAPL")               # US OHLCV (자동 판정)
dartlab.gather("flow", "005930")              # 수급
dartlab.gather("flow", "005930", limit=30)    # 최근 30거래일 수급
dartlab.gather("flow", "005930", start="2010-01-04", end="2010-01-08", sleepSec=1.0)  # 과거 수급 저속 백필
dartlab.gather("flow", "005930", all=True, sleepSec=1.0)  # 가능한 전체 수급 이력
dartlab.gather("flow", "005930", all=True, sleepSec=1.0, proxy="http://user:pass@host:port")  # 사용자 프록시 경유
dartlab.gather("flow", targets=["005930", "000660"], limit=30, parallel=2, proxy="http://user:pass@host:port")  # 종목 단위 병렬 수급
dartlab.gather("macro")                       # KR 거시지표 wide
dartlab.gather("macro", "FEDFUNDS")           # FRED 자동 감지
dartlab.gather("news", "삼성전자")             # Google News RSS
dartlab.gather("narrative", market="KR", days=30)    # 뉴스 내러티브 archive
dartlab.gather("krxIndex", "close", market="KOSPI")  # 시장군 지수
dartlab.gather("research", "005930")                 # 증권사 리서치 메타 인덱스
# 네이버 분류/목록 (로컬 개인용 — 재배포 금지). 계약은 아래 "naver* 축" 절.
dartlab.gather("naverTheme")                          # 전 테마 결합 (7일 로컬 저장·재호출 직독)
dartlab.gather("naverTheme", "list")                  # 테마 목록만 ("리튬"=해당 테마 · refresh=True=강제 재크롤)
dartlab.gather("naverIndustry", "반도체")             # 네이버 업종 분류
dartlab.gather("naverEtf", "KODEX")                  # ETF 목록 (종목명 필터)
dartlab.gather("naverEtn")                            # ETN 목록
# 정기공시 due 는 Company.calendar — gather("calendar") 는 0.10 폐기
dartlab.Company("005930").calendar(horizonDays=30)   # DART_API_KEY

c = dartlab.Company("005930")
c.gather("price")                             # 종목코드/market 자동 주입

# 형태 B — Gather 클래스 메서드 (dividends/majorShareholders 같은
# axis 미등록 메서드, snapshot=True 등 세밀한 옵션 필요할 때).
from dartlab.gather import getDefaultGather

g = getDefaultGather()
g.price("005930", market="KR")
g.price("005930", snapshot=True)              # PriceSnapshot (현재가)
g.dividends("005930")
g.majorShareholders("005930")
g.collect("005930")                           # 전체 도메인 병렬 수집 → GatherSnapshot