OpenDART CLI

한국 금융감독원 DART OpenAPI를 터미널에서 조회 및 검색하고, 기업 정보와 재무제표 등을 JSON으로 출력하는 CLI 도구입니다.

Security Scan

The skill's code, instructions, and requested environment variables are consistent with an unofficial DART OpenAPI CLI and only require the DART API key and an optional cache dir as expected.

Purpose & Capability

The name/description match the implementation: commands for corp-code, find-corp, list, company, finance, majorstock, elestock, and document are implemented. The only required credential is OPENDART_API_KEY, which is appropriate for the stated purpose. No unrelated services or binaries are requested.

Instruction Scope

SKILL.md instructions map directly to the CLI behavior. Runtime instructions only direct the agent to use the DART API via HTTPS, manage a local cache (~/.opendart-cli by default), and save downloaded documents to user-specified paths. There are no instructions to read unrelated system files, use other environment secrets, or post data to non-DART endpoints.

Install Mechanism

The registry lists no install spec (instruction-only), but the package includes full Python sources and a pyproject with install instructions (pipx / pip / GitHub). This is a minor inconsistency: the SKILL.md and pyproject point to a GitHub repo, while registry metadata shows source/homepage as unknown/none. The provided install channels (pipx/pip) and dependency (requests) are reasonable for a CLI Python package.

Credentials

Only OPENDART_API_KEY is required (declared as primaryEnv). An optional OPENDART_CACHE_DIR is supported and documented. The code accesses only these environment variables and does not request other secrets or unrelated credentials.

Persistence & Privilege

always is false and the skill does not request persistent platform-wide privileges. It creates a cache directory under the user's home and writes corp_codes.json and any downloaded ZIPs to user-specified locations, which is consistent with its functionality.

Assessment

This skill appears to be what it says: an unofficial OpenDART CLI that needs only your DART API key and stores a local cache. Before installing, verify the package source (the pyproject and SKILL.md reference a GitHub repo: https://github.com/ChloePark85/opendart-cli) and prefer installing from a trusted registry or the referenced GitHub to avoid typosquatting. Keep your OPENDART_API_KEY secret and only provide it via the environment variable as documented. Note the tool will create ~/.opendart-cli (or OPENDART_CACHE_DIR) and may save downloaded ZIPs to paths you specify; if you are concerned, run it in an isolated environment or inspect the repository on GitHub first.

금융감독원 전자공시시스템(DART)의 공개 OpenAPI를 터미널에서 사용하기 위한 경량 Python CLI이다. 한국 상장·비상장 법인의 공시 이력, 기업 개황, 재무제표, 대주주·임원 지분 현황을 JSON으로 반환한다. 에이전트 파이프라인에 붙이기 쉽게 표준 출력(JSON)을 기본으로 하며, 한국어 오류 메시지와 캐시를 제공한다.

주요 기능 (v0.1.0)

• corp-code: 고유번호 XML 다운로드·파싱·캐시 (~/.opendart-cli/corp_codes.json)
• find-corp: 회사명 또는 종목코드로 corp_code 검색
• list: 공시 검색 (bgn_de, end_de, pblntf_ty, corp_cls 등 필터)
• company: 기업 개황
• finance: 주요계정(fnlttSinglAcnt) 또는 전체재무제표(fnlttSinglAcntAll) 조회
• majorstock: 대량보유자 현황
• elestock: 임원 지분 현황
• document: 공시서류 원본(ZIP) 저장

설치

pipx install opendart-cli      # 권장
# 또는
uv tool install opendart-cli
# 또는 (파이썬 3.9+)
pip install opendart-cli

개발 모드:

git clone https://github.com/ChloePark85/opendart-cli
cd opendart-cli
pipx install -e .

환경 변수

• OPENDART_API_KEY (필수): opendart.fss.or.kr 에서 발급받은 40자 인증키
• OPENDART_CACHE_DIR (선택): 캐시 디렉토리. 기본 ~/.opendart-cli

빠른 사용 예시

# 1) API 키 발급 후 환경 변수 설정
export OPENDART_API_KEY="your_40_char_key"

# 2) 전체 고유번호 다운로드 및 캐시
opendart corp-code --refresh

# 3) 회사명으로 검색 (삼성전자 -> 00126380)
opendart find-corp "삼성전자"

# 4) 최근 30일 정기공시 목록
opendart list --corp-code 00126380 --pblntf-ty A --bgn 20260320 --end 20260420

# 5) 기업 개황
opendart company --corp-code 00126380

# 6) 단일회사 주요계정 (2025 사업연도 사업보고서)
opendart finance --corp-code 00126380 --bsns-year 2025 --reprt-code 11011

# 7) 전체 재무제표
opendart finance --corp-code 00126380 --bsns-year 2025 --reprt-code 11011 --all

# 8) 대주주/임원 지분
opendart majorstock --corp-code 00126380
opendart elestock  --corp-code 00126380

# 9) 공시서류 원본 ZIP 다운로드
opendart document --rcept-no 20260320000123 --out ./disclosure.zip

보고서 코드 참고 (--reprt-code)

• 11011 사업보고서 (연간)
• 11012 반기보고서
• 11013 1분기 보고서
• 11014 3분기 보고서

공시 유형 코드 (--pblntf-ty)

A 정기공시, B 주요사항보고, C 발행공시, D 지분공시, E 기타공시, F 외부감사관련, G 펀드공시, H 자산유동화, I 거래소공시, J 공정위공시.

보안

• 인증키는 환경 변수만 사용. CLI 인자/로그에 기록되지 않도록 처리.
• 응답은 HTTPS. 캐시는 사용자 홈 디렉토리 권한으로만 저장.

라이선스 & 출처

MIT 라이선스. 데이터는 금융감독원 전자공시시스템(DART)의 공식 OpenAPI 응답을 그대로 전달하며, 본 스킬은 DART의 비공식 클라이언트이다.

링크

• GitHub: https://github.com/ChloePark85/opendart-cli
• OpenDART: https://opendart.fss.or.kr