IR Download Agent

日本企業統合報告書（IR）ダウンロードエージェントのサンプルプロジェクトです。

概要

このプロジェクトは、日本企業の統合報告書を自動的に検索・検証・ダウンロードするAIエージェントを実装しています。

主な機能

• IRエージェント: 企業の統合報告書を自動でダウンロード
  • DuckDuckGoベースのカスタム検索（APIキー不要）
  • Google Gemini AIによるPDF内容検証
  • 効率的な検索パターンで冗長な操作を最小化
• MCPエージェント: 日本語Webサーチアシスタント（Brave Search API使用）

開発コマンド

# 開発サーバー起動（Mastra APIをhttp://localhost:4111で起動）
npm run dev

# ビルド
npm run build

# 型チェック
npx tsc

IRエージェント処理フロー

sequenceDiagram
    participant ユーザー
    participant IRエージェント
    participant 検索・スクレイピング
    participant AI分析 (Gemini)
    participant ストレージ

    ユーザー->>IRエージェント: 企業名を指定して統合報告書を依頼
    
    Note over IRエージェント: 1. 検索フェーズ
    IRエージェント->>検索・スクレイピング: 企業のIRページを検索
    検索・スクレイピング-->>IRエージェント: IR関連ページリスト
    
    Note over IRエージェント: 2. 探索フェーズ
    IRエージェント->>検索・スクレイピング: IRページからPDFリンクを抽出
    alt PDFが見つからない場合
        IRエージェント->>検索・スクレイピング: サブページを探索（最大3ページ）
    end
    検索・スクレイピング-->>IRエージェント: PDF候補リスト
    
    Note over IRエージェント: 3. 検証フェーズ
    IRエージェント->>IRエージェント: ファイルサイズ・名前で事前フィルタ
    IRエージェント->>AI分析 (Gemini): 最有力PDFの内容を分析（最初の5ページ）
    AI分析 (Gemini)-->>IRエージェント: 統合報告書の信頼度スコア
    
    Note over IRエージェント: 4. ダウンロードフェーズ
    alt 信頼度が高い場合（≥0.8）
        IRエージェント->>ストレージ: PDFをダウンロード・保存
        ストレージ-->>IRエージェント: 保存完了
        IRエージェント->>ユーザー: ダウンロード完了通知
    else 信頼度が低い場合
        IRエージェント->>IRエージェント: 次の候補を検証
    end

処理の特徴

1. 効率的な検索: DuckDuckGoベースの検索でAPIキー不要
2. スマートな探索: IRページを優先的に探索し、必要に応じてサブページも確認
3. AI検証: Gemini AIでPDFの最初の5ページを分析し、統合報告書かを判定
4. 自動ダウンロード: 検証済みのPDFを自動でダウンロード・整理

環境変数

.envファイルに以下を設定：

• BRAVE_API_KEY - MCPエージェントのWeb検索機能用（IRエージェントには不要）

APIエンドポイント

npm run dev実行時、エージェントはREST APIエンドポイントとして公開されます：

• POST http://localhost:4111/api/agents/irAgent/generate
• POST http://localhost:4111/api/agents/mcpAgent/generate

リクエストボディ形式：

{
  "messages": ["メッセージ"],
  "maxSteps": 10  // オプション、デフォルトは5
}

ライセンス

MIT