mcpField
S
SEC EDGAR Insider Trades & Financials

SEC EDGAR Insider Trades & Financials

リモート
github.com金融データ04 日前に更新
リポジトリ公式サイト

SEC EDGAR Insider Trades & Financials について

米国SEC EDGARの提出書類や財務データを検索するリモートMCPサーバー兼JSON APIです。インサイダー取引、提出書類、XBRLデータをエージェント向けの簡潔なJSONで返します。

主な機能

  1. 01Form 4のインサイダー取引を取得
  2. 02市場全体の集中買いを検出
  3. 03企業の提出書類とリンクを取得
  4. 04XBRL財務スナップショットと履歴を参照
  5. 05テキストと条件で提出書類を検索
  6. 06ティッカーとCIKを相互変換

活用シーン

  1. 01インサイダーの買いと売りを確認
  2. 02複数企業にまたがる集中買いを調査
  3. 03企業財務の比較資料を作成
  4. 04日付、書類形式、語句で提出書類を検索

MCP 対応

インサイダー取引、提出書類、XBRL財務データ、全文検索、ティッカーとCIKの照合に使う7つのツールを提供します。MCPクライアントはステートレスなStreamable HTTPエンドポイントに接続します。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://sec-edgar-api.kidriahx.workers.dev/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

詳細

SEC EDGAR MCP(リモート)

Cloudflare Workers 上で動作する、米国のSEC EDGARデータ向けリモートModel Context Protocolサーバーおよび JSON API です。AI エージェントに、XML の解析や CIK の検索なしで、Form 4 のインサイダー取引、市場全体のクラスター買い、企業の提出書類、XBRL 財務情報、EDGAR 全文検索をコンパクトな JSON で提供します。

データは SEC の公正アクセス規則(User-Agent の申告、グローバルレート制限は約 8.7 req/s(SEC の 10 req/s 未満)、キャッシュ)に従い、SEC EDGAR(パブリックドメイン)から直接取得します。SEC とは提携していません。投資助言ではありません。

ツール

ツール返される内容
get_insider_trades企業(ティッカー/CIK)またはインサイダー(報告所有者の CIK)の Form 4 取引。買い手または売り手、役職、株数、価格、金額、10b5-1 フラグ、提出書類へのリンクに加え、買いと売りの合計を返します。
get_market_insider_buys市場全体にわたる公開市場でのインサイダー購入を企業別にグループ化して返し、クラスター買い(インサイダー 2 人以上)を検出します。
get_company_filings最新の 10-K、10-Q、8-K(項目番号付き)、S-1、委任状、その他の提出書類を、文書への直接リンク付きで返します。
get_company_snapshotXBRL から取得した売上高、利益率、純利益、EPS、キャッシュフロー、貸借対照表、負債を前年比の成長率とともに返します。
get_company_concept任意の XBRL タグ(例:NetIncomeLoss、Revenues)の年次または四半期の履歴を返します。
search_filingsフレーズ、フォーム、日付で絞り込める EDGAR 全文検索です。
resolve_companyティッカー ↔ CIK の検索です。

クライアントを接続する

Streamable HTTP に対応する MCP クライアントなら、URL を直接使用できます。例:

{
  "mcpServers": {
    "sec-edgar": {
      "type": "http",
      "url": "https://sec-edgar-api.kidriahx.workers.dev/mcp"
    }
  }
}

Claude Code ユーザーは claude mcp add --transport http sec-edgar https://sec-edgar-api.kidriahx.workers.dev/mcp を実行できます。クライアントごとに形式が若干異なるため、正確なファイルについては以下のエージェントキットを参照してください。

運用者が MCP_API_KEYS を設定している場合は、Authorization: Bearer <key>、X-API-Key: <key>、または ?api_key=<key> としてキーを送信してください。上記の公開エンドポイントではキーは不要です。

プロンプトの例:

  • 「過去 30 日間に、インサイダーによるクラスター買い(インサイダー 2 人以上)があった企業は?」
  • 「NVIDIA の直近 10 件のインサイダー売却を表示し、それぞれが 10b5-1 プランに基づくものかどうか教えてください。」
  • 「Apple の売上高、純利益率、負債資本比率を前年と比較してください。」
  • 「今年、『share repurchase』に言及している 8-K 提出書類を見つけてください。」

その他の例は prompts/ にあります。

エージェントキット

サーバーをエージェントに接続するために必要なものがすべてそろっています。ライブエンドポイントでテスト済みです。

  • docs/SETUP.md:各クライアント向けの手順を追ったセットアップガイドと、トラブルシューティングを掲載しています。
  • kit/:Claude Desktop(mcp-remoteまたはカスタムコネクター経由)、Claude Code、Cursor、VS Code、Windsurf向けのコピー&ペースト可能な設定と、汎用のStreamable HTTPの例(curl、Node SDK、Python SDK)を掲載しています。
  • skills/:信頼性の高いワークフローをエージェントに教える4つのAgent Skills(SKILL.md)を収録しています。
    • insider-buying-scan:市場全体のクラスター買いを調査し、次に企業ごとの取引詳細と背景情報を確認します
    • company-financial-snapshot:期間を正しく重複排除した、複数年のXBRLテーブル(売上高、純利益、現金)を作成します
    • filing-monitor:監視対象リストの8-Kダイジェストを、項目番号のデコード情報とともに作成します
    • earnings-prep:決算発表前に、1ページの概要を作成します
  • prompts/:10個のプロンプト例と、それぞれが起動すべきツールを掲載しています。
  • test/skills.mjs:node test/skills.mjsを実行すると、ライブエンドポイントに対してすべてのスキルのワークフローをテストできます(Node 18以降、インストール不要)。

大量のデータや定期実行が必要ですか?

このMCPサーバーは無料で、対話型のエージェント向け規模の検索を想定しています。1回の呼び出しで、1社または少数の提出書類を検索できます。市場全体の日次8-Kアラート、数百銘柄の提出書類、期間を指定したキーワード検索、またはスケジュールに沿ってデータセット、Webhook、スプレッドシートに結果を配信するなど、それ以上の処理が必要な場合は、同じSECソースを利用する有料のApify Actorも公開しています。

SEC EDGAR Filings & Financials API(Apify)

  • companyFilings:銘柄コードごとの8-Kまたは任意のフォーム
  • marketFilings:期間内に全企業が提出した、選択したフォームのすべての提出書類。8-Kの項目や全文を対象としたキーワードフィルターも利用できます
  • financials:銘柄コードのリストを対象としたXBRLスナップショット
  • スケジュール設定と変更検出(onlyNewSinceLastRun)により、未確認の提出書類だけを取得できます
  • 結果ごとの従量課金:提出書類1行あたり$0.002、企業スナップショット1件あたり$0.005。maxResultsで上限を設定できます。Apifyの無料プランには、毎月のプラットフォームクレジットが含まれます。

このリポジトリの機能を使うために、これを利用する必要はありません。MCPサーバーは無料のままで、Actorはバッチ処理や定期実行に必要な場合に任意で利用できます。インサイダー取引はこのActorの対象外です。インサイダー取引については、このサーバーのget_insider_tradesとget_market_insider_buysを使用してください。

RESTエンドポイント

同じWorkerがREST APIも提供します(openapi.yamlを参照)。 /v1/insider-trades/{tickerOrCik}、/v1/insider-buys、/v1/filings/{tickerOrCik}、/v1/company/{tickerOrCik}/snapshot、/v1/company/{tickerOrCik}/facts、/v1/company/{tickerOrCik}/concept/{taxonomy}/{tag}、/v1/search、/v1/resolve/{tickerOrCik}、および/health。

ローカルで実行する

Node.js 18以降が必要です。ローカル開発にCloudflareアカウントは不要です。

npm install
npx wrangler dev --test-scheduled          # serves http://localhost:8787 (MCP at /mcp)
node test/unit.mjs                         # unit tests
node test/harness.mjs http://localhost:8787   # REST against live EDGAR
node test/mcp.mjs http://localhost:8787       # MCP: lists tools and calls each one
curl "localhost:8787/__scheduled?cron=*/10+*+*+*+*"   # run the insider-buy cron once

ローカルで使用するシークレットは、任意で.dev.varsに設定します(Gitの追跡対象外です。.dev.vars.exampleを参照)。

独自環境にデプロイする(Cloudflare Workers Free)

  1. npx wrangler login
  2. npx wrangler kv namespace create CACHEを実行し、表示されたIDをwrangler.tomlの[[kv_namespaces]]に設定します。
  3. SECの公正なアクセス要件に従い、wrangler.tomlのSEC_USER_AGENTを自身の名前と、受信確認可能なメールアドレスに設定します。
  4. npx wrangler deploy
  5. 任意:npx wrangler secret put MCP_API_KEYS(/mcpを保護)とnpx wrangler secret put RAPIDAPI_PROXY_SECRET(RESTを保護)を実行します。

Durable Objectのレートリミッター(SecRateLimiter)と*/10 * * * *のcronは、自動的に作成されます。

プロジェクトの構成

  • src/index.js: ルーターとRESTエンドポイント
  • src/sec.js: SECクライアント、グローバルレートリミッター(Durable Object)、キャッシュ
  • src/form4.js: Form 4 XMLパーサー
  • src/mcp/: MCPサーバー(tools.jsで7つのツールを定義)
  • test/: 単体テスト、ライブハーネス、MCPテスト、スキルワークフローのスモークテスト(skills.mjs)、サンプルレスポンス
  • kit/: クライアント設定、skills/: エージェントスキル、prompts/: プロンプトの例、docs/SETUP.md: セットアップガイド
  • server.json: MCPレジストリのメタデータ

ライセンス

MIT © 2026 MonRiah Studio。LICENSEを参照してください。

コメント

MCP は初めてですか?

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

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