스키마 & 문서

사람·에이전트 공용 레퍼런스

Pearlify Schema — 공통 봉투

화면·MCP·REST·WS가 공유하는 정규화 스키마. 4개 소스를 공통 봉투로 감쌉니다.

{
  "id": "evt_...",
  "ticker": "005930",
  "company": "삼성전자",
  "sector": "반도체",
  "domain": "disclosure|commodity|news|quote",
  "event_type": "supply_contract",
  "summary": "미국향 HBM 3,000억 공급계약",
  "metrics": { "scale": 3000, "unit": "억원" },
  "mapping": { "business_unit": "DS/메모리", "direction": "positive", "rationale": "분기 매출 대비 2.1%" },
  "importance": { "level": "high", "reason": "신규 대형 고객·HBM 수요 확인" },
  "source": { "name": "dart", "url": "https://dart.fss.or.kr/...", "doc_id": "2026..." },
  "observed_at": "2026-06-07T04:12:00Z",
  "revised_at": null
}

도메인별 event_type

domain	주요 event_type
disclosure	supply_contract · periodic_report · earnings_flash · financing · equity_change
commodity	settlement · spike
news	order · guidance · regulation · mna · macro
quote	quote · financials

인터페이스 매핑

화면	MCP	REST	WS
유니버스	list_universe	GET /v1/universe	—
종목 상세	get_stock	GET /v1/stocks/:ticker	subscribe{ticker}
피드	get_feed	GET /v1/feed	stream?topics=
원자재	get_commodity_impact	GET /v1/commodities/:sym/impact	subscribe{commodity}