k-dart — 금감원 DART 전자공시 조회

このスキルでできること

API_K_DART 環境変数に含まれた認証キーで DART OpenAPI(https://opendart.fss.or.kr/api/)を直接呼び出し、公示・財務・主要事項情報を照会します。プロキシを経由しません。

使用すべき場合

• 「サムスン電子の最近の公示を見せて」
• 「カカオの企業概要を教えて」
• 「LGエネルギーソリューション 2024年度 年間財務諸表」
• 「ネイバーの配当状況」
• 「ハイブ 転換社債発行履歴」
• 「セルトリオン 訴訟状況」
• 「SKハイニックス 監査意見」
• 「現代自動車 増資/減資履歴」
• 「サムスンバイオロジクス 自社株式取得/処分」

使用すべきでない場合

• リアルタイム株価/気配値/約定照会 → korean-stock-search スキル
• 海外企業の公示
• 投資アドバイス/買い推奨

前提条件

API_K_DART 環境変数が設定されている必要があります。キー発行: https://opendart.fss.or.kr/uss/umt/EgovMberInsertView.do

corp_code 確保手順

DART API のほとんどは corp_code(8桁の固有番号)を要求します。ユーザーが銘柄名または銘柄コード(6桁)だけを提供した場合:

1. 固有番号全体リスト(corpCode.xml)をダウンロードして、会社名または銘柄コードで corp_code を照会します:

macOS / Linux (bash):

# ZIP ダウンロード → 解凍 (既にあれば省略)
[ -f /tmp/dart_corp/CORPCODE.xml ] || {
  curl -fsS -o /tmp/dart_corp.zip \
    "https://opendart.fss.or.kr/api/corpCode.xml?crtfc_key=$API_K_DART"
  mkdir -p /tmp/dart_corp && unzip -o /tmp/dart_corp.zip -d /tmp/dart_corp
}

# 会社名または銘柄コードで corp_code を検索 (上場企業のみ)
grep -B2 -A3 '삼성전자' /tmp/dart_corp/CORPCODE.xml | awk '
/<corp_code>/{code=$0; gsub(/.*<corp_code>|<\/corp_code>.*/,"",code)}
/<corp_name>/{name=$0; gsub(/.*<corp_name>|<\/corp_name>.*/,"",name)}
/<stock_code>[0-9]/{stock=$0; gsub(/.*<stock_code>|<\/stock_code>.*/,"",stock); print code, stock, name}
'
# 出力: 00126380 005930 삼성전자

Windows (PowerShell):

# ZIP ダウンロード → 解凍 (既にあれば省略)
$dartDir = "$env:TEMP\dart_corp"
if (-not (Test-Path "$dartDir\CORPCODE.xml")) {
  Invoke-WebRequest "https://opendart.fss.or.kr/api/corpCode.xml?crtfc_key=$env:API_K_DART" -OutFile "$dartDir.zip"
  New-Item -ItemType Directory -Path $dartDir -Force | Out-Null
  Expand-Archive "$dartDir.zip" -DestinationPath $dartDir -Force
}

# 会社名または銘柄コードで corp_code を検索 (上場企業のみ)
[xml]$xml = Get-Content "$dartDir\CORPCODE.xml"
$xml.result.list | Where-Object { $_.corp_name -like '*삼성전자*' -and $_.stock_code.Trim() -ne '' } |
  Select-Object corp_code, stock_code, corp_name
# 出力: 00126380  005930  삼성전자

2. 取得した corp_code で残りの API を呼び出します

注: /tmp/dart_corp/CORPCODE.xml が既に存在する場合は、再ダウンロードなしで再利用します。ファイルサイズは約 30MB で、全法人リスト(上場+非上場)を含みます。corpCode.xml に会社名・銘柄コード・固有番号がすべて含まれているため、別スキル連携なしに単独で corp_code を確保できます。

サポートされたエンドポイント

すべてのリクエストは GET https://opendart.fss.or.kr/api/{endpoint}.json?crtfc_key=$API_K_DART&... 形式です。

1. 公示検索

GET /api/list.json?crtfc_key={key}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}
     [&corp_code={code}]
     [&last_reprt_at=Y|N] [&pblntf_ty=A..J] [&pblntf_detail_ty=...]
     [&corp_cls=Y|K|N|E] [&sort=date|crp|rpt] [&sort_mth=asc|desc]
     [&page_no=1] [&page_count=10]

公式ガイド(DS001/2019001)リクエスト引数の整理(必須性・デフォルト値・許可値は公式表の基準、識別子はコードフォントで表記):

リクエストキー	名称	型	必須性	値の説明
crtfc_key	API 認証キー	STRING(40)	Y	発行された認証キー(40桁)
corp_code	固有番号	STRING(8)	N	公示対象会社の固有番号(8桁)。※ 開発ガイド > 公示情報 > 固有番号 参照
bgn_de	開始日	STRING(8)	Y	検索開始受付日(YYYYMMDD)。1) デフォルト値: 終了日(end_de)。2) 固有番号(corp_code)がない場合、検索期間は3ヶ月に制限
end_de	終了日	STRING(8)	Y	検索終了受付日(YYYYMMDD)。1) デフォルト値: 当日
last_reprt_at	最終報告書検索有無	STRING(1)	N	最終報告書のみ検索するか(Y または N)。1) デフォルト値: N (訂正がある場合は最終訂正のみ検索)
pblntf_ty	公示種類	STRING(1)	N	A=定期公示、B=主要事項報告、C=発行公示、D=持分公示、E=その他公示、F=外部監査関連、G=ファンド公示、H=資産流動化、I=取引所公示、J=公正委公示
pblntf_detail_ty	公示詳細種類	STRING(4)	N	(※ 詳細種類参照: pblntf_detail_ty)
corp_cls	法人区分	STRING(1)	N	Y(上場)、K(KOSDAQ)、N(KONEX)、E(その他)。※ なければ全体照会、複数条件不可
sort	ソート	STRING(4)	N	受付日: date / 会社名: crp / 報告書名: rpt。※ デフォルト値: date
sort_mth	ソート方法	STRING(4)	N	昇順(asc)、降順(desc)。※ デフォルト値: desc
page_no	ページ番号	STRING(5)	N	ページ番号 (1~n)。デフォルト値: 1
page_count	ページ別件数	STRING(3)	N	ページあたりの件数 (1~100)。デフォルト値: 10、最大値: 100

pblntf_detail_ty よく使うコード例: A001=事業報告書、A002=中間報告書、A003=四半期報告書、B001=主要事項報告書、F001=監査報告書、F002=連結監査報告書、D001=株式等の大量保有状況報告書。

注意: DART OpenAPI list.json の公式リクエストパラメータ表に corp_name は存在しません。会社名を基準に特定企業の公示のみに絞り込みたい場合は、上記「corp_code 確保手順」で先に corp_code(8桁の固有番号)を取得した後に呼び出します。

2. 企業概要

GET /api/company.json?crtfc_key={key}&corp_code={code}

3. 財務諸表(単一会社全体財務諸表)

GET /api/fnlttSinglAcntAll.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}&fs_div={OFS|CFS}

reprt_code: 11013(第1四半期)、11012(中間)、11014(第3四半期)、11011(事業報告書) fs_div: OFS(個別)、CFS(連結)

4. 増資(減資)状況

GET /api/irdsSttus.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}

5. 配当に関する事項

GET /api/alotMatter.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}

6. 自社株式取得および処分状況

GET /api/tesstkAcqsDspsSttus.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}

7. 会計監査人の名称および監査意見

GET /api/accnutAdtorNmNdAdtOpinion.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}

8. 従業員状況

GET /api/empSttus.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}

部門別・性別の正社員/契約社員の人数、平均勤続年数、1人平均給与などを返します。

9. 有無償増資決定

GET /api/pifricDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}

注意: pifricDecsn.json は有無償増資決定専用エンドポイントです。有償増資のみを別途照会したい場合は piicDecsn.json(有償増資決定)を、無償増資のみを別途照会したい場合は fricDecsn.json(無償増資決定)を呼び出します。

10. 訴訟等の提起

GET /api/lwstLg.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}

11. 海外証券市場株券等上場決定

GET /api/ovLstDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}

12. 海外証券市場株券等上場廃止決定

GET /api/ovDlstDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}

13. 転換社債権発行決定

GET /api/cvbdIsDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}

14. 交換社債権発行決定

GET /api/exbdIsDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}

15. 会社分割合併決定

GET /api/cmpDvmgDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}

リクエスト例

公示検索(特定企業、サムスン電子):

# 1. 先に上記「corp_code 確保手順」で corp_code(例: サムスン電子=00126380) を取得
# 2. corp_code で期間内の公示を照会
curl -fsS --get 'https://opendart.fss.or.kr/api/list.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380' \
  --data-urlencode 'bgn_de=20260101' \
  --data-urlencode 'end_de=20260419' \
  --data-urlencode 'page_count=5'

公示検索(全体市場の最近公示、corp_code 未指定 — 公式仕様上検索期間 ≤ 3ヶ月):

curl -fsS --get 'https://opendart.fss.or.kr/api/list.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'bgn_de=20260301' \
  --data-urlencode 'end_de=20260419' \
  --data-urlencode 'pblntf_ty=A' \
  --data-urlencode 'corp_cls=Y' \
  --data-urlencode 'page_count=10'

企業概要:

curl -fsS --get 'https://opendart.fss.or.kr/api/company.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380'

財務諸表(連結、事業報告書):

curl -fsS --get 'https://opendart.fss.or.kr/api/fnlttSinglAcntAll.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380' \
  --data-urlencode 'bsns_year=2024' \
  --data-urlencode 'reprt_code=11011' \
  --data-urlencode 'fs_div=CFS'

配当状況:

curl -fsS --get 'https://opendart.fss.or.kr/api/alotMatter.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380' \
  --data-urlencode 'bsns_year=2024' \
  --data-urlencode 'reprt_code=11011'

従業員状況(事業報告書基準):

curl -fsS --get 'https://opendart.fss.or.kr/api/empSttus.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380' \
  --data-urlencode 'bsns_year=2024' \
  --data-urlencode 'reprt_code=11011'

有無償増資決定(pifricDecsn.json — 有償増資のみ見たい場合は piicDecsn.json):

curl -fsS --get 'https://opendart.fss.or.kr/api/pifricDecsn.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380' \
  --data-urlencode 'bgn_de=20200101' \
  --data-urlencode 'end_de=20260419'

転換社債発行決定:

curl -fsS --get 'https://opendart.fss.or.kr/api/cvbdIsDecsn.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380' \
  --data-urlencode 'bgn_de=20200101' \
  --data-urlencode 'end_de=20260419'

レスポンス形式

DART 共通レスポンス構造

すべてのレスポンスは status と message フィールドを含みます:

{
  "status": "000",
  "message": "정상",
  "list": [ ... ]
}

ステータスコード

status	意味
000	正常
010	登録されていないキー
011	使用できないキー
012	アクセスできない IP
013	照会されたデータなし
014	ファイルが存在しない
020	リクエスト制限超過(公式ガイド: 一般的に 20,000件以上のリクエスト時に発生。キー別に別途上限が設定されている場合も同じコードが返される)
021	照会可能な会社数超過(最大 100社)
100	フィールドエラー(フィールドの不適切な値)
800	ソースシステムメンテナンス中
900	未定義エラー

公示検索レスポンス例

{
  "status": "000",
  "message": "정상",
  "page_no": 1,
  "page_count": 5,
  "total_count": 142,
  "total_page": 29,
  "list": [
    {
      "corp_code": "00126380",
      "corp_name": "삼성전자",
      "stock_code": "005930",
      "corp_cls": "Y",
      "report_nm": "[기재정정]사업보고서 (2024.12)",
      "rcept_no": "20250401000123",
      "flr_nm": "삼성전자",
      "rcept_dt": "20250401",
      "rm": ""
    }
  ]
}

企業概要レスポンス例

{
  "status": "000",
  "message": "정상",
  "corp_code": "00126380",
  "corp_name": "삼성전자",
  "corp_name_eng": "SAMSUNG ELECTRONICS CO.,LTD",
  "stock_name": "삼성전자",
  "stock_code": "005930",
  "ceo_nm": "한종희, 경계현",
  "corp_cls": "Y",
  "jurir_no": "1301110006246",
  "bizr_no": "1248100998",
  "adres": "경기도 수원시 영통구 삼성로 129",
  "hm_url": "www.samsung.com",
  "ir_url": "",
  "phn_no": "031-200-1114",
  "induty_code": "264",
  "est_dt": "19690113",
  "acc_mt": "12"
}

レスポンスポリシー

• status が "000" でない場合はエラーメッセージをユーザーに案内します。
• status: "013"(照会されたデータなし)の場合は、期間/報告書種類/corp_code を再確認するように案内します。
• status: "020"(リクエスト制限超過)の場合は、呼び出し上限に達した可能性を案内します。公式ガイドは「一般的に 20,000件以上のリクエスト時」に発生すると記載しており、キー別に別途上限が設定されている場合は異なる閾値で発生する可能性があることも伝えます。しばらく後の再試行を勧めます。
• 銘柄名だけが分かっている場合は、上記「corp_code 確保手順」の corpCode.xml パースで先に corp_code を確保してから後続 API を呼び出します(DART OpenAPI list.json の公式リクエストパラメータ表に corp_name は存在しません)。
• 財務諸表照会時に reprt_code をユーザーが指定しない場合は事業報告書(11011)をデフォルト値として使用します。
• fs_div を指定しない場合は連結(CFS)をデフォルト値として使用します。
• 主要事項報告書(9~15番)は日付範囲が必要です。ユーザーが期間を指定しない場合は過去1年をデフォルトとします。
• 数字は読みやすい単位(億、兆、株)に展開しますが、元の数値も保持します。
• 回答の末尾に「金感院 DART 公示データ基準 / 投資助言ではありません」と短く付け加えます。

回答は簡潔に保つ

• 公示検索: 公示名 / 受付日 / 提出者を主に、最近 5~10件
• 企業概要: 会社名 / 代表者 / 業種 / 住所 / 決算月
• 財務諸表: 売上高 / 営業利益 / 当期純利益 / 資産総計 / 負債総計 / 資本総計の重要項目
• 主要事項報告書: 重要な決定内容と日付を要約

失敗パターン

• API_K_DART 環境変数が未設定 → キー発行案内後に中止
• status ≠ "000" → ステータスコード表を参考にしてエラーを案内
• corp_code が見つからない → 会社名の再確認をリクエスト
• 該当期間/報告書にデータがない → 期間または reprt_code の変更を案内

完了したと判断するとき

• API_K_DART の存在を確認した。
• ユーザーのリクエストに合ったエンドポイントを呼び出し、結果をまとめた。
• 必要に応じて先に corp_code を確保してから後続照会を実施した。
• 金感院 DART 公示データが基準であることを短く付け加えた。

注釈

• 公式データソース: DART OpenAPI
• このスキルは読み取り専用照会専用です。
• DART API リクエスト上限: 公式ガイド(020 メッセージ説明)では「一般的に 20,000件以上のリクエストに対して 020(リクエスト制限超過)が発生し、キー別に別途上限が設定された場合 異なる閾値でも同じコードが返される可能性がある」と記載されています。分単位のスロットルなどの詳細制約数値は公開ガイドには別途記載されていません。本人のキーの正確な使用状況はログイン後 OpenDART 使用状況 ページで確認できます。