opendart-disclosure

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_de in YYYYMMDD
• Filing type filters (optional): regular report (A), major issue (B), shares (C), etc.
• Desired output: latest N items, only links, or short summary

Workflow

1. Resolve company identity.
   • If user gave corp_code, use it directly.
   • If user gave company name, run the script search-corp first.
2. Pull disclosures with recent.
3. Sort by latest and keep user-requested count.
4. Return:
   • filing date
   • report name
   • receipt number
   • OpenDART link (https://dart.fss.or.kr/dsaf001/main.do?rcpNo=<rcept_no>)
5. 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 "삼성전자" --today

API key options:

• --api-key <KEY>
• or env var OPENDART_API_KEY

Notes

• OpenDART returns status codes in JSON. Treat non-000 as 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.