edgar

엔진 역할

edgar 는 별도 사용자 capability 가 아니라 — dartlab.Company facade 가 ticker / CIK 를 받았을 때 자동 활성화되는 provider 다. DartCompany ↔ EdgarCompany 는 public 메서드 양쪽 동등 SSOT — panel / select / trace / disclosure / liveFilings / readFiling / analysis / credit / quant 모두 같은 시그니처. 시장만 다름. (industry 는 KR 가치사슬 지도 전용 — US 동등 데이터 부재로 EXEMPT, 아래 EXEMPT 섹션 참조.)

EDGAR 재무는 두 소스로 분기한다 (DART 와 같은 메커니즘):

• 소문자 native (c.panel("is"/"bs"/"cf"/"cis"/"sce"/"ratios")) — panel 단일 artifact 의 row payload 에 보존된 XBRL native 셀을 read-time 분해 (presentation role 앵커링). DART c.panel("is") 의 panel 셀 경로 미러. compare(codes, topic="is") finance 비교도 이 native 셀을 쓴다 (account=snakeId, USD 실값).
• 대문자 companyfacts (c.panel("IS"/"BS"/"CF"/"RATIOS")) — SEC companyfacts 벌크(edgar/finance) 위임. panel 과 무관, 항상 가용.

live filings 는 SEC EDGAR API. 거시는 FRED (gather("macro", "FEDFUNDS")).

⚠ native(소문자) 경로는 panel artifact 에 native payload 가 있어야 동작한다. 2026-06-06 이전 빌드된 panel 은 payload 가 없어 c.panel("is")·compare(topic=finance) 가 빈 결과 — EDGAR_FULL_REBUILD=1 (originalSync.yml dispatch) 전수 재빌드로 backfill. 대문자 companyfacts 경로는 영향 없음.

공개 호출 방식

import dartlab

# 1. Company facade — ticker 또는 CIK 인식 자동 EDGAR 라우팅
c = dartlab.Company("AAPL")
print(c.market)       # "US"
print(c.panel.shape)  # 항목 x 기간 격자 크기 (DART 와 동일 인터페이스)

# 2. DART 와 동등 인터페이스 (XBRL 자동 정규화)
bs = c.panel("BS", freq="Q")
is_y = c.panel("IS", freq="Y")
ratios = c.panel("ratios")

# 3. 공시
filings = c.filings()                  # 공시 문서 목록 + 링크

# 3.5. 공시 수평화 보드 — engines.panel 의 US 미러 (DART c.panel 과 동일 표면)
c.panel                                    # item × 기간 wide (pl.DataFrame) — 잡는 순간 보드
c.panel("Risk")                            # 섹션 행 검색 (10-K item 본문)
c.panel("is", freq="year")                 # native 재무 (소문자 — panel payload 셀, role 앵커)
c.panel("ratios", freq="year")             # native 재무비율 (core 공식, panel 자급)
c.panel("IS")                              # 대문자 — companyfacts 위임 (내부 finance, 항상 가용)
c.panel.search("supply chain")             # 본문 전체검색

# 3.6. 회사 간 재무 비교 — 탑레벨 verb (DART 와 동일 호출계약, native 셀 기반)
import dartlab
dartlab.compare(["AAPL", "MSFT"], topic="is", freq="year")   # account(snakeId)×회사, USD 실값

# 3.7. 전종목 횡단 scan — market="us" (companyfacts 기반 재무축)
dartlab.scan("profitability", market="us")                   # opMargin/netMargin/roe/roa + grade
dartlab.scan("account", "sales", market="us")                # 단일 계정 전종목 시계열

# 4. 보조 엔진도 동일 (US 자동)
analysis = c.analysis("financial", "수익성")
credit = c.credit()
quant = c.quant("모멘텀")

# 5. 시장 데이터 (gather ticker 자동 판정)
price = dartlab.gather("price", "AAPL")
macro = dartlab.gather("macro", "FEDFUNDS")
news = dartlab.gather("news", "Apple", market="US")

# 6. 한글 별칭 자동 해결 — 영문 alias resolveEnglishAlias
result = dartlab.searchName("인텔")        # → Intel (EDGAR 자동 재검색)

# 7. EDGAR 직접 client (저수준)
from dartlab import OpenEdgar
client = OpenEdgar()
filings = client.filings("AAPL", form="10-K", limit=5)