desc: 회사가 보유한 자산(투자부동산·지분증권·현금성·관계기업 지분)을 감사 연결재무제표 계정에서 뽑고, 시총 대비 청산가치(NAV) 커버리지로 자산저평가주를 스크리닝. "시총보다 보유 자산이 값진가"에 답합니다. when: 자산주·NAV·청산가치·지주사 할인·숨은 부동산/지분 분석. "이 회사 자산 뭐 있어? 자산 대비 싸?"(summary) · 원문 명세로 직접 확인(detail). 전사 밸류(PER/PBR)는 valuation, 재무비율은 financial_metrics. scope: summary(기본) — 자산을 목적버킷(현금성/환금성증권·재테크형/우호제휴지분/지배관계사지분/투자용부동산/본업자산)으로 분류해 "재테크형·부동산 자산주형·지주사 할인형·우호지분형" 한 줄 서사(asset_story) + 세부 계정 + 상장 보유지분 시가마크 + 담보·우발 haircut 플래그 + 시총 대비 배수(잉여자산/지분NAV, 금융업은 미제공) / detail — III.주석 원문 markdown(토지 원가vs공정가치·지분증권·담보·우발) — summary에서 haircut 플래그가 뜨거나 숫자 원문을 직접 확인하고 싶을 때. rule: 구조화(계정·타법인출자)는 숫자, 주석(토지gap·담보·우발)은 원문 markdown 반환→caller가 읽어 판단. 시가마크는 상장 보유지분만(비상장은 장부가). 배수는 부채 미차감 gross → PBR 병용. 담보·우발은 NAV에서 차감해야 정확(detail로 확인). 금융업(KSIC 64/65/66)은 투자자산=본업이라 금융 리그 라벨. ref: valuation, financial_metrics, business_details, treasury_share

desc: DART 정기보고서 **"II. 사업의 내용"**에서 사업부문별 매출·영업이익, 사업장·생산설비, 생산실적·가동률, 연구개발, 수주현황, 주요 고객·매출처를 추출. SOTP·부문 수익성·생산능력·수주·고객집중 분석의 1차 소스. when: 회사의 사업부문·생산·수주·고객 구조가 필요할 때. 전사 재무는 financial_metrics, 밸류는 valuation. 금융/증권/보험/지주는 financial_ops·financial_soundness, REIT/보험은 investment_property 로 커버(segments 대신). 여러 분기/연도 추이가 필요하면 bsns_year+reprt_code를 지정해 과거 시점을 하나씩 반복 호출. rule: segments는 정형→저신뢰 시 원문 마크다운. 나머지 필드는 해당 소절 원문을 마크다운으로 반환 — 그 표를 읽어 값 추출(단위·정의 회사별 상이, 비교 주의). context_mode=candidate는 strict가 NOT_COLLECTED일 때만 저신뢰 고정 윈도우 문맥을 별도 candidate_context로 반환하며, 공식 결과·hint로 사용하면 안 됨. 이 모드는 표준 필드 하나를 지정할 때만 사용. 금융/REIT 필드는 표준사에선 자동 N/A. 유형자산 장부가 표를 사업장으로 오독 금지. 응답 report.report_nm으로 어느 보고서인지 확인(분기/반기/사업). bsns_year/reprt_code는 반드시 둘 다 지정(하나만 주면 에러) — 지정 시 period는 무시됨. period: latest(기본, 사업·반기·분기 중 가장 최신 제출분=최신 데이터) / annual(연간 사업보고서 고정) / quarterly(분기·반기 고정). II.사업의내용은 분기/반기도 완전구조라 동일 필드. bsns_year+reprt_code 지정 시 이 파라미터는 무시. fields: 쉼표구분 — 표준: segments,sites,utilization,rnd,backlog,customers / 금융·REIT: financial_ops,financial_soundness,investment_property. (미지정 시 회사에 맞는 표준·금융 필드만). 자산(토지·투자부동산·지분증권 원가vs공정가치)은 별도 tool asset_holdings. bsns_year: 특정 과거 사업연도 조회(예: "2025"). reprt_code와 함께 지정해야 함 — 추이 조회용(한 번에 여러 분기 반환 아님, 분기마다 반복 호출). reprt_code: DART 표준 보고서유형 — 11011(사업/연간) 11012(반기) 11013(1분기) 11014(3분기). bsns_year와 함께 지정. context_mode: strict(기본) / candidate. candidate는 strict NOT_COLLECTED일 때만 단일 표준 필드의 저신뢰 보조 문맥을 별도 반환. context_chars: candidate 고정 문맥 길이(기본 20000, 최대 60000). strict에서는 사용하지 않음. ref: financial_metrics, valuation, order_contracts, company

desc: 기업 식별 + 최근 공시 인덱스. 모든 data tool 공통 입구. 회사명/ticker/corp_code → 시장·업종·최근 공시. when: 검색 시작 → ticker/corp_code 확정 후속 tool에 전달. 최근 공시 종류·빈도 훑을 때. rule: 비상장 법인 자동 제외 (상장사 전용). 공식 한글·영문명과 별칭을 우선하고, 부분명은 활성 상장·시총 격차가 충분할 때만 자동 추론. 공식명 exact는 시총보다 우선. params: query, max_recent_filings(1-20), start_date/end_date(YYYYMMDD), language(auto|ko|en) ref: shareholder_meeting_notice, ownership_structure, dividend, proxy_contest, value_up

desc: 기업지배구조보고서. 최대주주/지분율 + 15개 핵심지표 O/X + 세부원칙 응답 + 연도별 추이. 2026 제출분부터 KOSPI 전체 의무, KOSDAQ 자율. 제출 시한 매년 5월말, 연중 정정 빈번. when: 거버넌스 종합 평가, 15개 지표 준수 현황, 연도별 변화 추적. B외국계 수준 배경자료. rule: DART list.json + 키워드 "기업지배구조보고서공시" + 원문 파싱. 기본 lookback 4년. 15개 표준 지표 라벨 prefix 매칭으로 O/X 당기·직전기 + 비고 추출. scope: summary 기업개요+준수율+15지표 / metrics 15지표 + 비고 상세 / principles 세부원칙 응답 / filings 제출 이력 / timeline 연도별 추이 + 지표 전환 year: 사업연도 지정 (0이면 최신). ref: ownership_structure, shareholder_meeting_notice, proxy_contest, evidence

desc: 회사·지분 인수/매각(타법인주식·출자증권 취득/처분) 공시. 계열사 출자·회수, 일감몰아주기·내부거래·특수관계자 거래 모니터링. include_details=True면 거래 상대방/금액/자산대비비율/특수관계 힌트. when: 어떤 회사를 인수했나/팔았나(지분 취득·처분·양수도), 계열사·자회사 출자와 회수, 투자 포트폴리오 재편, 자회사 주요경영사항 흐름, 일감몰아주기 신호. 단일판매·공급계약(수주/해지·매출대비)은 order_contracts. 합병·분할·주식교환은 corporate_restructuring. rule: DART list.json — 타법인주식: B/I + 양수/양도/취득/처분결정 키워드. 자회사 주요경영사항/자율공시/[기재정정] 플래그 별도 표시. 기본 lookback 24개월. include_details=True 시 최근 N건 원문 파싱(상대방·관계·금액·비율·목적). scope: summary 통합 timeline / equity_deal 타법인주식 (단일공급계약은 order_contracts로 분리됨) include_details: True면 원문 파싱 추가 (DART 호출 N회 증가). details_limit: 원문 파싱 건수 (기본 5, 최대 10). ref: order_contracts (단일공급계약 수주/해지/일감), corporate_restructuring (합병/분할/주식교환), ownership_structure (지분 변화), evidence (원문 확인)

desc: 지배구조 재편 4종(합병/분할/분할합병/주식교환·이전) 결정 통합. 합병비율·상대방 재무·신주발행·외부평가·주식매수청구권 + timeline + detail card. when: M&A 중 합병·분할·주식교환 형태, 지주회사 전환, 자회사 흡수 분석. 주식매수청구권 가격, 합병비율, 상대방 재무 비교. 단순 지분 인수·매각(주식 양수도)은 corporate_deals. rule: DART DS005 4 API 병렬 — cmpMgDecsn/cmpDvDecsn/cmpDvmgDecsn/stkExtrDecsn. 기본 lookback 24개월. ref: corporate_deals (지분 인수·매각), ownership_structure, shareholder_meeting_notice, evidence

desc: 희석성 증권 5종(유상증자/CB/EB/BW/감자) 결정 통합. 발행조건·잠재 희석률·3자배정·풋옵션·refixing + timeline + detail card. when: 행동주의 대응 자금조달, 경영권 방어 지분 확보, CB·BW 잠재 희석 평가, EB(자기주식 교환사채) 의결권 희석, 3자배정 대상 식별. ownership_structure 교차 권장. rule: DART DS005 5 API 병렬 — piicDecsn/cvbdIsDecsn/exbdIsDecsn/bdwtIsDecsn/crDecsn. 기본 lookback 24개월. EB는 교환대상이 자기주식이면 의결권 희석(신주 희석 X). 정정·철회로 구조화 응답이 비면 원본 공시(list.json) 문서 파싱으로 교환가액·교환대상 자동 복원. ref: ownership_structure, treasury_share, corporate_restructuring, proxy_contest, evidence

desc: 개별 이사 단위 정보 — 이사 인당 보수, 보수한도 소진율(연도별 rm 비고 원문 포함), 임원 재직/사퇴 변동(연도 diff + DART 공식 사외이사 변동 집계로 교차검증), 개인별(5억+) 보수와 RSA/스톡옵션 등 미확정 주식보상, 미등기임원 보수, 경영진-직원 보수 배수(부문별 세부 포함) — 전부 lookback_years만큼 연도별(YoY) 비교 가능. corp_gov_report가 '회사 15지표 준수'라면 이건 '누가 얼마 받고 인원이 어떻게 바뀌었나'. 가치판단(적절/과다)은 하지 않고 수치·전년비 변동·flag만. when: 이사 보수 안건 판단, 스튜어드십 engagement — 예: "이사 보수한도 소진율 얼마야"(compensation), "작년에 이사 누가 오고 나갔어"(roster), "대표이사들 각각 얼마 받아·스톡옵션 있나"(individual), "임원-직원 보수 격차 몇 배"(pay_gap), "이번 주총 한도 왜 올려달래"(pay_agenda). rule: exctvSttus+drctrAdtAllMendngSttus 2종+hmvAuditIndvdlBySttus+unrstExctvMendngSttus+ empSttus+outcmpnyDrctrNdChangeSttus 정형 API 6종 전부 재사용. 소진율 분자는 감사위원 포함 이사류 실지급 합(순수 감사만 별도 한도), 한도 공백해는 최근 유효연도 lookback. 재직/사퇴 diff는 2-pass 매칭(이름 정확일치로 먼저 확정 → 나머지만 생년월로, 남은 후보군에서 유일할 때만)으로 로마자표기 변동·동일 생년월 동명이인 오탐 둘 다 억제 — 사외이사 변동현황 API의 공식 집계 (선임/해임/중도퇴임 수, 사외이사 신규선임만 필터링해 비교)로 규모감 교차검증. attendance는 사업보고서 원문에서 개별 이사 출석률을 파싱하되, 회사가 일부(주로 사외이사)만 '(출석률:%)'로 기재하면 전체가 아님을 data_quality_flags(attendance_partial)로 표시. 원문 fetch(8MB)라 summary 기본엔 미포함 — on-demand scope로 조회. scope: compensation | roster | individual(5억+ 실명, RSA/스톡옵션 노트 포함) | unregistered(미등기임원) | pay_gap(경영진 vs 직원 배수, 부문별 세부) | pay_agenda(보수한도 주총안건 올해vs작년) | attendance(개별 이사 출석률·원문, summary 제외) | pay_criteria(보수 산정기준·개인별 급여/상여 분해·KPI 가중치, 사업보고서 VIII-2 원문, summary 제외) | summary(기본) 각주 마커('(주1)' 등 정형 API가 본문을 안 주는 비고)는 resolve_footnotes=True(기본)면 해당 사업보고서 원문에서 각주 본문을 자동 복구(마커 뜬 공시만 1회 fetch·캐시) — 실패 시 원문 발췌 폴백. year: 기준 사업연도(0=최근 확정 전년). lookback_years: 조회 기간(년), 기본 3 — 대부분 scope에서 YoY 적용 resolve_footnotes: 각주 마커를 원문에서 해소할지(기본 True). False면 원문 fetch 없이 마커만 플래그. ref: corp_gov_report, director_evaluation, shareholder_meeting

desc: 실지급·확정된 배당 사실. DPS, 총액, 배당성향, 시가배당률(결의 당시)+현재가 기준 배당수익률(최신 종가, krx_weekly), 분기별 추이. 미래 정책·약속 X. when: 실제 지급된 배당 확인. 분기배당 회사는 history로 분기별 breakdown. 미래 정책/약속은 value_up. rule: source 2단 — (1) 사업보고서 alotMatter(공식값) (2) 현금ㆍ현물배당결정 합산(alotMatter 빈 경우 fallback). 결산배당은 record_date 기준 fiscal year bucket (선배당-후결의 신법). 정정공시 is_superseded 표시. 미래 약속 추가 금지. scope: summary 선배당-후결의+감액배당 메타 / detail 요약+최근 결정 50건 / history N년 추이+분기 breakdown+policy_signals ref: value_up, treasury_share, shareholder_meeting_notice, company, ownership_structure, evidence

desc: 인용 정보 제공자. rcept_no → 공시일·소스·뷰어 URL 유도. API 호출 없음, 원문 추출 없음 — 순수 메타 가공기. when: evidence_refs 출처 재확인. raw rcept_no의 공시일/소스 빠른 판단. rule: 앞 8자리 → rcept_dt. 9~10자리 → source_type(80=수시공시, 그 외=DART). viewer_url은 DART 뷰어로 통일. report_nm은 upstream evidence_refs에만 있음. 14자리 숫자 아니면 requires_review. ref: 모든 data/action tool

desc: DART 재무 4 endpoint 통합 — 수익성/안정성/현금흐름/회계 risk. 한국 표준(연결, 지배주주 귀속). 듀퐁·FCF·NWC·accruals_gap·감사의견 자동 산출. when: 재무 펀더멘탈 + 회계 risk 진단 / 적자전환·턴어라운드·이자보상배율 alert / 사외이사 후보 재직 시점 회계 사건 cross-check. rule: source = fnlttSinglAcnt(BS+IS 30행, 요청 fs_div로 행 필터) + fnlttSinglIndx(보조 ROE) + fnlttSinglAcntAll(CF+213행) + accnutAdtorNmNdAdtOpinion(감사의견 3년). 금액 raw KRW int(_krw), %는 float(_pct), 비율 decimal(_ratio). 연결 default, 적자/0 분모 graceful. 금융사(은행·지주)는 매출액 계정이 없어 None — 영업이익·순이익 기준 해석. 분기 합≠연간이면 기중 분할·재작성 warning 자동 부착. 이자보상배율 분모 = IS 이자비용, 없으면 CF '이자의 지급' (금융비용 총액 사용 안 함). EBITDA는 CF에서 D&A가 추출된 회사만 산출 (조정 합계 공시 회사는 None). period: DART 기간 의미가 항목별로 다름 — 손익 thstrm=당기3개월/누적은 thstrm_add, 현금흐름=누적, 재무상태=잔액. summary가 분기보고서면 ① 손익은 누적(YTD) 기준 primary + 당기 분기(standalone)를 standalone에 별도 동봉(반기/3분기), ② 회전일수(DSO/DIO/CCC)는 TTM(최근 4분기) 분모로 산출(단일분기 연환산 왜곡 제거), ③ ROE/ROA/자산회전율은 연환산 안 함(분기값). 기준은 항상 period_basis/turnover_basis/basis_note로 명시. year 미지정 시 quarterly·qoq는 당해 연도(최신 분기 포함), summary·yearly·yoy는 직전 사업연도. scope: summary 핵심 지표 1년(분기보고서면 누적+standalone) / yearly N년 추이 / quarterly 12분기 standalone 손익 + QoQ·YoY(마진은 %p) 기본 동봉 (Q4는 연간−3분기 누적 차분 — 연간치 혼입 없음) / yoy 전년+alert / qoq 전분기 (standalone 기준) / audit_opinion 3년 추이 ref: dividend, corp_gov_report, shareholder_meeting_notice, evidence

desc: 정관↔법령 양방향 조회기. 정관 조항·키워드·두루뭉술한 표현 → 관련 법령 조문(전문 포함), 또는 법령 조문번호·키워드 → 조문 전문 + 관련 정관 변경유형·우회 시나리오·주총 안건신호. 상법·상법 시행령·자본시장법·공정거래법·외부감사법(각 법률+시행령) 원문(legalize-kr)을 인덱싱. 회사·DART 무관, API 호출 0 — 순수 법령 지식 조회기. 카디널리티 1:1·N:1·1:N·N:N 전부(랭킹된 전체 후보, first-match 아님). when: "이 정관 조항이 무슨 법이랑 엮여?"(clause_to_law), "자본시장법 §147 뭐야·전문 보여줘"(law_to_clause), "집중투표 배제 조항 삭제하면 무슨 법 위반?", "감사위원 분리선출 근거 조문", "상호출자 금지 조문", "전자주주총회 도입 관련 법". proxy_advise(특정 회사 주총 안건 판단)와 달리 회사 맥락 없이 법령 자체를 묻는 질의. rule: 3신호 융합 — E(정확 조문 튜플 매칭, substring 절대 금지 → 제12조≠제12조의2, 상법§147≠자본시장법§147)

• B(40룰 bridge 재사용, _agenda_pattern_match — 정관패턴↔조문, free-text law_reference도 파싱)

• C(corpus 키워드, idf·anchor 게이트 — 두루뭉술 질의는 requires_review). 보수적: 폐쇄 큐레이션 어휘 (law_lookup_synonyms.json)만, false-friend guard(이사↮사외이사 등), difflib 없음. 삭제 조문 보존+경고. 미시행: 전문 시행예정본은 조문별 현행여부 '확인필요'로 유보(단정 X), 진짜 조문별 미래시행만 SSOT effective_date로 flag. 조문번호 법령 미지정+중복 → ambiguous. 강매치 아니면 폴백 유형별 안내(fallback). query: 정관 조항 텍스트 · 키워드 · 조문번호(예: 제542조의8) · 자유 질의 direction: auto(기본) | clause_to_law(정관/키워드→법) | law_to_clause(법조문/키워드→정관·안건) law: 법령 필터 "" (전체) | 상법 | 자본시장법 | 공정거래법 | 외부감사법 (시행령 포함) as_of: YYYY-MM-DD 기준일(기본 오늘) — 시행/미시행·명칭변경(사외이사↔독립이사) 게이팅 include_full_text: 조문 원문 전문 포함(기본 True). False면 메타·항/호 구조만 top_k: 표시 후보 수(기본 10, 초과분은 총계만 경고) ref: proxy_advise_before_meeting, shareholder_meeting_notice, evidence

desc: 회사의 수주(단일판매·공급계약체결) 추적 — 계약금액·매출액 대비%·상대방·계약기간. 적자 디폴트인 코스닥 바이오/기술주에서 수주 = 미래 매출 가시성 시그널. 기재정정(변경계약) 자동 dedup + 증액/감액 diff. when: 얼마짜리 수주를 따냈나, 수주가 매출 대비 얼마나 큰가(적자기업 가시성), 최근 수주 모멘텀, 외부 수주 vs 계열 일감(공시 관계필드 기준), 계약 해지, 수주 증액/감액 변경. 지분 인수/매각(타법인주식)은 corporate_deals. rule: DART list.json I001 — 단일판매ㆍ공급계약체결/해지 (일반+자율공시 모두 I001, 자회사 변형 포함). 본문 파싱: 계약금액(단위 원/천원/백만원 환산)·최근매출액·매출액대비%·상대방·관계(외부/계열)·계약기간. dedup: (계약명+상대방) 그룹 + 정정본 정정전금액으로 원본↔정정 매칭(같은 키라도 금액 체인 불일치 시 별개). 기본 lookback 24개월. max_documents: 본문 파싱 상한 (기본 30). ref: corporate_deals (타법인주식 지분 인수/매각), financial_metrics (매출·수익성), evidence (원문 확인)

desc: 최대주주·특수관계인·5% 대량보유 지분 구조 + 공동보유자 분해. 자사주 detail은 treasury_share 별도. when: 지배력 구조, 최대주주 비중, 특수관계인 지분 합, 5% 활성 시그널, "OO의 N% 지분이 누구누구 공동보유냐 / 보고자 본인 지분은 얼마냐" 질의. rule: 사업보고서 DART 공식 API 우선. 5% 대량보유 목적은 최신 원문 보강. 변동신고서는 DART API 우선, KIND fallback. 5% 보고 헤드라인 지분율(ownership_pct)은 보고자 본인 + 특별관계자 합산임 — 본인만 보려면 reporter_self_pct, 공동보유자 내역은 co_holders[{name, ownership_pct, is_registry_holder}] 사용. co_holders_verified=False면 합계 미검증이라 원문 대조 필요(확정 인용 금지). 합계표 없는 약식보고(기관 단순투자 등)는 co_holders=None. scope: summary 최대주주+5%블록(+공동보유자 분해)+자사주 snapshot / major_holders 특수관계인 detail / blocks 5% 대량보유 최신+이력+공동보유자 분해 / control_map 3대 카테고리(명부 등재/외부 능동/수동)+공동보유자 / changes 최대주주변동신고서(I004) + 5% 대량보유 변동(D001) 통합 ref: treasury_share, proxy_contest, evidence

desc: DART 영업(잠정)실적(공정공시 I002)에서 분기 잠정 매출·영업이익·순이익 + YoY/QoQ 추출. 정기보고서 확정치보다 먼저 나오는 가장 빠른 실적 신호(분기말 며칠 뒤). when: 최신 분기 실적을 정기보고서(financial_metrics 확정치) 나오기 전에 볼 때. 잠정치(감사 전)라 확정과 다를 수 있음 — 확정 재무비율은 financial_metrics. rule: 재무형(매출·영업이익 표)은 구조화 반환. 자동차 판매대수 등 비재무형은 raw 마크다운(kind=non_financial). 연결/별도 basis·실적기간·단위 명시. 값은 원문 그대로(원 단위 정규화), 잠정치. ref: financial_metrics, screener, valuation

desc: 주총 소집 전 안건별 의결권 권고. 1회 호출로: 안건별 FOR/AGAINST/REVIEW/NO_DATA + facts + risk_factors + policy_citation + 근거 공고 + 후보 평가 + 재무/거버넌스 summary. ⛔ CRITICAL: 응답의 decision 컬럼은 한국 상법 강행규정 (A1/A2 tag 🛡️) + 운용사 정책 (vote_style) + Open Proxy Guideline 통합 결과. 사용자에게 그대로 제시 — 안건명 키워드(배제·제한·축소·강화)만 보고 자체 판단으로 변경 금지. 자주 misread: '집중투표 배제 조항 삭제' = FOR(의무화 정합), '의결권 제한 강화' = FOR(합산 3% 룰). when: 소집공고 후 ~ 주총 직전. 의결권 행사 결정 + 내부 보고. 사후 결과는 shareholder_meeting_results. rule: 운용사 의결권 행사 보고서 스타일. hard-fail(형사 처벌/사적 관계/동명이인) 자동 검증 가능 항목만 표기. soft-fail(후보 약력/정관 본문) raw 노출 — LLM 판단. vote_style: open_proxy (default — OPM 자체 가이드라인). 다른 옵션은 internal cross-reference용 check_audit_history: True 시 후보 과거 회사 × 회계 risk overlap cross-check (+30s) meeting_type: annual(default) / extraordinary / auto ref: shareholder_meeting_notice, financial_metrics, corp_gov_report, ownership_structure, proxy_contest, value_up, shareholder_meeting_results

desc: 위임장·소송·5% 경영참여 시그널 통합. 자동 분류 X 힌트 제공 (filer_has_5pct_active_block 등). 애널리스트 종합 판단. when: 경영권 분쟁, 주주 캠페인, 소송, 능동적 5% 보유, 표 대결 신호. rule: DART D/B/I만 (KIND false match 위험). 위임장 filer 3-way: company/shareholder/retail_activism(컨두잇·헤이홀더 등). has_contest_signal은 shareholder OR litigation OR external_active_block만. vote_math는 보수적, 승패 예측 X. scope: summary / fight 위임장+힌트 / litigation / signals 5% 대량보유 / timeline 전 이벤트 / vote_math 표 구조 ref: shareholder_meeting_notice, ownership_structure, company, evidence

desc: 기업 리스크 이벤트 공시 통합 — 중대재해(산재·사망사고) / 횡령·배임 / 생산중단·영업정지. 본사·종속/자회사 변형 포함. company 미지정(공백)이면 시장 전체 최근 30일(최대 90일) 스캔 — "최근 사고·사건 터진 기업들". include_details=True면 카테고리별 원문 파싱(사상자/혐의자·혐의금액·자기자본%/중단부문·매출비중). when: 중대재해, 산업재해, 산재 사망사고, 중대재해처벌법, 횡령, 배임, 생산중단, 영업정지, ESG 안전(S), 기업 리스크 모니터링(회사 미지정 시장 스캔). rule: DART list.json I001(거래소 주요경영사항)+B001(주요사항보고서) 양 채널 + 키워드 — 중대재해는 305사 3.5년 차집합 0 검증, 본문 파싱은 연속 2개 90일 윈도우 359건 전수 audit. company 지정 시 24개월 / 미지정 시 30일(최대 90일). 주의: 중대재해 수시공시 신설 2025-10 — 이전 무공시 ≠ 무사고. 공시는 대형 원청·지주사 집중 — 비상장 자회사 사고는 상장 모회사가 공시. category: serious_accident 중대재해 / embezzlement 횡령·배임 / production_halt 생산중단·영업정지 — 미지정 시 3종 전체. include_details: True면 원문 파싱 추가 (DART 호출 N회 증가) + 중대재해 사상자 집계. details_limit: 원문 파싱 건수 (기본 5, 최대 10). ref: corp_gov_report (지배구조 맥락), proxy_contest (소송·분쟁), evidence (원문 확인)

desc: 전체시장 공시 스크리너 / 아침 공시 디제스트. 직전 실행 이후~오늘 전종목에 뜬 주요 공시를 카드형으로 요약(기업명+시총+유형+단계+정정+DART/naver 링크). 무인자 호출=오늘 아침 디제스트. scan(무엇이 떴나, 싸게)=디폴트, details=true면 필요 건만 문서 열어 유형별 핵심숫자(금액·분모%·DPS·안건·지분%). when: "오늘/어제 무슨 공시 떴어", "최근 며칠/일주일 잠정실적 발표", 매일 아침 공시 브리핑, 전체시장 영업(잠정)실적·수주·자사주·배당·증자·주총·5%보유 훑기, 특정 유형만 필터, 시총상위/지정종목만. 특정 회사 1곳 심층은 개별 tool(provisional_earnings·order_contracts·dividend 등). types: core(영업잠정실적·수주·자사주·배당·증자CB·주총소집·5%보유) / all / 쉼표구분 코드. 코드: earnings(영업잠정실적: 매출·영업익·YoY),order,treasury,dividend,dilutive,agm_notice,ownership5,agm_result,restructuring,stake_deal,control_change,litigation,insider10. period: today / yesterday / since_yesterday(디폴트) / last_7d / last_30d / custom(custom_start·custom_end YYYYMMDD). 시장스캔 3개월 하드캡. universe: all(디폴트 전체시장) / kospi200(=KOSPI 시총상위200, 코스닥 미포함) / kospi:N / kosdaq:N / top_mktcap:N(전체시장 시총상위) / market:kospi|kosdaq(시장 전체) / custom:종목,종목(코드 또는 회사명 혼용 — "삼성전자" 이름도 자동 코드화). 각 카드에 시총 병기. details: false(디폴트, scan만) / true(문서 열어 숫자 — universe=all이거나 기간>30일이면 안전상 자동 off, 기간>7일이면 preview). rule: DART list.json 전체시장 필러(corp_code 無)를 유형별 detail코드로 스캔 → report_nm 키워드 분류 → 시총(krx_weekly) 부착 → dedup(정정=최신본만). 정정=[기재정정] 프리픽스, 단계태깅(결정≠결과≠소각). details는 유형별 파서(order_contracts 등) 디스패치. 빈 결과는 no_new(신규없음)/status=error(조회실패)로 구분. ref: order_contracts·treasury_share·dividend·dilutive_issuance·shareholder_meeting_notice·ownership_structure (유형별 심층)

desc: 밸류업 계획·배당·자사주 소각 약속 vs 실제 이행 추적. proxy_advise_before_meeting이 주총 시점 1회성 판단이라면, 이 tool은 주총과 무관하게 연중 스튜어드십 관여용 — "작년에 공표한 계획을 실제로 지켰나"를 본다. 자사주 소각 사이클마다 매입시점 BPS 대비 실제 매입가를 비교해 장부가(BPS) 기준 손익을 원화로 계산(내재가치 판단은 하지 않음, 장부가 사실만). when: 스튜어드십/기관투자자 engagement, 연례 보유종목 점검, "이 회사 약속 지켰나" 질문. rule: value_up(계획)+corp_gov_report(준수변화)+dividend(실제배당)+treasury_share(실제소각, 260707 원문단위버그 수정 완료)를 조합. 결정↔실행 매칭 오탐 의심 사이클은 sanity 필터로 제외하고 data_quality_flags에 남김(알려진 treasury_share _link_cycles 별개 이슈 대응). lookback_years: 조회 기간(년), 기본 3 ref: value_up, corp_gov_report, dividend, treasury_share

desc: 주주총회 소집공고 (사전, DART API/XML). 안건·이사 후보·보수한도·정관변경. when: 주총 일정·안건·후보·보수·정관 확인. 결과는 shareholder_meeting_results, 종합 분석은 proxy_advise_before_meeting. rule: 회사 식별 exact만 자동 선택. 정정공시 있으면 최신 정정본 자동 선택. meeting_type: auto(정기/임시 최신 회차 자동) / annual / extraordinary scope: summary 메타+안건+1호 메타 / board 이사·감사 후보 / compensation 보수한도 / aoi_change 정관+퇴직금 변경 raw / prov_financials 잠정 재무제표 4 quadrant include_coverage: true면 조회 구간 내 정기/임시 주총 존재 여부를 추가 계산(느려질 수 있음). 기본 false. rcept_no: 이미 소집공고 접수번호를 알면 회사/후보 검색을 건너뛰고 직접 파싱. ref: company, ownership_structure, proxy_contest, shareholder_meeting_results, proxy_advise_before_meeting, evidence

desc: 주주총회 의결 결과 (사후). 안건별 가결/부결 + 찬반율. DART API 우선, KIND fallback. when: 주총 종료 후 실제 의결 결과 확인. 사전 안건은 shareholder_meeting_notice. 후속 공시(배당/자사주/구조)는 dividend·treasury_share 등 각 tool 직접 호출. rule: rcept_no 80 prefix (수시공시) 본문 fetch. 결과 미공시(KIND 노출 지연) 시 status=pending_or_missing. meeting_type: auto / annual / extraordinary ref: shareholder_meeting_notice, dividend, treasury_share, proxy_contest, evidence

desc: 자기주식 이벤트 통합. 결정 5종(사전 의도) + 결과보고서 4종(사후 집행) 통합 집계. 주주환원 검증 = 결정만 X, 실제 집행 cross-check. when: 자사주 취득·처분·소각·신탁 이력·규모. 결정↔결과 사이클 매칭으로 집행 검증. rule: 9 source 병렬 — Decisions: tsstkAqDecsn(취득)/tsstkDpDecsn(처분)/tsstkAqTrctrCnsDecsn(신탁체결)/tsstkAqTrctrCcDecsn(신탁해지)/소각결정. Executions: 취득결과/처분결과/신탁취득상황/신탁해지결과 보고서. ACODE 본문 파싱. 사이클 매칭은 "주요사항보고서 제출일" / "신탁계약 체결일" ↔ decision rcept_dt. 종류별: 보통주 vs 종류주식(우선주·기타주식·RCPS 등 통합) — 결정/결과 모두 amount_common_krw/amount_preferred_krw로 분리(결과는 복수 종류 시 ACODE가 보통주만 잡는 것을 일별 합산 보정). scope: summary 모든 events + breakdown + cycle 매칭 / annual 사업보고서 연간 누적 잔고 ref: value_up, ownership_structure, dividend, evidence

desc: 상대가치 밸류에이션 — 기업 심층(PER·PBR·배당수익률) + 시장 전체·산업별·종목 히스토리(주간 스냅샷). 한국 표준(연결, 지배주주 귀속). 비KRW 기능통화 자동 KRW 환산(ECOS), 스케일가드, N/M 게이팅. when: "PER/PBR 얼마"·"싼가 비싼가"(scope=firm) / "코스피·코스닥 전체 밸류"(market) / "업종별 PER·PBR"·"섹터 대비 어디"(sector, company 지정 시 소속 섹터 비교) / "밸류 추이"(firm_history) / "이 수치 근거·계산 과정이 뭐야?"(explain — company 지정 시 실제 값 대입 계산, 미지정 시 방법론·기준·출처 전문). 재무 펀더멘탈 자체는 financial_metrics, 배당 상세는 dividend. rule: scope=firm(기본, company 필수) = 실시간 DART 재무 × krx_weekly 시세 — EPS(FY0)=공시 기본주당이익(가중평균, 없으면 지배순이익÷보통주 폴백), EPS(TTM)=TTM 지배순이익÷보통주, BPS=지배자본(MRQ)÷합계주식수, 분모≤0·완전자본잠식=N/M. scope=market/sector/firm_history = Supabase 주간 스냅샷(mkt_val_history·mkt_val_history·firm_valuation_snapshot, market_val_weekly 배치가 갱신) — PER=Σ보통주 시총÷Σ지배순이익(시총가중 조화평균, 우선주 시총은 제외·cap_pref 별도 노출), 시총 기반이라 수정주가 조정 불변. 섹터 분류=KSIC 하이브리드. firm과 스냅샷 방법론 차이(보통주 주가 vs 총시총) 有 — 각 출력에 명시. 값 raw KRW int(_krw), % float(_pct). status: ok / invalid / not_found(우선주는 보통주 코드로) / unlisted / no_financials / no_data(배치 미실행). note: lean v1 — RIM·EV/EBITDA·PSR·FCF·5년밴드·PIT·주당 수정주가 시계열은 v1.1. ref: financial_metrics, dividend, corp_gov_report, evidence

desc: 기업가치제고계획(밸류업) 공시 + commitment 문장. 주주환원 정책·미래 약속. 자사주 소각 이행 교차참조 포함. when: 밸류업 계획, ROE/PBR/배당성향 목표, 자사주 소각 계획 등 미래 약속. 실제 배당은 dividend, 자사주 사실은 treasury_share. rule: DART I 밸류업 키워드 → 없으면 KIND 0184 fallback. 공시 카테고리: plan/progress/meta_amendment(고배당기업 재공시). 최신이 meta_amendment면 실계획 본문을 latest_plan으로 별도. summary/commitments에 24개월 자사주 이벤트 treasury_cross_ref 포함. scope: summary / plan 원문 발췌 / commitments 핵심 약속+이행 교차참조 / timeline 공시 이력 ref: dividend, treasury_share, ownership_structure, company, evidence