Hyean

5분 안에 첫 숫자,
그리고 원문까지.

한국 상장기업 2,800+개의 재무 데이터. 모든 숫자에 DART 원문 링크와 검증 등급이 달려 있습니다. 아래 예제의 출력은 전부 실제 응답 그대로입니다.

Claude Code로 — 30초
코드·API 키 없음. “삼성전자 분석해줘” 한 마디면 분석 보고서.
Python SDK로 — 5분
pandas DataFrame 네이티브. 셀 하나하나가 DART 원문까지 추적됩니다.

Claude Code로 시작 — 30초

터미널에 아래 4줄. 첫 분석 때 브라우저 로그인 한 번이면 끝 — API 키도 .env도 필요 없습니다. (무료 1,000크레딧/월, 카드 불필요 · 표준 보고서 1건 ≈ 35크레딧)

bash
mkdir my-analysis && cd my-analysis
git clone https://github.com/twiw49/financial-harness.git .claude/skills/financial-harness
cp .claude/skills/financial-harness/settings.template.json .claude/settings.json
claude mcp add --transport http hyean https://api.hyean.io/mcp
bash
claude

> 삼성전자 분석해줘

분석 방법론은 Hyean MCP 서버가 런타임에 제공합니다. 상세는 MCP 문서.

Python SDK로 시작 — 5분

1API 키 발급 — 1분

가입(이메일 인증) 후 대시보드에서 키 발급. 무료 1,000크레딧/월 — 카드 불필요.

2설치

bash
pip install hyean

3첫 숫자 — 검증 등급까지

python
import hyean as hy
hy.set_api_key("hyn_live_xxxx")   # 또는 export HYEAN_API_KEY=...

df = hy.load_financials("삼성전자", statement="IS", min_confidence="verified")
df[df.item_id == "IS_REV"][["label_ko", "period_end", "value", "confidence"]].tail(3)
output
label_ko  period_end         value confidence
   매출액  2023-12-31  2.589355e+14   verified
   매출액  2024-12-31  3.008709e+14   verified
   매출액  2025-12-31  3.336060e+14   verified

3.336060e+14 = 2025년 삼성전자 매출 333.6조 원. verified는 DART 재무제표와 XBRL이 교차일치했다는 뜻입니다. 식별자는 기업명·종목코드(005930)·corp_code(00126380) 모두 인식하고, 반환 DataFrame의 모든 행에 corp_code 컬럼이 붙습니다 — 여러 기업을 합칠 때 이 컬럼이 조인 키입니다.

4원문 링크 — 이 API의 이유

python
hy.source_url(df, "IS_REV")
output
'https://dart.fss.or.kr/report/viewer.do?rcpNo=20260310002820
  &dcmNo=11104488&eleId=21&offset=432032&length=1968'

rcpNo는 사업보고서 접수번호, offset·length는 그 숫자가 적힌 원문 위치입니다. 클릭하면 DART 뷰어가 해당 표에서 열립니다 — 어느 셀이든 마찬가지입니다.

+REST로도 동일

curl
curl "https://api.hyean.io/api/companies/00126380/financials?statement=IS&min_confidence=verified" \
  -H "Authorization: Bearer hyn_live_xxxx"

핵심 엔드포인트 13

AI 에이전트의 표준 보고서 1건이 실제로 호출하는 6개 + SDK 사용자의 코어 7개. 전체 레퍼런스는 API 문서에.

표준 런 — 보고서 1건이 부르는 것
GET/companies/{code}/discover이 기업에 어떤 데이터가 있는지 한 콜GET/companies/{code}/summary재무·등급·밸류 종합 1콜GET/companies/{code}/insight-context사업보고서 원문 서술 (카테고리별)GET/companies/{code}/price주가 + 수익률GET/companies/{code}/leading-indicators수주잔고·가동률 등 선행지표GET/companies/{code}/news종목 뉴스 목록
SDK 코어
GET/companies기업 목록·검색GET/companies/{code}/financials재무 시계열 + 파생지표 (SDK 코어)GET/companies/{code}/quality6차원 품질 등급 상세GET/companies/{code}/audit감사의견·KAM·계속기업GET/companies/{code}/disclosures공시 목록GET/companies/{code}/events정규화 이벤트 (금액·주식수·영향항목)GET/companies/{code}/notes재무제표 주석 (차원별)
경계 3종 (정직 고지)
  • ① 금융업(은행·보험·증권) 재무제표 미지원
  • ② 서버 실행 백테스트 미지원 (팩터 패널은 /datasets 벌크 다운로드로 제공)
  • ③ 실시간 시세 미지원 (주가는 일별 EOD)
왜 원문 링크가 중요한가

공시 원문 자체에 오류가 있습니다. 우리는 지금까지 상장기업 1,558개사에서 단위 오기·배수 증폭·항등식 위배 등 82,081건의 원문 수치 오류를 탐지해 보정·표시했습니다. 어떤 오류를 어떻게 잡았는지 전부 공개합니다.

공시 오류 카탈로그 보기 →
무료로 시작하기 — 1,000크레딧/월
카드 불필요 · 전체 API 문서 · 요금제