opendart-disclosure

使用 OpenDART API 阅读韩国 OpenDART 披露信息。当用户请求 DART 공시 조회、公司最近提交的文件、按提交类型/日期过滤或带有源链接的快速摘要时使用。支持公司名称/公司代码查找和结构化结果提取。

# 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:

```bash
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`.

---

## 中文说明

# OpenDART Disclosure

从 OpenDART 获取并汇总韩国企业披露信息。

## 需收集的输入

- 公司标识符：`corp_code`（首选）或公司名称
- 日期范围：`bgn_de` / `end_de`，格式为 `YYYYMMDD`
- 提交类型过滤器（可选）：定期报告（`A`）、重大事项（`B`）、股份（`C`）等
- 期望输出：最新 N 条、仅链接或简短摘要

## 工作流

1. 解析公司身份。
   - 如果用户提供了 `corp_code`，直接使用。
   - 如果用户提供了公司名称，先运行脚本 `search-corp`。
2. 使用 `recent` 拉取披露信息。
3. 按最新排序并保留用户请求的数量。
4. 返回：
   - 提交日期
   - 报告名称
   - 接收编号
   - OpenDART 链接（`https://dart.fss.or.kr/dsaf001/main.do?rcpNo=<rcept_no>`）
5. 如有要求，添加关键要点的简明韩文摘要。

## 命令

使用捆绑脚本：

```bash
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 密钥选项：

- `--api-key <KEY>`
- 或环境变量 `OPENDART_API_KEY`

## 注意事项

- OpenDART 在 JSON 中返回状态码。将非 `000` 视为 API 级别的失败并明确报告。
- 公司名称匹配可能是模糊的。如果有多个结果接近，显示排名靠前的候选项。
- 在最终答案中优先引用直接的 DART 提交 URL。
- 有关端点详情和 corp-code 行为，请阅读 `references/opendart-endpoints.md`。