
EDINET DB に CLI を追加しました — OpenAPI 3.0 spec も同時公開
有価証券報告書データベース EDINET DB に、コマンドラインから直接使える CLI edinetdb を追加しました。同時にAPIドキュメントも OpenAPI 3.0 + Redoc UI にリニューアルしています。
pip install edinetdb
edinetdb search toyota
edinetdb financials E02144 --years 5
edinetdb rankings roe --limit 10EDINET DB の現状
EDINET DB は金融庁の EDINET から日本の全上場企業 約4,000社の有価証券報告書を自動抽出し、構造化データベースとして提供するサービスです。
2026年4月時点の稼働状況
発行API Key 累計7,700件超(アクティブ約7,000件)
月間リクエスト 約100万
投資家・アナリスト・研究者・開発者・事業会社など、個人・法人を問わず利用可能なデータインフラとして、Web UI / REST API / MCP Server の3つの入口でデータを提供してきました。
今回そこにCLIという4つ目の入口を追加しました。
なぜCLIなのか
ユーザーヒアリングと利用ログ分析から、いくつかのユースケースが見えてきていました。
データサイエンティストがJupyterから軽く叩きたい — REST APIだと httpx/requestsのボイラープレートが必要で面倒
リサーチャーがシェルでパイプしたい — 「curlで叩いてjqで整形」のワンライナーが書きづらい
AIエージェント(Claude/Cursor等)から使わせたい — MCP Serverを既に提供しているが、MCP非対応のクライアントからの利用経路がなかった
cronやGitHub Actionsで定期的にデータを取り出したい — 認証トークンの管理等、セットアップが重い
CLIは「Web UIよりは軽く、REST APIよりはカジュアルに使いたい」層を埋める入口です。pip install edinetdb 1発で、既存の EDINET DB API Key をそのまま流用して全機能にアクセスできます。
参考にしたもの・違うもの
同じ領域で先行しているのが、日本取引所グループ(JPX)の J-Quants CLI です。CLI設計の参考にさせていただきました。
J-Quants CLI と edinetdb CLI の違い:
分野 — J-Quantsは市場データ(株価・指数・先物)、edinetdbは有報構造化データ(財務・セグメント・大株主・テキスト)
認証 — J-QuantsはOAuth推奨、edinetdbは既存API Key paste方式
出力 — J-Quantsはjson/csv/parquet/table、edinetdbはjson/csv/table(parquetはv0.2.0予定)
AI連携 — J-QuantsはSkills同梱、edinetdbは別途MCP Server提供
バルクDL — J-QuantsはGZ CSV対応、edinetdbはリアルタイムAPI中心
上場企業の「市場データ」を J-Quants、「有報データ」を EDINET DB が担当する形で、開発者は両方を組み合わせて使えます。
OpenAPI 3.0 spec の公開
CLI と同時に、API 仕様を OpenAPI 3.0 形式で公開しました。
OpenAPI spec を公開する実用的な価値は、ざっくり3つあります。
各言語のSDK自動生成が可能 — TypeScript / Go / Rust / Java クライアントを openapi-generator 等で数分で生成できる
AIエージェントに食わせやすい — Claude や ChatGPT にAPI仕様を理解させて、適切な呼び出しを生成させられる
Postman / Bruno / Insomnia への直接インポート — 試行錯誤しながらの探索が容易
EDINET DB事業部内でも、この spec を真実のソース (Single Source of Truth) にして、Flask 実装との突合を CI で機械チェックする運用に切り替えました。ドキュメント記載漏れによるユーザーの混乱を構造的に防ぐ狙いです。
データインフラ事業としての位置付け
EDINET DB は弊社カボシア株式会社の「データインフラ事業」の1プロダクトです。
データインフラ事業の構想は一貫していて、
公開データを構造化し、AIエージェントと人間の両方が最初に接続するデータソースを作る
というものです。EDINET DB の姉妹プロダクトの一つとして、不動産データベース FUDOSAN DB、防災・ハザードデータの BOUSAI DB も運営中です。将来的には複数のデータインフラを相互接続して、日本市場を多層的に把握できる基盤を作っていきたいと考えています。
CLIとOpenAPI公開は、このビジョンの「開発者層にもっとリーチする」というフェーズの一環です。
これから
v0.2.0 では以下を予定しています。
--save での拡張子自動判別(parquet含む)
--fields でレスポンスフィールド絞り込み
シェル補完(bash/zsh/fish)
Homebrew配布
AIエージェント(Claude Code / Cursor / Aider)からの利用を想定した docs 整備
「こういう機能が欲しい」「このデータを追加してほしい」等のフィードバックは GitHub Issue でお待ちしています。
関連リンク
サイト — edinetdb.jp
CLI(PyPI) — pypi.org/project/edinetdb
CLIソース — github.com/Cabocia/edinetdb-cli
API Reference — edinetdb.jp/docs/api-reference
技術詳細(Zenn) — zenn.dev/edinetdb/articles/edinetdb-cli-launch
運営: カボシア株式会社 / EDINET DB事業部