Sec Edgar MCP

🚀 SEC EDGAR MCP プロジェクトドキュメント

SEC EDGAR MCP プロジェクトは、AI モデルが Model Context Protocol (MCP) を通じて米国証券取引委員会（SEC）の EDGAR データベースにアクセスできるインターフェースを提供します。EDGAR は SEC の電子化された企業書類提出システムで、上場企業の規制ファイリング（10 - K、8 - K などの重要な財務報告）が含まれています。

MCP プロトコルを使用することで、AI モデルは一連のツールを呼び出して SEC の公開データを照会および分析し、上場企業の財務状況やガバナンス構造などの情報を自動的に取得および処理することができます。

🚀 クイックスタート

SEC EDGAR MCP プロジェクトを通じて、AI モデルは MCP を利用して EDGAR データベースにアクセスできます。以下に利用可能なツールや注意事項などを説明します。

✨ 主な機能

• AI モデルが MCP を通じて EDGAR データベースにアクセスできるインターフェースを提供します。
• 一連のツールを使って SEC の公開データを照会および分析できます。
• 上場企業の財務状況やガバナンス構造などの情報を自動的に取得および処理できます。

📦 インストール

ドキュメントにインストール手順に関する内容が記載されていないため、このセクションをスキップします。

💻 使用例

基本的な使用法

以下に、利用可能な EDGAR ツールの使用例を示します。

1. 提出記録の取得 (get_submissions)

機能: 指定された企業（CIK または Ticker で指定）のすべての SEC 提出記録を検索します。 パラメータ:

• cik: 企業の Central Index Key（省略可能。指定しない場合は ticker を指定する必要があります）
• ticker: 企業の株式コード（省略可能。指定しない場合は cik を指定する必要があります）

戻り値: 企業が提出したすべてのファイリングのメタデータのリストを返します。以下のフィールドが含まれます。

• accessionNumber: 提出記録の一意の識別子
• formType: 提出されたフォームのタイプ（10 - K、8 - K など）
• actionDate: 提出日
• filedAt: ファイルの実際の提出時間
• description: フォームの簡単な説明

リクエスト例:

{
  "jsonrpc": "2.0",
  "method": "get_submissions",
  "params": {
    "cik": "0001369748"
  },
  "id": 1
}

レスポンス例:

{
  "result": [
    {
      "accessionNumber": "0001369748-23-00001",
      "formType": "10-K",
      "actionDate": "2023-12-31",
      "filedAt": "2024-01-01T12:00:00Z",
      "description": "Annual report for the year ended December 31, 2023"
    },
    // 他のレコード...
  ]
}

2. ファイリング内容の取得 (get_filing)

機能: 指定された提出記録の完全な内容を返します。 パラメータ:

• accessionNumber: 提出記録の一意の識別子

戻り値: 提出記録の JSON 形式の内容を返します。以下のフィールドが含まれます。

• infoTable: 基本情報表
• formData: フォームデータ
• XBRLData: 拡張可能なビジネス報告言語 (XBRL) データ（適用可能な場合）

リクエスト例:

{
  "jsonrpc": "2.0",
  "method": "get_filing",
  "params": {
    "accessionNumber": "0001369748-23-00001"
  },
  "id": 1
}

レスポンス例:

{
  "result": {
    "infoTable": {
      "Company Name": "Example Corp",
      "CIK": "0001369748",
      "Form Type": "10-K"
    },
    "formData": {
      // フォームデータの内容...
    }
  }
}

3. XBRL データの取得 (get_xbrl)

機能: 指定された提出記録内の XBRL (拡張可能なビジネス報告言語) データを返します。 パラメータ:

• accessionNumber: 提出記録の一意の識別子

戻り値: 収益、利益、負債などの主要指標を含む XBRL 形式の財務データを返します。

リクエスト例:

{
  "jsonrpc": "2.0",
  "method": "get_xbrl",
  "params": {
    "accessionNumber": "0001369748-23-00001"
  },
  "id": 1
}

レスポンス例:

{
  "result": {
    "FinancialStatements": {
      "Revenue": 1000000,
      "NetIncome": 500000,
      "TotalLiabilities": 2000000
    }
  }
}

📚 ドキュメント

注意事項 🛠️

• すべてのツールの呼び出しには有効な CIK または Ticker を提供する必要があります。
• 呼び出し前に SEC の 公式ドキュメント と MCP プロトコルの要件をよく読んでください。
• SEC データベースの制限により、一部の履歴データにアクセスできない場合があります。

アーキテクチャ 🗖️

プロジェクトのアーキテクチャは以下の通りです。

1. MCP クライアント: AI モデルからのリクエストを受信および処理し、サーバーに転送します。
2. MCP サーバー: リクエストを解析し、該当する EDGAR API を呼び出し、結果をクライアントに返します。
3. EDGAR REST API: SEC が提供する公開インターフェースで、ファイリングデータの照会および取得に使用されます。

全体の流れは以下の通りです。

AI モデル -> MCP クライアント -> MCP サーバー -> EDGAR REST API -> 結果の返却

参考資料 📚

1. SEC 公式サイト (公式サイト, 2024)
2. MCP プロトコルドキュメント
3. EDGAR API ドキュメント

🔧 技術詳細

ドキュメントに技術的な詳細説明が 50 文字以上記載されていないため、このセクションをスキップします。

📄 ライセンス

このプロジェクトは MIT ライセンスの下でオープンソース化されており、ユーザーは自由に使用、修正、配布することができます。完全なライセンス内容は LICENSE ファイルを参照してください。