기업명 또는 종목코드로 최근 공시 기반 투자 위험도를 분석한다.

Args: company_name: 기업명 (예: "에코프로") 또는 종목코드 6자리 (예: "086520") lookback_days: 조회 기간 (기본 90일, 최대 365일)

DART 공시 접수번호 또는 공시 제목으로 해당 공시의 위험도를 분석한다.

Args: rcept_no: DART 접수번호 14자리 (예: "20240315000123") report_name: 공시 제목 (접수번호 없을 때 사용, 예: "전환사채권발행결정")

신호 유형 조합으로 해당 신호의 특성과 위험 해석을 반환한다.

Args: signal_types: 신호 유형 목록 (예: ["CB_BW", "3PCA", "SHAREHOLDER"]) lookback_days: 참고용 (현재 버전에서는 사용되지 않음)

기업의 공시 이벤트를 시간순으로 정렬해 조작 흐름의 서사를 구성한다.

각 이벤트를 진입기(자금 조달/경영권 진입), 심화기(지배구조 변화), 탈출기(의심/수사/부실) 단계로 분류하고, 알려진 위기 패턴과 매칭한다.

Args: company_name: 기업명 (예: "에코프로") 또는 종목코드 6자리 (예: "086520") lookback_days: 조회 기간 (기본 365일, 최대 365일)

여러 기업(2~5개)의 CB/BW/EB 인수자 + 유상증자 인수자를 비교해 공통 행위자(세력)를 탐지한다.

DART API 제약상, 분석 대상 기업을 직접 지정해야 한다. "행위자 이름으로 역검색"은 현재 불가능하다.

CB/BW/EB 공시(CB_BW, EB 신호)와 유상증자 공시(3PCA, RIGHTS_UNDER 신호)를 모두 수집해 인수자를 통합 비교하며, 공통 행위자에는 출처 태그(CB / 유상증자)를 표시한다.

Args: company_names: 비교할 기업명 또는 종목코드 목록 (2~5개, 예: ["에코프로", "바이오제닉스"])

종목코드로 최근 공시의 접수번호(rcept_no) 목록을 조회한다.

반환된 접수번호는 get_disclosure_document, view_disclosure, check_disclosure_risk 등에 바로 사용할 수 있다.

Args: stock_code: 종목코드 6자리 (예: "086520") lookback_days: 조회 기간 (기본 90일, 최대 365일)

DART 공시 접수번호로 공시 원문 전체를 조회한다.

한 번의 호출로 원문 내용과 수록 파일 목록을 반환한다. 긴 문서는 max_chars로 제한하며, 잘린 경우 안내 메시지가 표시된다. 더 긴 문서나 특정 섹션을 읽으려면 list_disclosure_sections / view_disclosure 를 사용한다.

Args: rcept_no: DART 접수번호 14자리 (예: "20240315000123") max_chars: 최대 반환 글자수 (기본 8000, 최대 20000)

DART 공시 원문의 목차(섹션 구조)를 조회한다.

view_disclosure 호출 전에 이 도구로 섹션 ID와 분량을 먼저 확인하면 좋다.

Args: rcept_no: DART 접수번호 14자리 (예: "20240315000123")

DART 공시 원문을 조회한다. 섹션 지정 또는 페이지 단위로 전체 원문을 읽을 수 있다.

사용법:

1. list_disclosure_sections(rcept_no) → 목차/섹션 ID 확인

2. view_disclosure(rcept_no, section_id="f0s2") → 특정 섹션 읽기

3. view_disclosure(rcept_no, page=2) → 다음 페이지로 순차 읽기

Args: rcept_no: DART 접수번호 14자리 (예: "20240315000123") section_id: 섹션 ID (list_disclosure_sections 결과 참조, 비워두면 전체 문서) page: 페이지 번호 (기본 1) page_size: 페이지당 글자 수 (기본 4000, 범위 1000~8000)

기업 개요를 조회한다 (대표자, 업종, 설립일, 상장 구분 등).

Args: company_name: 기업명 (예: "삼성전자") 또는 종목코드 6자리 (예: "005930")

기업의 주요 재무제표를 조회한다 (매출, 영업이익, 순이익, 자산, 부채).

Args: company_name: 기업명 (예: "삼성전자") 또는 종목코드 6자리 year: 사업연도 4자리 (예: "2024"). 미입력 시 직전 연도 report_type: 보고서 유형 — "annual"(사업보고서), "half"(반기), "q1"(1분기), "q3"(3분기)

여러 기업의 재무제표를 비교한다 (최대 5개 기업).

매출액, 영업이익, 당기순이익, 자산총계, 부채총계를 나란히 비교한다.

Args: company_names: 비교할 기업명 목록 (2~5개, 예: ["삼성전자", "SK하이닉스"]) year: 사업연도 4자리 (예: "2024"). 미입력 시 직전 연도

기업의 최대주주 및 5% 이상 대량보유자 현황을 조회한다.

Args: company_name: 기업명 (예: "삼성전자") 또는 종목코드 6자리 year: 사업연도 4자리 (예: "2024"). 미입력 시 직전 연도

시장 전체 공시에서 preset에 해당하는 위험 신호를 일괄 스캔한다.

기업명을 지정하지 않고 전체 상장사 공시를 조회하므로, 특정 위험 신호가 시장에 얼마나 확산되어 있는지 조기경보로 활용할 수 있다.

사용법:

• "최근 7일 동안 CB/BW 발행 공시 전수": search_market_disclosures("cb_issue", 7)

• "최근 30일 자사주 취득 결정": search_market_disclosures("treasury", 30)

• "최근 14일 감자 공시": search_market_disclosures("reverse_split", 14)

Args: preset: 신호 프리셋 — cb_issue / treasury / reverse_split / 3pca / shareholder_change / exec_change / audit_issue / asset_transfer / going_concern / embezzle / inquiry / all_risk days: 조회 기간 (기본 7일, 최대 90일) max_results: 최대 반환 건수 (기본 50, 최대 200)

임원 보수 현황을 조회합니다 (불공정거래 탐지 참고 자료).

5억 이상 고액수령자·개인별 보수·미등기임원 보수·주총 승인 한도 4개 섹션을 반환합니다.

Args: company_name: 기업명 또는 종목코드 year: 사업연도 (기본값: 직전 연도) report_type: annual(사업) | half(반기) | q1(1분기) | q3(3분기)

Returns: 임원 보수 4섹션 텍스트

최대주주·5% 대량보유자의 지분 변동 시계열을 분석합니다.

보유 비율(Δ) 변화로 매수·매도 클러스터를 탐지합니다.

Args: company_name: 기업명 또는 종목코드 lookback_years: 조회 연수 (기본값 2년, 최대 5년)

Returns: 보고자별 지분 변동 테이블 + 클러스터 알림

감사의견·감사인 교체·비감사용역 이력을 조회합니다.

DART OpenAPI 3개 엔드포인트(accnutAdtorNmNdAdtOpinion, adtServcCnclsSttus, accnutAdtorNonAdtServcCnclsSttus)를 결합해 연도별 감사의견·감사인·보수 경고 신호를 한글 서술로 반환합니다.

Args: company_name: 기업명 또는 종목코드(6자리). lookback_years: 1~10(밖이면 5로 강제).

Returns: 감사의견 표·교체 이력·독립성 경고 텍스트.

미상환 채무증권 5종 잔액을 조회합니다.

회사채·단기사채·기업어음·신종자본증권·조건부자본증권 잔액과 1년 이내 만기 비중을 집계해 한글 서술로 반환합니다.

Args: company_name: 기업명 또는 종목코드(6자리). year: 사업연도(YYYY). 비우면 직전 연도.

Returns: 종류별 잔액 표 + 만기 1년 이내 비중 텍스트.

공시 구조 지표를 집계해 0~100 이상 스코어를 반환합니다.

정정공시 비율·감사의견 이슈·공시의무 위반·자본 스트레스·조회공시 빈도 5개 지표를 가중 합산합니다.

Args: company_name: 기업명 또는 종목코드 lookback_days: 조회 기간 (기본값 365일)

Returns: 0~100 스코어 + 지표별 내역 텍스트

공모/사모 자금 사용내역(계획 vs 실제)을 조회해 조달자금 유용· 목적외 사용 신호를 탐지한다. zombie_ma·fake_new_biz 패턴의 핵심 증거.

Args: company_name: 기업명 또는 6자리 종목코드 lookback_years: 조회 연도 수 (1~5, 기본 3)

DS005 주요사항보고서 12종 결정 공시(양수도·합병·분할·교환)를 구조화 필드로 조회한다. related_party_hollowing·delisting_evasion 패턴의 경로 추적에 사용.

Args: rcept_no: 14자리 접수번호 decision_type: 결정 유형 (미지정 시 지원 타입 안내). business_acq | business_div | tangible_acq | tangible_div | stock_acq | stock_div | bond_acq | bond_div | merger | demerger | demerger_merger | stock_exchange corp_code: DART 기업 코드 8자리. 권장 — DART API가 rcept_no 단독 호출을 거부하는 엔드포인트가 있어 정확한 조회를 위해 corp_code 전달을 권장한다. 미지정 시 rcept_no 단독 폴백을 시도하나 일부 결정 유형은 빈 결과가 반환될 수 있다.

재무제표 4개 지표(매출채권·재고자산·현금흐름·자본잠식)를 전년 대비로 비교해 분식·부실 초기 조짐을 탐지합니다.

Args: company_name: 기업명 또는 종목코드(6자리). year: 사업연도(예: "2024"). 빈 값이면 직전 연도. report_type: "annual"(사업보고서) | "half"(반기) | "q1" | "q3".

Returns: 지표별 당기/전기/Δ 표 + 이상 징후별 쉬운 설명 텍스트.

자본 이벤트(증자·감자·자사주·CB/BW/EB/RCPS 등)를 시간순으로 집계해 '자본 주무르기' 리듬을 탐지합니다.

Args: company_name: 기업명 또는 종목코드(6자리). lookback_years: 1~5(밖이면 3으로 강제).

Returns: 이벤트 총수·12개월 집중도·연도별 집계·시계열·플래그 텍스트.