mcpField
S
SEC EDGAR

SEC EDGAR

ローカル
github.com/danishashko金融データ012 週間前に更新

SEC EDGAR について

SEC EDGARは、米国企業の提出書類やXBRLデータを調べるMCPサーバーです。投資家や財務調査担当者向けに、企業検索、提出書類の取得、財務推移、全文検索をAPIキーなしで提供します。

主な機能

  1. 01社名やティッカーによる企業検索
  2. 02提出書類の最新・最近分の取得
  3. 03XBRL財務ハイライト
  4. 04GAAP項目の推移確認
  5. 05提出書類の全文検索
  6. 06MarkdownまたはJSON形式の出力

活用シーン

  1. 01企業のCIKと最近の提出書類の確認
  2. 02財務指標の時系列推移の確認
  3. 03複数企業の提出書類から話題を検索

MCP 対応

MCPクライアントにSEC EDGARの企業検索、提出書類、XBRL、検索ツールを提供します。リクエストは利用者の端末からSEC APIへ直接送信されます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"danishashko-edgar": {
"command": "npx",
"args": [
"-y",
"edgar-mcp"
],
"env": {
"SEC_USER_AGENT": "<SEC_USER_AGENT>"
}
}
}
}
起動コマンドnpx -y edgar-mcp
設定が必要な環境変数
SEC_USER_AGENTDescriptive User-Agent with contact info required by the SEC, e.g. 'your-app [email protected]'

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmedgar-mcp1.0.2

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

SEC EDGAR MCP サーバー 🏛️

npm version npm downloads Python License: MIT

SEC EDGARを活用し、Claude DesktopやMCP対応クライアントで米国SECの提出書類や財務データを利用できます。企業の検索、提出書類(10-K、10-Q、8-K、Form 4など)の取得、XBRL財務データの閲覧、すべての提出書類を対象とした全文検索を、自然言語で行えます。APIキーは不要です。

npm パッケージ: edgar-mcp  ·  GitHub リポジトリ: danishashko/edgar-mcp。

🎯 利用できる機能

  • 🔎 企業名またはティッカーから企業を検索 → CIK
  • 🗂️ 最近の提出書類(すべてのフォームタイプ)と文書への直接リンク
  • 📄 指定したタイプの最新の提出書類(最新の10-K/10-Q/8-K)を1回の呼び出しで取得
  • 💰 XBRLから財務の概要(売上高、純利益、資産、株主資本、EPS)を取得
  • 📈 コンセプト履歴 — GAAPの任意の項目の経時的な推移
  • 🔬 過去約10年間の提出書類を対象とした全文検索

各ツールはデフォルトで人が読みやすいマークダウンを返し、リクエストに応じて構造化されたJSONも返します(response_format: "json")。軽量で(Python標準ライブラリとmcpのみを使用)、APIキーは不要です。レート制限時は再試行します。

🚀 クイックスタート

以下をClaude Desktopの設定に追加し、Claudeを再起動してください。

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "edgar": {
      "command": "npx",
      "args": ["-y", "edgar-mcp"],
      "env": {
        "SEC_USER_AGENT": "your-app-name [email protected]"
      }
    }
  }
}

SECは、すべてのAPIクライアントに連絡先情報を含む説明的なUser-Agentの送信を求めています。SEC_USER_AGENTにご自身の名前とメールアドレスを設定してください(デフォルト値が用意されているため、すぐに利用できます)。初回起動時、npxラッパーが分離されたPython環境を作成し、依存関係をインストールします(初回のみ、約1分)。Python 3.10以上とNode.js 16以上が必要です。

グローバルインストールをご希望ですか?
npm install -g edgar-mcp
{
  "mcpServers": {
    "edgar": {
      "command": "edgar-mcp",
      "env": { "SEC_USER_AGENT": "your-app-name [email protected]" }
    }
  }
}

🔧 利用可能なツール

ツール返される内容パラメーター
search_company名前またはティッカーに一致する企業と、そのCIKquery、limit
get_recent_filings最近の提出書類(フォーム、日付、リンク)。フォームでの絞り込みも可能identifier、form_type、limit
get_latest_filing指定したタイプの最新の提出書類と、文書へのリンクidentifier、form_type
get_company_facts財務の概要(売上高、純利益、資産、株主資本、現金、EPS)identifier
get_conceptXBRLコンセプト1つの報告履歴の推移identifier、concept、limit
full_text_search全企業の提出書類からキーワード/フレーズに一致するものを検索query、forms、limit

各ツールではresponse_format(デフォルトの"markdown"または"json")も指定できます。identifierにはティッカー、CIK、または企業名を指定できます。

get_conceptでよく使われるXBRLコンセプト: Revenues/RevenueFromContractWithCustomerExcludingAssessedTax、NetIncomeLoss、Assets、Liabilities、StockholdersEquity、EarningsPerShareDiluted。

💬 プロンプトの例

サーバーに接続したら、Claudeにそのまま質問できます。

  • 「Appleの最新の10-Kは何ですか?」
  • 「Teslaの最近の8-K提出書類を見せてください。」
  • 「Microsoftの財務の概要を教えてください。」
  • 「NVIDIAの過去数年間の純利益を見せてください。」
  • 「10-Kで「quantum computing」に言及している企業はどこですか?」
  • 「Berkshire HathawayのCIKを調べてください。」

🐛 トラブルシューティング

「SEC EDGAR がリクエストをレート制限している」 EDGAR は約10リクエスト/秒まで許可しています。サーバーは自動的に再試行します。問題が続く場合は、少し待ってください。

「見つかりません」 まず search_company を使って、正確なティッカー/CIKを確認してください。

「コマンドが見つかりません」/「Python が見つかりません」 Python 3.10+ と Node.js 16+ がインストールされ、PATH に設定されていることを確認してください。macOS/Linux では、python3 をお試しください。

Claude にツールが表示されない

  1. 設定ファイルが有効な JSON であることを確認してください(末尾にカンマを付けないでください)。
  2. Claude Desktop を完全に終了し、再度開いてください。

別のモデルやプロバイダー(LiteLLM、OpenRouter、NVIDIA NIM、ローカルモデル)を使う場合 このサーバーはモデルと通信しません。クライアントがローカルプロセスとして起動し、stdin/stdout 経由で JSON-RPC を使って通信するため、ANTHROPIC_BASE_URL の変更や、クライアントが使用するモデルの切り替えは影響しません。このような切り替えの後にツールが呼び出されなくなった場合は、次の2点を確認してください。モデルが関数呼び出しに対応している必要があります。また、未対応のパラメーターを破棄するように設定されたプロキシは、ツール定義をエラーなく黙って削除することがあります。サーバーを疑う前に、クライアントで /mcp(または claude mcp list)を実行して、サーバーが接続されていることを確認してください。

🛠️ 手動インストール(別の方法)

npx 経由ではなく、Python ファイルを直接実行する場合は、次の手順に従ってください。

1. サーバーをダウンロードして依存関係をインストールする

pip install mcp

(macOS/Linux では pip3 を使用してください)

2. Claude Desktop の接続先に設定する

{
  "mcpServers": {
    "edgar": {
      "command": "python3",
      "args": ["/absolute/path/to/edgar_mcp.py"],
      "env": { "SEC_USER_AGENT": "your-app-name [email protected]" }
    }
  }
}

Windows では "command": "python" と、"C:\\path\\to\\edgar_mcp.py" のようなパスを使用してください。

3. Claude Desktop を再起動します。

🔒 プライバシーとレート制限

  • 公式の SEC EDGAR API を使用します。公開 API のため、キーは不要です。
  • リクエストはお使いのマシンから SEC に直接送信されます。データが保存されたり、プロキシ経由で送信されたりすることはありません。
  • SEC は連絡先情報を含む説明的な User-Agent を要求し、リクエストを約10件/秒に制限しています。
  • 個人、教育、研究目的での利用を想定しています。

📝 補足事項

  • identifier には、ティッカー(AAPL)、CIK(320193)、会社名(Apple)を指定できます。
  • 財務データは XBRL から取得します。SEC が XBRL を初めて義務付けたのは2009年のため、ほとんどの提出者について、その年までの履歴を取得できます。
  • get_company_facts は概要を返します。任意の指標について完全な系列を取得するには、get_concept を使用してください。

📋 変更履歴

すべてのバージョン履歴については、CHANGELOG.md をご覧ください。

📚 リソース

⚖️ 法的免責事項

このツールは SEC EDGAR の公開 API を使用していますが、米国証券取引委員会とは提携関係になく、同委員会の承認も受けていません。利用には SEC のウェブサイトポリシーが適用されます。データは個人、教育、研究目的で現状のまま提供されます。データを利用する前に、元の提出書類と照合してください。

👤 作者

Daniel Shashko

📄 ライセンス

MIT © Daniel Shashko

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。