signalfeed

signalfeed

12 種類の米国提出書類イベントストリームを、1 つのスキーマと 1 つのキーで。 signalfeed は DataSignals Events API 用の小規模なクライアントです。この API は公式提出書類を解析し、スコア付きの、 意思決定にすぐ活用できるイベントレコードに変換します。対象となるのは、インサイダーによる買い集め、 計画的なインサイダー売却（Form 144）、アクティビストの持ち分 （13D/G）、機関投資家の保有状況（13F）、重要イベント （8-K）、未公開企業の資金調達（Form D）、FDA の措置、バイオテックの 臨床試験カタリスト、NIH の助成金、連邦政府の契約受注、 議会議員の取引、採用シグナルです。すべてのレコードは解析元の提出書類にリンクし、スコアが付くレコードには、 そのスコアの算出に使われた用語も含まれます。

フィードはカーソルベースです。レスポンスのカーソルを since として渡すと、それ以降に届いたものだけが 重複や欠落なく取得できます。レスポンスは API が返した内容そのままで、 途中で切り詰めたり、名前を変更したり、要約したりすることはありません。

設定

• DATASIGNALS_KEY — API キーです。キーが必要なツールで必須です。これらのリクエストでは Authorization: Bearer <key> として送信され、クエリパラメーターとして送信されることはありません。そのため、サーバーログやブラウザーの履歴に残りません。キー不要のツールでは送信されません。
• DATASIGNALS_BASE_URL（任意）— API のベース URL です。 デフォルトは https://datasignalslab.com です。

キーが必要なツールをキーなしで呼び出すと、リクエストを送信する前にローカルで DATASIGNALS_KEY is not set が返されます。キーなしで使えるツールは list_event_types と feed_health の 2 つです。これらを使えば、データの構造や 鮮度を確認してから利用を決められます。

ツール

• search_events — 12 種類すべてのストリームから提出書類イベントを検索します。フィルターはすべて任意です。 event_type（12 種類のストリーム ID のいずれか）、 ticker、cik、min_score に加えて、 since（前回のレスポンスのカーソル）とページ分割用の limit を指定できます。設定したフィルターのみが送信されます。
• company_events — すべてのストリームから、1 社に関する提出書類を取得します。 company にはティッカーまたは CIK を指定します。 since と limit で結果をページ分割できます。
• get_event — event_id で指定した 1 件のイベントに関するすべての情報を表示します（例： insider_cluster:CAMP:2026-08-03）。
• list_event_types — 各ストリームが含むフィールドと、スコアを再計算できるかどうかを確認します。 キーなしで使えます。
• feed_health — 現時点での各ストリームの最新状況を確認します。 キーなしで使えます。
• usage — 月間イベント利用枠の使用量と、リセット日時を確認します。
• check_setup — API キーが設定されているか、フィードに応答があるかを確認します。常に JSON オブジェクト {key_configured, feed_reachable, detail} を返します。キーの値は表示されず、チェック自体がキーを送信することもありません。

知っておくと便利な動作：

• 利用枠を使い切ったフィードでも、同期の途中でエラーにはなりません。カーソルをそのまま保持した空のページを 200 で返し、 通常の通知を含めます。signalfeed は、他のページと同様にそのまま渡します。
• API はアイドル時にゼロまでスケールします。しばらくリクエストがなかった後の最初のリクエストでは、起動中に starting_up の応答が返ることがあります（Retry-After ヘッダー付き）。起動には約 15 秒かかる場合があります。signalfeed は その本文をエラーではなく通常の結果として返し、この呼び出しは利用枠にカウントされません。 もう一度呼び出してください。
• それ以外の 2xx 以外の応答では datasignals error: HTTP <status> が返され、API に接続できない場合は datasignals unreachable が返されます。

エンドポイントの出典

ベンダーの Events API ページには、エンドポイント、フィルター名、カーソルモデル、12 個のストリーム ID が記載されています。元の MCP プロジェクトの README には、7 つのツール、2 つの環境変数、Bearer ヘッダーによる認証ルール、認証キー不要の 2 つのツールが記載されています。MCP 層の引数名は、文書化された API 名に準拠しています（MCP 層自体は公開されていないため、ラベル付きの再構成です）。

• 設定されたフィルターのみをクエリパラメーターとして指定する GET <base>/v1/events（search_events で使用）。
• since／limit が設定されている場合にそれらを指定する GET <base>/v1/companies/{ticker or cik}/events（company_events で使用）。
• GET <base>/v1/events/{event_id}（get_event で使用）。
• GET <base>/v1/event-types（list_event_types で使用。認証キー不要）。
• GET <base>/v1/health（feed_health と check_setup で使用。feed_health は認証キー不要）。
• GET <base>/v1/usage（usage で使用）。

event_id と company のパスセグメントは URL エンコードされます。

CLI

各ツールは、JSON 引数文字列を 1 つ受け取るサブコマンドです。

npx @reneturcios/signalfeed search_events '{"event_type":"fda_action","min_score":70}'
npx @reneturcios/signalfeed company_events '{"company":"NVDA"}'
npx @reneturcios/signalfeed get_event '{"event_id":"insider_cluster:CAMP:2026-08-03"}'
npx @reneturcios/signalfeed list_event_types '{}'
npx @reneturcios/signalfeed feed_health '{}'
npx @reneturcios/signalfeed usage '{}'
npx @reneturcios/signalfeed check_setup '{}'
npx @reneturcios/signalfeed --version

出力はツールの結果テキストです（成功時は上流のレスポンス本文）。終了コード：成功時は 0、実行時エラー時は 1、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/signalfeed mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "signalfeed": {
      "command": "npx",
      "args": ["-y", "@reneturcios/signalfeed", "mcp"],
      "env": {
        "DATASIGNALS_KEY": "<your key>"
      }
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/signalfeed
docker run --rm ghcr.io/cloudcorprecords/signalfeed feed_health '{}'

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios