- name
- opendart-disclosure
- description
- Read Korea OpenDART disclosures using the OpenDART API. Use when the user asks for DART 공시 조회, recent filings by company, filtering by filing type/date, or quick summaries with source links. Supports company name/corp_code lookup and structured result extraction.
OpenDART Disclosure
Fetch and summarize Korean corporate disclosures from OpenDART.
Inputs to collect
- Company identifier:
corp_code(preferred) or company name - Date range:
bgn_de/end_deinYYYYMMDD - Filing type filters (optional): regular report (
A), major issue (B), shares (C), etc. - Desired output: latest N items, only links, or short summary
Workflow
- Resolve company identity.
- If user gave corp_code, use it directly. - If user gave company name, run the script search-corp first.
- Pull disclosures with
recent. - Sort by latest and keep user-requested count.
- Return:
- filing date - report name - receipt number - OpenDART link (https://dart.fss.or.kr/dsaf001/main.do?rcpNo=<rcept_no>)
- If asked, add a concise Korean summary of key points.
Commands
Use bundled script:
python3 scripts/opendart.py search-corp --name "삼성전자"
python3 scripts/opendart.py recent --corp-code 00126380 --from 20260101 --to 20261231 --limit 10
python3 scripts/opendart.py recent-by-name --name "삼성전자" --from 20260101 --to 20261231 --limit 10
# Shortcuts (less typing)
python3 scripts/opendart.py recent-by-name --name "삼성전자" --days 7 --limit 10
python3 scripts/opendart.py recent-by-name --name "삼성전자" --todayAPI key options:
--api-key <KEY>- or env var
OPENDART_API_KEY
Notes
- OpenDART returns status codes in JSON. Treat non-
000as API-level failure and report clearly. - Company-name matching can be fuzzy. Show top candidates if multiple are close.
- Prefer citing the direct DART filing URL in final answers.
- For endpoint details and corp-code behavior, read
references/opendart-endpoints.md.