SEC EDGAR について
SEC EDGARは、米国企業の提出書類やXBRLデータを調べるMCPサーバーです。投資家や財務調査担当者向けに、企業検索、提出書類の取得、財務推移、全文検索をAPIキーなしで提供します。
主な機能
- 01社名やティッカーによる企業検索
- 02提出書類の最新・最近分の取得
- 03XBRL財務ハイライト
- 04GAAP項目の推移確認
- 05提出書類の全文検索
- 06MarkdownまたはJSON形式の出力
活用シーン
- 01企業のCIKと最近の提出書類の確認
- 02財務指標の時系列推移の確認
- 03複数企業の提出書類から話題を検索
MCP 対応
MCPクライアントにSEC EDGARの企業検索、提出書類、XBRL、検索ツールを提供します。リクエストは利用者の端末からSEC APIへ直接送信されます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y edgar-mcpSEC_USER_AGENTDescriptive User-Agent with contact info required by the SEC, e.g. 'your-app [email protected]'ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
SEC EDGAR MCP サーバー 🏛️
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 | 名前またはティッカーに一致する企業と、そのCIK | query、limit |
get_recent_filings | 最近の提出書類(フォーム、日付、リンク)。フォームでの絞り込みも可能 | identifier、form_type、limit |
get_latest_filing | 指定したタイプの最新の提出書類と、文書へのリンク | identifier、form_type |
get_company_facts | 財務の概要(売上高、純利益、資産、株主資本、現金、EPS) | identifier |
get_concept | XBRLコンセプト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 にツールが表示されない
- 設定ファイルが有効な JSON であることを確認してください(末尾にカンマを付けないでください)。
- 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
- GitHub:@danishashko
- LinkedIn:daniel-shashko
- npm:danielshashko
📄 ライセンス
MIT © Daniel Shashko
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。