OpenDART Disclosure

核心功能

OpenDART Disclosure 是一款面向韩国资本市场的公开信息披露查询工具，通过对接韩国金融监督院（FSS）运营的 OpenDART API，实现企业公告的高效检索与结构化提取。

主要用法

1. 企业识别：支持通过 corp_code 精确查询，或通过公司名称模糊匹配获取代码
2. 披露检索：按日期范围（YYYYMMDD 格式）筛选最新公告，支持近 N 天/今日等快捷参数
3. 分类过滤：可选按报告类型筛选，包括定期报告（A）、重大事项（B）、股份相关（C）等
4. 输出格式：返回申报日期、报告名称、接收编号及官方 DART 直达链接

显著优点

• 监管级权威性：数据直接源自韩国金融监督院官方披露系统，法律效力充分
• 结构化输出：自动解析 API 响应，生成包含官方链接的标准化结果
• 灵活查询：同时支持代码精确查询与名称模糊匹配，降低使用门槛
• 韩文原生：针对韩国资本市场设计，支持韩语报告摘要生成

潜在局限

• 地域限制：仅覆盖韩国 KOSPI/KOSDAQ 上市企业，不支持其他司法管辖区
• API 依赖：需有效 API 密钥（OPENDART_API_KEY 环境变量或参数传入），存在服务可用性依赖
• 非实时性：披露文件存在申报延迟，非即时市场数据
• 语言壁垒：原始文档为韩文，非韩语用户理解存在障碍

适合人群

• 韩国股市投资者与研究机构
• 跨境合规与审计专业人员
• 需要追踪特定企业公告的财务分析师
• 自动化财报监控系统的开发者

常规风险提示

• API 配额：高频调用可能触发速率限制，建议实施请求节流
• 数据完整性：非 000 状态码需按 API 失败处理，应设计容错重试机制
• 代码变更：企业 corp_code 可能因合并重组变更，需定期校验
• 链接时效：历史披露链接长期有效，但新公告存在索引延迟

核心用法

OpenDART Disclosure Skill 是一款专为韩国资本市场设计的金融信息披露查询工具。用户可通过公司名称或企业代码（corp_code）检索目标上市公司的公开披露文件，支持按日期范围、报告类型进行精准筛选。

该 Skill 提供三种主要查询模式：

• search-corp：通过公司名称模糊匹配获取企业代码
• recent：使用企业代码查询特定期限内的披露记录
• recent-by-name：直接通过公司名称一键查询最近披露，支持快捷参数如 --days 7 或 --today

返回结果包含披露日期、报告名称、接收编号及可直接访问的 DART 官方链接，并可按需生成韩文要点摘要。

显著优点

官方数据源保障权威性：直接对接韩国金融监督院（FSS）OpenDART 官方 API，数据实时、准确、具有法律效力，杜绝第三方信息篡改风险。

零依赖轻量化设计：纯 Python 标准库实现，无第三方包依赖，部署简单，兼容性强，维护成本低。

安全合规的密钥管理：支持通过 OPENDART_API_KEY 环境变量配置 API 密钥，避免敏感信息硬编码或日志泄露，符合企业安全规范。

灵活的查询体验：同时支持企业代码精确查询和公司名称模糊匹配，满足不同场景需求；快捷参数设计大幅提升常用查询效率。

透明的可追溯性：每条记录均附带原始 DART 链接，便于用户核验原文、留存审计证据。

潜在缺点与局限性

地域与语言限制：仅覆盖韩国 KOSPI/KOSDAQ 上市公司，数据为韩文原始披露，非韩国市场用户或不懂韩文者使用受限。

缓存时效性问题：本地企业代码缓存默认不自动刷新，若遇公司更名、退市或新上市情况，可能导致查询结果不准确。

API 配额与稳定性：依赖 FSS 官方服务，存在速率限制和偶发服务中断风险，无内置重试退避机制时可能影响用户体验。

功能单一性：专注信息检索与链接生成，不提供财务数据分析、趋势图表或多公司对比等深度功能，需配合其他工具使用。

命令行交互门槛：当前主要面向具备基础技术能力的用户，非技术背景的金融从业者可能需要学习成本。

适合的目标群体

• 投资分析师与基金经理：需要快速获取持仓标的公司最新公告、重大事件披露
• 合规与风控人员：进行上市公司持续监控、内幕信息管理、定期合规检查
• 学术研究人员：开展韩国资本市场实证研究，需要批量获取结构化披露数据
• 跨国企业法务团队：监控合作伙伴或竞争对手的韩国子公司经营状况
• 金融科技开发者：作为数据管道组件，集成至内部投研系统或监控平台

使用风险说明

API 密钥安全风险：虽然支持环境变量配置，但 --api-key 命令行参数选项仍存在多用户系统下的进程泄露隐患，建议团队制定统一的安全配置规范。

数据依赖与合规：Skill 仅提供信息聚合与链接服务，不构成投资建议；用户需自行承担基于披露信息的投资决策责任，并遵守韩国《资本市场法》及相关信息披露法规。

缓存数据准确性：建议定期手动刷新或监控缓存时效，关键决策前务必点击原始链接核验最新披露状态。

网络与服务可用性：生产环境部署时建议添加 API 调用监控和熔断机制，避免因官方服务异常导致业务中断。