メインコンテンツへスキップ
見出し画像

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 10

    EDINET 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つあります。

    1. 各言語のSDK自動生成が可能 — TypeScript / Go / Rust / Java クライアントを openapi-generator 等で数分で生成できる

    2. AIエージェントに食わせやすい — Claude や ChatGPT にAPI仕様を理解させて、適切な呼び出しを生成させられる

    3. 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 でお待ちしています。

    関連リンク


    運営: カボシア株式会社 / EDINET DB事業部

     
     
    日本の全上場企業3,848社の有報データを名寄せ・構造化し、無料API/MCPで提供するプラットフォーム。金融庁EDINETのXBRLを3会計基準横断で統一。AIエージェントから直接参照できる統合データインフラを目指しています。 https://edinetdb.jp

    あなたへのおすすめ