Skip to main content
Glama
OpenDART MCP Server

OpenDART MCP Server

by gyeongmin100

OpenDART Plugin

PyPI version Python License: MIT

OpenDART API(금융감독원 전자공시시스템 오픈API)를 이용해 MCP 서버를 만들고, 특정 기업의 재무제표를 Excel 파일로 만들어주는 SKILL을 포함한 Claude Code / Codex 플러그인입니다.

  • "하이닉스 2025년 연결재무제표 엑셀로 만들어줘" 한마디로 재무제표 원문(감사보고서)을 가져와 시트별로 정리하고, 각 주석번호에 하이퍼링크까지 걸린 .xlsx 파일을 생성합니다.

  • 공시 검색, 재무제표, 임원/주주 현황, 주요사항보고서 등 DS001~DS006 전 영역 85개 API 도구와 Excel 워크플로 도구를 자연어 질의로 사용할 수 있습니다.

opendart-excel 생성 결과 예시

데모 영상

https://github.com/user-attachments/assets/6b5664fd-73cb-409c-adec-e23df6ed1198


Related MCP server: dart-mcp

준비물

  • Claude Code 또는 Codex CLI

  • Python 3.11+

  • uv / uvx (설치) — 없다면 pip install uv

  • OpenDART API KEY: OpenDART에서 KEY 발급


설치

플러그인을 설치하면 open-dart MCP 서버 설정과 opendart-excel 스킬이 함께 설치됩니다.

Claude Code

/plugin marketplace add gyeongmin100/Open-Dart-Plugin
/plugin install opendart@open-dart-plugin

설치 중 DART_API_KEY를 입력하라는 프롬프트가 뜹니다.

사용 예:

/opendart:opendart-excel 삼성전자 2023년 연결 재무제표를 엑셀로 만들어줘

Codex

codex plugin marketplace add gyeongmin100/Open-Dart-Plugin

Codex에서 /plugins를 열고 OpenDART MCP marketplace의 opendart 플러그인을 설치합니다. Codex 실행 환경에는 DART_API_KEY가 미리 설정되어 있어야 합니다.

export DART_API_KEY="your-api-key"      # bash/zsh
$env:DART_API_KEY="your-api-key"        # PowerShell

사용 예:

$opendart 삼성전자 2023년 연결 재무제표를 엑셀로 만들어줘

AI 에이전트용 설치 프롬프트

아래 블록을 그대로 복사해서 Claude Code나 Codex 채팅창에 붙여넣으면, 에이전트가 알아서 marketplace 등록 → 플러그인 설치 → API 키 설정까지 진행합니다.

OpenDART 플러그인을 설치해줘.

1. 저장소: https://github.com/gyeongmin100/Open-Dart-Plugin
2. Claude Code라면:
   - /plugin marketplace add gyeongmin100/Open-Dart-Plugin 실행
   - /plugin install opendart@open-dart-plugin 실행
   - 설치 중 DART_API_KEY를 물어보면, 아직 없다고 하면 https://opendart.fss.or.kr 에서
     API 키를 발급받는 방법을 안내해줘.
   Codex라면:
   - codex plugin marketplace add gyeongmin100/Open-Dart-Plugin 실행
   - /plugins 메뉴에서 "OpenDART MCP" marketplace의 opendart 플러그인 설치 안내
   - 실행 환경에 DART_API_KEY 환경변수가 필요하다는 것도 안내해줘.
3. 설치가 끝나면 opendart-excel 스킬로 "삼성전자 2023년 연결재무제표 엑셀로 만들어줘" 같은
   요청을 처리할 수 있다는 것을 확인해줘.
4. Python 3.11+ 와 uv/uvx가 없으면 먼저 설치 방법을 안내해줘 (pip install uv).

사용 예시

삼성전자 최근 공시 보여줘
카카오 2023년 재무제표 알려줘
현대자동차 최대주주 현황은?
LG전자 임원 현황 조회해줘
SK하이닉스 배당 이력 알려줘
2024년 합병 공시 목록 검색해줘
삼성전자 2023년 연결 재무제표를 엑셀로 만들어줘   ← opendart 플러그인

opendart-excel 스킬 동작 방식

  1. 회사명·사업연도·기간·범위(연결/별도)를 파악하고, 모호하면 반드시 사용자에게 확인합니다.

  2. get_corp_codes와 search_disclosures로 해당 기간 정기보고서의 rcept_no 1건을 찾습니다.

  3. list_financial_document_candidates가 공시 계열 전체의 ZIP XML을 먼저 검사하고, 빠진 첨부만 DART 내부 문서 목록으로 보완합니다. AI가 요청 기간·연결/별도에 맞는 candidate_id를 고릅니다.

  4. create_financial_workbook이 선택 문서만 받아 재무제표·주석을 파싱하고 Excel을 생성·검증합니다.

  5. 감사·검토보고서 첨부가 실제로 없으면 confirmation_required를 반환합니다. 사용자 승인 후 allow_body=true로 다시 호출할 때만 (본문) 후보를 쓰고 생성합니다.

정정 공시는 본문만 재제출하고 첨부는 원본 공시에 남습니다. 서버가 원본·정정·첨부정정·첨부추가 제출본의 ZIP을 모두 검사하므로 접수번호 1건이면 원본에 붙은 감사보고서까지 후보에 나옵니다. 후보의 rcept_no가 조회에 쓴 번호와 달라도 정상입니다.

공시 원문(XML/HTML)은 서버 메모리에서만 처리되어 AI에게 전달되지 않으며, 중간 파일도 남지 않습니다.

안전성:

  • allow_body=true 없이는 본문 후보를 반환하거나 생성하지 않습니다. 승인 후에도 ZIP 첫 파일이 아니라 사업보고서·반기보고서·분기보고서 제목의 본문을 선택합니다.

  • OpenDART HTTP 오류에는 상태 코드와 API 경로만 포함하며, httpx 로그의 crtfc_key는 ***로 가립니다.

  • 검증 실패·취소·최종 파일 이동 실패 시 서버가 만든 임시 파일과 빈 선점 파일을 정리합니다.


프로젝트 구조

Open-Dart-Plugin/
├── src/opendartmcp/              # MCP 서버 본체 (PyPI: opendart-mcp-server)
│   ├── server.py                  # MCP 서버 엔트리포인트 + CLI (config set-api-key 등)
│   ├── client.py                  # DartClient — OpenDART Open API 호출 래퍼
│   ├── config.py                  # API 키 저장/조회 (CLI 등록 vs 환경변수)
│   ├── errors.py                  # 안전한 DART API/HTTP 예외
│   ├── excel/                     # 재무제표 Excel 생성 (서버가 직접 수행)
│   │   ├── candidates.py          # ZIP + DART 화면 첨부 후보 조회/로딩
│   │   ├── dartdoc.py             # DART 원문 XML/HTML 파서
│   │   ├── build_financial_excel.py # 모델 → Excel 워크북 생성
│   │   ├── verify_workbook.py     # 생성된 Excel 자동 검증
│   │   └── workflow.py            # ZIP 1회 다운로드 → 문서 선택 → 파싱 → 생성 → 검증
│   └── tools/                     # MCP 도구 정의 — DS001~DS006 그룹별 파일
│       ├── disclosure.py          # DS001 공시정보 (검색/기업정보/원문/고유번호검색)
│       ├── business_report.py     # DS002 정기보고서 주요정보
│       ├── financial.py           # DS003 재무정보
│       ├── stock_holdings.py      # DS004 지분공시
│       ├── major_report.py        # DS005 주요사항보고서
│       ├── securities.py          # DS006 증권신고서
│       └── workbook.py            # 후보 조회 + Excel 생성 워크플로 도구
│
├── plugins/                       # Claude Code / Codex 플러그인 소스
│   └── {claude,codex}/opendart/   # 각 클라이언트용 플러그인 (공통 구성)
│       ├── .{claude,codex}-plugin/plugin.json # 플러그인 manifest
│       ├── .mcp.json              # 플러그인이 MCP 서버를 실행하는 설정
│       └── skills/opendart-excel/
│           └── SKILL.md           # 엑셀 생성 스킬 지침서 (에이전트가 읽고 따름)
│
├── .claude-plugin/marketplace.json    # Claude Code 마켓플레이스 정의
├── .agents/plugins/marketplace.json   # Codex 마켓플레이스 정의
├── .github/workflows/publish.yml      # GitHub Release 생성 시 PyPI 자동 배포
├── pyproject.toml                     # opendart-mcp-server 패키지 빌드 설정
└── sample.png                         # README 예시 이미지

변경사항: 재무제표 Excel 생성 코드는 플러그인의 skills/opendart-excel/scripts/(Claude·Codex 두 벌)에서 src/opendartmcp/excel/ 한 벌로 옮겨졌고, MCP 서버가 직접 실행합니다. 플러그인 쪽 스크립트와 requirements.txt, 의존성 자동 설치 헬퍼는 제거되었습니다. 기존 85개 OpenDART API 도구는 그대로 유지됩니다.

플러그인의 .mcp.json은 uvx --upgrade --from opendart-mcp-server opendartmcp로 최신 PyPI 배포본을 실행합니다. 현재 버전은 1.4.12입니다.


제공 도구

워크플로 도구 (2)

Tool

Description

list_financial_document_candidates

접수번호 1건으로 공시 계열 전체의 첨부·본문 제목 목록 반환 (원문 미반환)

create_financial_workbook

선택한 문서에서 검증된 재무제표 Excel 생성 (원문은 반환하지 않고 파일 경로만 반환)

OpenDART API 도구 (85개)

DS001 · 공시정보 (4)

Tool

Description

search_disclosures

공시 목록 검색

get_company_info

기업 기본정보 조회

get_disclosure_document

공시 원문 문서 조회

get_corp_codes

회사명/종목코드로 법인 고유번호(corp_code) 검색

DS002 · 정기보고서 주요정보 (30)

Tool

Description

get_capital_change_status

증자(감자) 현황

get_dividend_info

배당에 관한 사항

get_treasury_stock

자기주식 취득 및 처분 현황

get_largest_shareholder

최대주주 현황

get_largest_shareholder_changes

최대주주 변동현황

get_minority_shareholders

소액주주 현황

get_executives

임원 현황

get_employees

직원 현황

get_executive_compensation_total

이사·감사 전체의 보수현황

get_executive_compensation_gmtsck

이사·감사 전체 보수현황 (주총승인금액)

get_executive_compensation_type

이사·감사 전체 보수현황 (유형별)

get_executive_compensation_individual

이사·감사 개인별 보수현황 5억원 이상

get_individual_pay_over5

개인별 보수지급 금액 5억 이상 상위 5인

get_executive_compensation_individual_v2

이사·감사 개인별 보수현황 5억원 이상 (V2)

get_individual_pay_over5_v2

개인별 보수지급 금액 상위 5인 (V2)

get_unregistered_executives

미등기임원 보수현황

get_investment_in_other_corps

타법인 출자현황

get_audit_opinion

회계감사인 명칭 및 감사의견

get_audit_fee

감사용역체결현황

get_non_audit_service

비감사용역 계약체결 현황

get_outside_director_changes

사외이사 및 변동현황

get_stock_total_qty

주식의 총수 현황

get_bond_issuance

채무증권 발행실적

get_commercial_paper

기업어음증권 미상환 잔액

get_short_term_bond

단기사채 미상환 잔액

get_corp_bond_outstanding

회사채 미상환 잔액

get_hybrid_bond

신종자본증권 미상환 잔액

get_debt_securities_outstanding

조건부자본증권 미상환 잔액

get_public_offering_fund_usage

공모자금 사용내역

get_private_placement_fund_usage

사모자금 사용내역

DS003 · 재무정보 (7)

Tool

Description

get_single_company_account

단일 회사 주요 재무제표 계정 조회

get_multi_company_account

다중 회사 주요 재무제표 계정 조회

get_xbrl_financial

XBRL 재무제표 원본 조회

get_single_full_financial

단일 회사 전체 재무제표 조회

get_xbrl_taxonomy

XBRL 표준 재무제표 양식 조회

get_single_financial_index

단일 회사 주요 재무지표 조회

get_multi_financial_index

다중 회사 주요 재무지표 조회

DS004 · 지분공시 (2)

Tool

Description

get_large_holding_report

5% 이상 대량보유 현황

get_executive_stock_report

임원 및 주요주주 소유보고

DS005 · 주요사항보고서 (36)

Tool

Description

get_paid_capital_increase

유상증자 결정

get_free_capital_increase

무상증자 결정

get_paid_free_capital_increase

유무상증자 결정

get_capital_reduction

감자 결정

get_convertible_bond

전환사채권 발행결정

get_bond_with_warrants

신주인수권부사채권 발행결정

get_exchangeable_bond

교환사채권 발행결정

get_conditional_capital_issuance

상각형 조건부자본증권 발행결정

get_stock_acquisition

자기주식 취득 결정

get_stock_disposal

자기주식 처분 결정

get_treasury_stock_trust_conclude

자기주식취득 신탁계약 체결 결정

get_treasury_stock_trust_terminate

자기주식취득 신탁계약 해지 결정

get_merger_decision

회사합병 결정

get_division_decision

회사분할 결정

get_division_merger_decision

회사분할합병 결정

get_stock_exchange_decision

주식교환·이전 결정

get_business_acquisition

영업양수 결정

get_business_transfer

영업양도 결정

get_tangible_asset_acquisition

유형자산 양수 결정

get_tangible_asset_transfer

유형자산 양도 결정

get_equity_investment_acquisition

타법인 주식 및 출자증권 양수결정

get_equity_investment_transfer

타법인 주식 및 출자증권 양도결정

get_equity_securities_acquisition

주권 관련 사채권 양수 결정

get_equity_securities_transfer

주권 관련 사채권 양도 결정

get_other_asset_acquisition

자산양수도(기타), 풋백옵션

get_overseas_listing_decision

해외 증권시장 상장 결정

get_overseas_delisting_decision

해외 증권시장 상장폐지 결정

get_overseas_listing

해외 증권시장 상장

get_overseas_delisting

해외 증권시장 상장폐지

get_bankruptcy_report

부도발생

get_business_suspension_report

영업정지

get_rehabilitation_report

회생절차 개시신청

get_dissolution_report

해산사유 발생

get_creditor_management

채권은행 등의 관리절차 개시

get_creditor_management_suspension

채권은행 등의 관리절차 중단

get_lawsuit_report

소송 등의 제기

DS006 · 증권신고서 (6)

Tool

Description

get_equity_securities

지분증권 증권신고서

get_debt_securities

채무증권(회사채) 증권신고서

get_depositary_receipts

증권예탁증권(DR) 증권신고서

get_merger_securities

합병 관련 증권신고서

get_stock_exchange_securities

주식 포괄적 교환·이전 증권신고서

get_division_securities

분할 관련 증권신고서


주의사항

  • API 일일 호출 한도: 10,000건 (초과 시 오류 발생)

  • opendart-excel 스킬은 검증에 실패한 Excel 파일은 전달하지 않습니다.

Available Tools

87 tools
create_financial_workbookA

선택한 문서에서 검증된 재무제표 Excel을 만들어 경로만 반환합니다.

서버가 그 문서만 내려받아 파싱·Excel 생성·검증까지 수행합니다. 공시 원문은 반환하지 않습니다.

Args: candidate_id: list_financial_document_candidates가 준 값 그대로. 직접 만들지 마세요. scope: consolidated(연결) 또는 separate(별도) output_dir: 최종 Excel을 저장할 기존 디렉터리 (쓰기 가능해야 함) output_name: 최종 파일명(.xlsx). 예: 회사명_2024_연결재무제표.xlsx allow_body: 감사·검토보고서가 없음을 사용자에게 알리고 승인을 받은 경우에만 true. 기본 false에서는 본문 생성을 거부합니다.

Inputs: scope (required), output_dir (required), output_name (required), candidate_id (required), +1 more.

get_audit_feeA

감사보수 현황 (감사용역 체결현황)을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_audit_opinionB

회계감사인의 명칭 및 감사의견을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_bankruptcy_reportA

부도발생 - 주요사항보고서 내 부도발생 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_bond_issuanceA

회사채 발행 및 상환 실적 (채무증권 발행실적)을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_bond_with_warrantsC

신주인수권부사채권 발행결정 - 주요사항보고서 내 신주인수권부사채권 발행결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_business_acquisitionB

영업양수 결정 - 주요사항보고서 내 영업양수 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_business_suspension_reportB

영업정지 - 주요사항보고서 내 영업정지 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_business_transferB

영업양도 결정 - 주요사항보고서 내 영업양도 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_capital_change_statusC

증자(감자) 현황 - 주식 증자 및 감자 이력을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_capital_reductionB

감자 결정 - 주요사항보고서 내 감자 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_commercial_paperA

기업어음증권 미상환 잔액을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_company_infoA

기업의 기본 정보를 조회합니다 (회사명, 대표자, 사업자번호, 주소 등).

Args: corp_code: DART 기업 고유번호 (8자리, 필수)

Inputs: corp_code (required).

get_conditional_capital_issuanceC

상각형 조건부자본증권 발행결정 - 주요사항보고서 내 상각형 조건부자본증권 발행결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_convertible_bondB

전환사채권 발행결정 - 주요사항보고서 내 전환사채권 발행결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_corp_bond_outstandingA

회사채 미상환 잔액을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_corp_codesA

기업명 또는 종목코드로 DART 고유번호(corp_code)를 검색합니다.

DART 오픈API는 회사명 검색을 지원하지 않으므로, 전체 고유번호 목록을 내려받아 서버에서 필터링합니다. corp_name 또는 stock_code 중 최소 하나를 지정해야 합니다 — 둘 다 생략하면 검색하지 않습니다(전체 목록은 11만 건 이상이라 반환하지 않습니다).

Args: corp_name: 회사명 부분일치 (한글 또는 영문, 대소문자 무시) stock_code: 상장사 종목코드 6자리 (예: "000660") 정확히 일치

Inputs: corp_name, stock_code.

get_creditor_managementB

채권은행 등의 관리절차 개시 - 주요사항보고서 내 채권은행 관리절차 개시 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_creditor_management_suspensionB

채권은행 등의 관리절차 중단 - 주요사항보고서 내 채권은행 관리절차 중단 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_debt_securitiesC

채무증권(회사채 등) 증권신고서 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리, 필수) bgn_de: 시작일 (YYYYMMDD) end_de: 종료일 (YYYYMMDD)

Inputs: corp_code (required), bgn_de, end_de.

get_debt_securities_outstandingB

조건부 자본증권 미상환 잔액을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_depositary_receiptsB

증권예탁증권(DR) 증권신고서 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리, 필수) bgn_de: 시작일 (YYYYMMDD) end_de: 종료일 (YYYYMMDD)

Inputs: corp_code (required), bgn_de, end_de.

get_disclosure_documentA

공시서류의 원문을 조회합니다. 접수번호로 특정 공시 문서를 가져옵니다.

하나의 공시에는 본문 외에 첨부 문서(감사보고서, 연결감사보고서 등)가 포함될 수 있습니다. doc_name 없이 호출하면 본문을 반환하며, 결과의 documents 목록에서 첨부 파일명과 제목을 확인한 뒤 doc_name으로 특정 첨부를 다시 요청할 수 있습니다.

Args: rcept_no: 접수번호 (14자리, 필수) doc_name: 가져올 문서 파일명 (선택, documents의 filename 값. 생략 시 본문)

Inputs: rcept_no (required), doc_name.

get_dissolution_reportB

해산사유 발생 - 주요사항보고서 내 해산사유 발생 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_dividend_infoB

배당에 관한 사항 - 현금배당 및 주식배당 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_division_decisionC

회사분할 결정 - 주요사항보고서 내 회사분할 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_division_merger_decisionB

회사분할합병 결정 - 주요사항보고서 내 회사분할합병 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_division_securitiesB

분할 관련 증권신고서 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리, 필수) bgn_de: 시작일 (YYYYMMDD) end_de: 종료일 (YYYYMMDD)

Inputs: corp_code (required), bgn_de, end_de.

get_employeesB

직원 현황 - 직원 수, 평균 연봉 등을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_equity_investment_acquisitionB

타법인 주식 및 출자증권 양수결정 - 주요사항보고서 내 타법인 주식 및 출자증권 양수 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_equity_investment_transferB

타법인 주식 및 출자증권 양도결정 - 주요사항보고서 내 타법인 주식 및 출자증권 양도 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_equity_securitiesA

지분증권 증권신고서 주요 정보를 조회합니다. 주식 발행 및 공모 관련 정보를 포함합니다.

Args: corp_code: DART 기업 고유번호 (8자리, 필수) bgn_de: 시작일 (YYYYMMDD) end_de: 종료일 (YYYYMMDD)

Inputs: corp_code (required), bgn_de, end_de.

get_equity_securities_acquisitionB

주권 관련 사채권 양수 결정 - 주요사항보고서 내 주권 관련 사채권 양수 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_equity_securities_transferB

주권 관련 사채권 양도 결정 - 주요사항보고서 내 주권 관련 사채권 양도 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_exchangeable_bondC

교환사채권 발행결정 - 주요사항보고서 내 교환사채권 발행결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_executive_compensation_gmtsckA

이사·감사 전체 보수현황 (주총승인금액)을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_executive_compensation_individualC

이사·감사 개인별 보수현황 5억원 이상을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_executive_compensation_individual_v2B

이사·감사 개인별 보수현황 Ver 2.0 - 5억원 이상 이사·감사 개인별 보수현황을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_executive_compensation_totalA

이사·감사 전체의 보수현황을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_executive_compensation_typeB

이사·감사 전체 보수현황 (유형별)을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_executivesB

임원 현황 - 등기임원 명단 및 보수를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_executive_stock_reportB

임원 및 주요주주 소유 보고서를 조회합니다. 내부자(임원, 주요주주)의 주식 소유 현황을 확인할 수 있습니다.

Args: corp_code: DART 기업 고유번호 (8자리, 필수)

Inputs: corp_code (required).

get_free_capital_increaseB

무상증자 결정 - 주요사항보고서 내 무상증자 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_hybrid_bondB

신종자본증권 미상환 잔액을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_individual_pay_over5A

개인별 보수지급 금액 5억 이상 상위 5인을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_individual_pay_over5_v2A

개인별 보수지급 금액 V2 (최신 버전) - 5억 이상 상위 5인 보수지급 금액을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_investment_in_other_corpsA

타법인 출자 현황을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_large_holding_reportA

주식 대량보유 상황보고서를 조회합니다. 5% 이상 주식을 보유한 주요 주주의 보유 현황을 확인할 수 있습니다.

Args: corp_code: DART 기업 고유번호 (8자리, 필수)

Inputs: corp_code (required).

get_largest_shareholderB

최대주주 현황 - 최대주주 지분율 및 변동을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_largest_shareholder_changesB

최대주주 변동현황을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_lawsuit_reportB

소송 등의 제기·판결 - 주요사항보고서 내 소송 등의 제기 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_merger_decisionA

합병 결정 - 주요사항보고서 내 회사합병 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_merger_securitiesC

합병 관련 증권신고서 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리, 필수) bgn_de: 시작일 (YYYYMMDD) end_de: 종료일 (YYYYMMDD)

Inputs: corp_code (required), bgn_de, end_de.

get_minority_shareholdersB

소액주주 현황을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_multi_company_accountB

여러 회사의 주요 재무 계정을 한 번에 조회합니다.

Args: corp_code: 쉼표로 구분한 복수 기업 고유번호 (최대 100개, 예: "00126380,00164742") bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11013"=1분기, "11012"=반기, "11014"=3분기, "11011"=사업보고서)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_multi_financial_indexA

여러 회사의 주요 재무 지표를 한 번에 조회합니다.

Args: corp_code: 쉼표로 구분한 복수 기업 고유번호 (최대 100개, 예: "00126380,00164742") bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11013"=1분기, "11012"=반기, "11014"=3분기, "11011"=사업보고서) idx_cl_code: 지표 분류 코드 ("M210000"=수익성지표, "M220000"=안정성지표, "M230000"=성장성지표, "M240000"=활동성지표)

Inputs: bsns_year (required), corp_code (required), reprt_code (required), idx_cl_code (required).

get_non_audit_serviceA

비감사용역 현황 (회계감사인과의 비감사용역 계약체결 현황)을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_other_asset_acquisitionA

자산양수도(기타), 풋백옵션 - 주요사항보고서 내 자산양수도(기타) 및 풋백옵션 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_outside_director_changesA

사외이사 및 변동현황을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_overseas_delistingB

해외 증권시장 주권등 상장폐지 - 주요사항보고서 내 해외 증권시장 주권등 상장폐지 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_overseas_delisting_decisionB

해외 증권시장 주권 상장폐지 결정 - 주요사항보고서 내 해외 증권시장 주권등 상장폐지 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_overseas_listingB

해외 증권시장 주권등 상장 - 주요사항보고서 내 해외 증권시장 주권등 상장 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_overseas_listing_decisionA

해외 증권시장 주권 신규상장 결정 - 주요사항보고서 내 해외 증권시장 주권등 상장 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_paid_capital_increaseB

유상증자 결정 - 주요사항보고서 내 유상증자 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_paid_free_capital_increaseB

유무상증자 결정 - 주요사항보고서 내 유무상증자 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_private_placement_fund_usageA

사모자금 사용내역을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_public_offering_fund_usageB

공모자금 사용내역을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_rehabilitation_reportB

회생절차 개시신청 - 주요사항보고서 내 회생절차 개시신청 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_short_term_bondA

단기사채 미상환 잔액을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_single_company_accountA

단일 회사의 주요 재무제표 계정을 조회합니다 (자산총계, 부채총계, 자본총계, 매출액, 영업이익, 당기순이익 등).

Args: corp_code: DART 기업 고유번호 8자리 (get_corp_codes 툴로 조회) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11013"=1분기, "11012"=반기, "11014"=3분기, "11011"=사업보고서)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_single_financial_indexB

단일 회사의 주요 재무 지표를 조회합니다 (수익성, 안정성, 성장성, 활동성 지표).

Args: corp_code: DART 기업 고유번호 8자리 (get_corp_codes 툴로 조회) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11013"=1분기, "11012"=반기, "11014"=3분기, "11011"=사업보고서) idx_cl_code: 지표 분류 코드 ("M210000"=수익성지표, "M220000"=안정성지표, "M230000"=성장성지표, "M240000"=활동성지표)

Inputs: bsns_year (required), corp_code (required), reprt_code (required), idx_cl_code (required).

get_single_full_financialA

단일 회사의 전체 재무제표를 조회합니다 (모든 계정 포함).

Args: corp_code: DART 기업 고유번호 8자리 (get_corp_codes 툴로 조회) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11013"=1분기, "11012"=반기, "11014"=3분기, "11011"=사업보고서) fs_div: 재무제표 구분 ("OFS"=별도, "CFS"=연결)

Inputs: fs_div (required), bsns_year (required), corp_code (required), reprt_code (required).

get_stock_acquisitionA

자기주식 취득결정 - 주요사항보고서 내 자기주식 취득 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_stock_disposalB

자기주식 처분결정 - 주요사항보고서 내 자기주식 처분 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_stock_exchange_decisionB

주식교환·이전 결정 - 주요사항보고서 내 주식교환·이전 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_stock_exchange_securitiesB

주식의 포괄적 교환·이전 증권신고서 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리, 필수) bgn_de: 시작일 (YYYYMMDD) end_de: 종료일 (YYYYMMDD)

Inputs: corp_code (required), bgn_de, end_de.

get_stock_total_qtyA

주식의 총수 현황을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_tangible_asset_acquisitionB

유형자산 양수 결정 - 주요사항보고서 내 유형자산 양수 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_tangible_asset_transferB

유형자산 양도 결정 - 주요사항보고서 내 유형자산 양도 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_treasury_stockA

자기주식 취득 및 처분 현황을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_treasury_stock_trust_concludeA

자기주식취득 신탁계약 체결 결정 - 주요사항보고서 내 자기주식취득 신탁계약 체결 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_treasury_stock_trust_terminateA

자기주식취득 신탁계약 해지 결정 - 주요사항보고서 내 자기주식취득 신탁계약 해지 결정 주요 정보를 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD, 선택) end_de: 종료일 (YYYYMMDD, 선택)

Inputs: corp_code (required), bgn_de, end_de.

get_unregistered_executivesA

미등기임원 보수 현황을 조회합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bsns_year: 사업연도 (YYYY, 예: "2023") reprt_code: 보고서 코드 ("11011"=사업보고서, "11012"=반기, "11013"=1분기, "11014"=3분기)

Inputs: bsns_year (required), corp_code (required), reprt_code (required).

get_xbrl_financialA

XBRL 형식의 재무제표 원본을 조회합니다 (ZIP → XML → dict 변환).

Args: rcept_no: 접수번호 14자리 (필수) reprt_code: 보고서 코드 ("11013"=1분기, "11012"=반기, "11014"=3분기, "11011"=사업보고서)

Inputs: rcept_no (required), reprt_code (required).

get_xbrl_taxonomyB

XBRL 표준 재무제표 양식(택사노미)을 조회합니다.

Args: sj_div: 재무제표 구분 코드. 재무상태표="BS1""BS4", 손익계산서="IS1""IS4", 포괄손익계산서="CIS1""CIS4", 단일포괄손익계산서="DCIS1""DCIS8", 현금흐름표="CF1""CF4", 자본변동표="SCE1""SCE2" (숫자 접미사는 연결/개별 및 분류방식 조합)

Inputs: sj_div (required).

list_financial_document_candidatesA

공시 계열(원본·정정·추가) 전체의 문서를 후보로 반환합니다.

정정 공시는 본문만 재제출하고 첨부는 원본 제출본에 남으므로, 같은 보고서의 제출본을 모두 훑습니다. 정정 번호 하나만 넘겨도 원본에 붙은 감사·검토보고서가 나옵니다. 후보의 rcept_no는 넘긴 값과 다를 수 있으며 그것이 정상입니다.

AI는 반환된 날짜·제목만 보고 candidate_id 하나를 골라 create_financial_workbook에 그대로 전달합니다. 원문은 반환하지 않습니다.

Args: rcept_no: 접수번호 14자리. search_disclosures 결과 값을 그대로 전달. corp_code: 고유번호 8자리. search_disclosures가 함께 주므로 있으면 반드시 전달하세요 — 없으면 접수일자 전체를 훑어 느립니다. allow_body: confirmation_required를 사용자에게 보여주고 본문 사용 승인을 받은 뒤에만 true. 기본 false에서는 본문을 숨깁니다.

Inputs: rcept_no (required), corp_code, allow_body.

search_disclosuresB

공시 목록을 검색합니다. 기업, 날짜, 공시 유형 등으로 필터링 가능합니다.

Args: corp_code: DART 기업 고유번호 (8자리) bgn_de: 시작일 (YYYYMMDD) end_de: 종료일 (YYYYMMDD) last_reprt_at: 최종보고서 여부 (Y/N) pblntf_ty: 공시 유형 코드 (A:정기, B:주요, C:발행, D:지분, E:기타) pblntf_detail_ty: 공시 상세 유형 corp_cls: 법인 구분 (Y:유가, K:코스닥, N:코넥스, E:기타) sort: 정렬 기준 (date/crp/rpt) sort_mth: 정렬 방법 (asc/desc) page_no: 페이지 번호 page_count: 페이지당 건수 (최대 100)

Inputs: sort, bgn_de, end_de, page_no, +7 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 87 tools

    Disambiguation2/5

    While most tools target distinct DART endpoints, several are nearly indistinguishable in practice, such as get_executive_compensation_individual vs get_executive_compensation_individual_v2 and get_individual_pay_over5 vs get_individual_pay_over5_v2, which have identical descriptions. Overlapping debt and treasury stock tool families also blur boundaries, making misselection likely.

    Naming Consistency4/5

    The overwhelming majority follow a consistent get_<subject> pattern, which is predictable across the large surface. Minor breaks like search_disclosures, list_financial_document_candidates, create_financial_workbook, and the arbitrary _v2 suffix prevent a perfect score.

    Tool Count1/5

    87 tools is an extreme count for an MCP server, far beyond the 50+ threshold and likely to overwhelm agent context windows. Even if each endpoint is individually valid, the sheer size makes the toolset difficult to navigate and prune.

    Completeness4/5

    The toolset covers a broad and deep slice of DART's disclosure API: regular reports, major disclosures, securities filings, XBRL financials, audit data, shareholder info, and financial workbook generation. Minor gaps exist (e.g., no dedicated tool for certain niche disclosure types), but core workflows are well supported.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP Server for public disclosure information of Korean companies, powered by the dartpoint.ai API.
      3
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for Korea's DART (Data Analysis, Retrieval and Transfer) electronic disclosure system, operated by the Financial Supervisory Service (FSS). Exposes company disclosures, company profiles, and financial statements via the OpenDART public API.
      3
      9 npm
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Exposes OPEN DART (Korean FSS electronic disclosure) as an MCP server for searching and retrieving original disclosure documents, shareholdings, and financial statements, primarily for legal and internal control review.
      7
      -
    • A
      license
      A
      quality
      D
      maintenance
      Provides Korean stock market data, including DART electronic disclosures and KRX trading information, enabling users to query company profiles, financial statements, and stock trade details via MCP clients.
      9
      MIT