vigia-edgar

vigía EDGAR — 常時稼働の SEC EDGAR ウォッチャー（Form 4／8-K アラート）

一般公開用の紹介文とクイックスタートは mcp/README.md にあります。 このルート README は、 2 層システム（エンジン＋スキン）の開発者向け／アーキテクチャ向けドキュメントです。

米国 SEC EDGAR を常時監視し、SEC がインサイダーの Form 4 または企業の 8-K を受理してから約 45 秒後（中央値、 最悪でも約 2 分以内 — 高速ポーリングであり、瞬時／リアルタイムではありません）にアラートをキューに追加するエンジンです。ティッカーのウォッチリスト（AAPL、TSLA、NVDA…）を設定すると、Claude、Cursor、または任意の MCP クライアントで AI エージェントが インサイダー取引や重要イベントのアラートを受け取れます。ユーザー側での設定は不要です。無料プラン：ティッカー 1 件。Pro（$29）：ティッカー無制限。

遅延について、正確にお伝えします： SEC が提出書類を受理してから中央値で約 45 秒、 最悪でも約 2 分以内です（EDGAR の getcurrent フィードで測定）。エンジンは高速でポーリングし、 決してスリープしません。

MCP サーバーが必要な理由（優位性）

LLM エージェント単独では、EDGAR を 24 時間 365 日監視できません。ここでの価値は、決してスリープしないインフラです。cron 駆動のエンジンが SEC を継続的にポーリングし、各提出書類の重複を排除して、ユーザーごとのカーソルを保持するため、エージェントには常に新しい情報だけが表示されます。エージェントが要求するだけでよく、エンジンはすでに監視しています。

ツール

watch_insider(tickers: string[])

監視する米国のティッカーを登録します（Form 4 ＋ 8-K）。各ティッカーを SEC CIK に解決して、監視を開始します。解決したリストと、見つからなかったティッカーを返します。

get_alerts()

監視対象のティッカーについて、前回の呼び出し以降に検出された新しい提出書類を返します（ユーザーごとのカーソルが自動的に進むため、重複は発生しません）。各アラートには、ticker、company、 formType、category（insider | material_event）、accession、acceptanceTime、 detectedTime、latencySeconds、および提出書類への直接リンク filingUrl が含まれます。

アーキテクチャ

2 つのレイヤーで構成されています。

• エンジン（Cloudflare Worker ＋ D1）： cron トリガーが毎分 EDGAR の getcurrent Atom フィードをポーリングします （1 回のティックにつき約 30 秒間隔で 2 回ポーリング → 実効頻度は約 30 秒）。accession 番号の重複を排除し、 CIK で監視対象企業に提出書類を照合します（社名変更にも対応）。照合結果は D1 に保存されます。状態：seen（重複排除）、watches（ユーザーごとの CIK）、alerts、cursors（ユーザーごとの配信状態）、 ticker_map（company_tickers.json から毎日更新）。
• スキン（この MCP サーバー、MCPize でホスト）： 2 つのツールを公開し、認証済み HTTP API（/watch、/alerts）経由でエンジンに読み書きします。認証と課金は MCPize が処理します。

ユーザーごとの分離：MCP サーバーの設定で WATCH_NAMESPACE（独自のキー）を設定すると、ウォッチリストとカーソルを非公開にできます。デフォルトは default です。

SEC への準拠

SEC へのすべてのリクエストで、識別可能な必須の User-Agent を使用し、毎秒 10 リクエストの上限を十分に下回るようにしています（EDGAR フィードのポーリングは cron サイクルごとに 1 回です）。

設定（環境変数／シークレット）

• WORKER_URL — Cloudflare エンジンのベース URL。
• VIGIA_KEY — スキンがエンジンを呼び出すための共有シークレット。
• WATCH_NAMESPACE — ユーザーごとのウォッチリスト名前空間（任意。デフォルトは default）。

ファネルの計測

エンジンは D1 の funnel テーブルで 4 つのプロダクト指標をカウントします（名前空間ごとに集計行 1 件、冪等な upsert — コストは無視できる程度です）。

1. installs — 名前空間が MCP に接続した（初回の /watch）
2. activations — 実際に利用した（ティッカーを解決した、または /alerts を取得した）
3. wall_hits — 無料プランのティッカー 1 件上限に達した（Pro への需要）
4. conversions — 有料から Pro 有効状態への移行（Stripe で検証済み）

指標の確認（管理者用。X-Vigia-Key が必要）：

GET /admin/funnel            -> { funnel: { installs, activations, wall_hits, total_wall_hits, conversions } }
GET /admin/funnel?detail=1   -> also returns per-namespace rows

または D1 から直接確認します：

SELECT COUNT(installed_utc)  installs,
       COUNT(activated_utc)  activations,
       COUNT(first_wall_utc) wall_hits,
       COUNT(converted_utc)  conversions
FROM funnel;

リポジトリ構成

worker/   Cloudflare Worker engine (cron + D1)  — npx wrangler deploy
mcp/      MCPize MCP server (the 2 tools)        — npx mcpize deploy