japan-ir-search

AIエージェントから日本の企業IR開示書類をテキスト検索できる MCP サーバー。

EDINET（金融庁）の有価証券報告書・四半期報告書・臨時報告書・大量保有報告書などをダウンロードし、SQLite FTS5 でローカルに全文検索インデックスを構築します。Claude Desktop、Cursor、VS Code Copilot などの MCP クライアントから直接利用できます。

🚀 ホスト版（ベータ公開中・APIキー不要）

セットアップ不要で試せるホスト版を Fly.io 上で公開しています。よりステップバイステップの手順は ランディングページ をご覧ください。

• エンドポイント: https://japan-ir-search.fly.dev/mcp（Streamable HTTP）

• 収録範囲: 直近2年分・全18書類種別（全上場企業 + 投信・REIT・外国会社等 6,984 提出者 / 約 55,000 件）

• 認証: 不要（ベータ期間中）

• 更新: 日次バッチで追記

⚠️ ベータ運用に関する注意

• 個人運用の実験的サービスです。無保証・予告なく停止・破壊的変更あり。

• アイドル時にマシンを停止する構成のため、初回リクエストは数秒のコールドスタートがあります。

• 業務利用・ミッションクリティカル用途にはローカル構築（後述）を推奨します。

MCP クライアント設定例

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json / Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "japan-ir-search": {
      "type": "http",
      "url": "https://japan-ir-search.fly.dev/mcp"
    }
  }
}

VS Code (.vscode/mcp.json またはユーザー設定):

{
  "servers": {
    "japan-ir-search": {
      "type": "http",
      "url": "https://japan-ir-search.fly.dev/mcp"
    }
  }
}

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "japan-ir-search": {
      "url": "https://japan-ir-search.fly.dev/mcp"
    }
  }
}

設定後、AI に「ソニーの最新の事業等のリスクを見せて」「半導体サプライチェーンに言及してる企業を探して」のように聞けます。

何ができるか

既存の EDINET MCP サーバーは財務数値の取得に特化しています。 このツールは有報の「テキスト」を検索対象にする点が異なります。

❌ 既存ツール: 「トヨタの売上高は？」 → 45兆953億円
✅ これ:       「半導体サプライチェーンリスクに言及している企業は？」
               → トヨタ: 「半導体サプライチェーンリスク、地政学的リスク...」(事業等のリスク)
               → ソニー: 「特定サプライヤーへの依存...」(事業等のリスク)

MCP ツール（5つ）

検索可能なセクション

• 事業等のリスク — リスク要因の記述

• 事業の内容 — 事業概要

• 経営者による分析（MD&A） — 経営成績・財政状態の分析

• コーポレート・ガバナンスの状況等

• 経理の状況

• 全文 — 上記に分類されない部分を含む全テキスト

対象書類（18種別）

主要（HIGH）: 有価証券報告書、四半期報告書、半期報告書、臨時報告書 + 各訂正

準主要（MEDIUM）: 内部統制報告書、公開買付届出書/報告書、意見表明報告書、大量保有報告書 + 各訂正

セットアップ

1. インストール

git clone https://github.com/tamcho113/japan-ir-search.git
cd japan-ir-search
uv sync

2. EDINET API キーの取得

EDINET で無料登録し、Subscription-Key を取得してください。

export EDINET_API_KEY=your_key_here

3. インデックス構築

# 直近1年分（約2GB、2〜3時間）
uv run japan-ir-search build

# 直近3年分、全種別（約18GB、20〜30時間）
uv run japan-ir-search build --years 3 --doc-types all

# 主要種別のみ（有報・四半期・半期・臨時のみ）
uv run japan-ir-search build --years 3 --doc-types high

# バックグラウンド実行（推奨）
nohup uv run japan-ir-search -v build --years 3 > build.log 2>&1 &
tail -f build.log

中断しても再開時にインデックス済みの書類はスキップされます。

4. MCP サーバーとして使う

uv run japan-ir-search serve

Claude Desktop・Cursor・VS Code 等での MCP サーバーの設定方法は各クライアントのドキュメントを参照してください。サーバーコマンドは上記です。

• Claude Desktop — MCP 設定ガイド

• VS Code — MCP の使い方

• Cursor — MCP 設定

設定例（共通パターン）:

{
  "command": "uv",
  "args": ["--directory", "/path/to/japan-ir-search", "run", "japan-ir-search", "serve"],
  "env": { "EDINET_API_KEY": "your_key_here" }
}

CLI

# 検索
uv run japan-ir-search search "半導体 サプライチェーン"
uv run japan-ir-search search "M&A 買収" --section risk_factors
uv run japan-ir-search search "ESG" --company トヨタ

# 統計確認
uv run japan-ir-search stats

# MCP サーバー起動
uv run japan-ir-search serve

使い方の例

MCP クライアント（Claude等）にこう聞けます：

• 「地政学リスクに言及している自動車メーカーを探して」

• 「ソニーの事業等のリスクを見せて」

• 「トヨタの前期と当期でリスク記述がどう変わったか比較して」

• 「臨時報告書でM&Aに言及している直近の書類は？」

• 「大量保有報告書でアクティビストの動きがある企業は？」

アーキテクチャ

EDINET API → ZIP DL → HTML抽出 → セクション分割 → SQLite FTS5 (trigram)
                                                         ↓
                                              MCP Server ← Claude/Cursor/VS Code

• SQLite FTS5 (trigram): 日本語テキストを文字 n-gram で全文検索

• ローカル完結: 外部サービス不要。DB ファイル 1つで動作

• レート制限対策: 0.8秒間隔 + 429/5xx 指数バックオフリトライ

ストレージ目安

ローカル構築時の DB サイズの目安です。FTS5 インデックス込みのトータル。

ホスト版の現在の収録: 直近 2 年 / 全18種 / 全上場企業 + 投信・REIT等 6,984 提出者 / 約 55,000 件 / 14GB

書類種別の詳細は対象書類を参照。

データについて

EDINET（Electronic Disclosure for Investors' NETwork）は金融庁が運営する法定開示書類の電子開示システムです。API 利用は無料（要登録）。開示データは公共データライセンス 1.0 に基づき提供されています。

ライセンス

MIT