Company filing and CVE evidence snapshots

企業提出書類およびCVEのエビデンススナップショット

無料の実験的な機能です。利用可能性は、保守的なコスト管理とソースの健全性管理によって制限されます。Retry-Afterと明示された対象範囲の不足に従ってください。

2種類の限定的な公開情報を検索する、無料のPhase A JSON APIです。

• company_snapshot： 既知のティッカーについて、現在のSEC提出書類イベントの状態を調べるために使用します。発行体／CIK、提出日、ソースリンクに加えて、明示的なソースのタイムスタンプ、対象範囲、有効期限を返します。財務諸表の抽出、決算説明会のトランスクリプト、幅広い株式調査には対応していません。GET /v1/company/{ticker}。最新の提出書類がインサイダーによる提出書類の場合があります。必ずしも決算発表とは限りません。
• cve_snapshot： 既知のCVE IDについて、現在のエビデンスを調べるために使用します。NVDのステータス、CISA KEVへの登録状況、FIRST EPSS、アドバイザリーリンクに加えて、明示的なソースのタイムスタンプ、対象範囲、有効期限を返します。資産への適用可否や、検証済みの修正方法には対応していません。GET /v1/cve/{cve}。

ベースURL：Fishnet

OpenAPI · MCP ツールの説明 · 機械可読な概要

通常の使用例：

curl 'https://agent-research-fishnet.walsh-datascience.workers.dev/v1/company/AAPL?via=github'
curl 'https://agent-research-fishnet.walsh-datascience.workers.dev/v1/cve/CVE-2024-3094?view=status&via=github'

選択した事実を簡潔に表示するには、view=statusを使用してください。facts.state_hashを保存し、後でview=statusとともにchanged_since=sha256:...として送信すると、選択した状態を比較できます。これはハッシュの比較であり、過去のタイムスタンプを照会するものではありません。方法論が変更された場合も、state hashは変わります。対象範囲とソースのタイムスタンプを確認してください。エビデンスを利用できない場合、比較結果は不明になります。パケットの有効期間は、企業情報が最大15分、CVE情報が最大60分で、さらに短い場合もあります。max_age_secondsは鮮度の許容範囲を指定するもので、ソースの更新を強制するものではありません。

パケットには、packet_key、生成／基準時点／有効期限のタイムスタンプ、ソースのバージョン、対象範囲の不足、データ／方法論／結果／規約のハッシュが含まれます。簡潔なレスポンスには、ベースラインに依存しないpacket_versionも含まれます。これらは限定的なメタデータの観測情報であり、独立したセカンドオピニオンのサービスでも、完全な調査を保証するものでもありません。

支払い、ウォレット、APIキー、個人識別情報は必要ありません。任意の不透明なX-Fishnet-Operator、X-Fishnet-Client、X-Fishnet-Agentの値を指定すると、日ごとにローテーションするHMACシグナルが生成されます。リクエストキー／時刻、キャッシュ状態、大まかなフレームワーク／チャネル、ステータス、レイテンシ、コスト単位が記録されます。アプリケーションのテレメトリーには、IPアドレス、生のユーザーエージェント、生のリファラー、生の呼び出し元IDは保持されません。シグナルから、独立した運用者であることは確認できません。生イベントの保持期間は14日間で、アクティブなトラフィックがあるときにクリーンアップされます。Cloudflareには独自のインフラストラクチャデータポリシーがあります。

統合テスト中はX-Fishnet-Test: trueを使用してください。これは、1日あたりのビルド予算と可用性制限がある無料の実験です。409／429／503のレスポンスでは、鮮度、予算、または可用性に関する制約が示されます。Retry-Afterに従ってください。一部の大きなSEC提出書類のレスポンスは、ソースの上限である4 MiBを超えるため、引き続き利用できません。集約型の安全管理では、個人識別情報を使わずに、リクエスト数、保守的なCPU予約量、利用可能なD1の行数／ストレージ指標を追加で記録します。安全管理によって拒否されたリクエストは、需要の成功を示すエビデンスとして扱われません。可用性は実験的です。SAM、FDA、決済機能は無効になっています。

任意の需要シグナル：desired_fieldsではOpenAPIに記載されたフィールド名を指定できます。history_daysでは0/1/7/30/90/365/3650、max_ageでは60/300/900/3600/86400秒を指定でき、compare_sourcesではtrue/falseを指定できます。これらは必要な情報を宣言するものであり、新たなデータを作り出すものではありません。サポートされていない制御付きの履歴／フィールド／比較の要求には、HTTP 422 unsupported_capabilityとともに、利用可能な現在の状態の機能、および任意のフィードバックアクションが返されます。任意のルート／クエリ値が保持されることはありません。識別可能な未サポートの試行は、大まかなカテゴリに変換されます。 任意のフィードバック：次回のツール呼び出しを減らすには、どのような追加データや機能があればよかったですか？ 成功したパケットには、有効期限付きのパケットにひも付いたトークン、必須のパケットキー／バージョン／エンドポイント、今後利用できる可能性がある機能の候補メニューresearch_candidateを含むfeedback_requestが含まれます。これらの候補は、現在提供されている製品ではありません。スキーマ2.0をPOST /v1/feedbackに送信するか、任意のMCPツールsubmit_fishnet_feedbackを明示的に呼び出してください。feedback_typeと、任意のnext_action_without_fishnet、usage_reason、希望する機能／フィールド／履歴／鮮度、重要度、または申告された利用頻度／価格を含めてください。V1 HTTPクライアントも引き続きサポートされます。再構成したハッシュではなく、指定されたパケットバージョンを使用してください。トークンが証明するのはパケットとの関連付けのみであり、呼び出し元の独立性や基礎データの鮮度ではありません。

最大2,048バイトのJSON UTF-8データ、および240バイトのUTF-8テキストです。個人データ、URL、シークレット、プロンプト全文は含めないでください。安全でないテキストは拒否されます。受理された自由記述テキストは分類後に破棄され、保存されません。制御されたフィードバックフィールドは別途14日間保存され、定期的なクリーンアップが実行されます。呼び出し元のシグナルには同じ日次HMACが使用されます。重複送信も予算を消費します。上限は、全体で1日100件、任意のシグナルごとに10件、匿名ユーザー共通で20件です。フィードバックと申告された利用頻度／価格は自己申告であり、購入や検証済みの需要を示すものではありません。任意のフィードバックが自動的に送信されたり、機能の開発につながったりすることはありません。コアパケットはフィードバックなしでも引き続き利用できます。

MCP： バージョン0.2.0 MCPBリリース、Node.js 22以降、stdioトランスポート。スナップショットツール2つと任意のフィードバック送信機能があります。ローカルバンドルは、以下のリモートURLと併用できる任意のものです。フィードバックツールは、上限付きのテレメトリーを書き込み、その旨が明示的に注釈されています。以前の0.1.0リリースも引き続き利用できます。

リモート MCP — Fishnet のローカルインストール不要

Streamable HTTP を使用して https://agent-research-fishnet.walsh-datascience.workers.dev/mcp に接続します。匿名で利用できる無料の Phase A アクセスです。API キーやウォレットは不要です。互換性のあるクライアントであっても、URL を把握または検出し、アクセスを承認または設定する必要があります。レジストリに公開されていても、自動検出やツール選択が保証されるわけではありません。

ツール：company_snapshot、cve_snapshot、および明示的に任意の submit_fishnet_feedback。スナップショットの引数とパケットのセマンティクスは REST API と同一です。フィードバックの送信はテレメトリーを書き込み、読み取り専用でも冪等でもなく、自動実行されることはありません。

プロトコル 2026-07-28 では、リクエストごとのメタデータ（io.modelcontextprotocol/protocolVersion、clientInfo、clientCapabilities）と、それに一致する MCP-Protocol-Version、Mcp-Method、および tools/call の場合は Mcp-Name ヘッダーを使用します。server/discover は任意です。tools/list または既知のスキーマを使用した tools/call を直接呼び出せます。ステートレスな旧バージョン 2025-11-25 および 2025-06-18 は、initialize → notifications/initialized → tools/list → tools/call に対応しています。リクエストでは Content-Type: application/json と Accept: application/json, text/event-stream を使用し、結果は JSON です。

セッションは発行されません。GET/DELETE ストリーム、リソース、プロンプト、サブスクリプション、バッチ処理、サンプリング、および拡張メソッドには対応していません。Origin を含まないサーバークライアントは動作します。ブラウザーの Origin はサービスの Origin と完全に一致する必要があります。ワイルドカード CORS はありません。RPC リクエスト本文の最大サイズは 4,096 UTF-8 バイト、ネストの深さは 12、本文の読み取り時間は 5 秒です。フィードバックには、さらに小さい制限が適用されます。リクエストが拒否されても、ソースのビルドは実行されません。

MCP の HTTP リクエスト 1 件を、計上対象のインタラクション 1 件として扱います。大まかなルート、プロトコルファミリー、段階、ツール、結果は、既存の 14 日間のイベントストリームに保持されます。RPC ID、未加工の clientInfo、Origin、未加工の本文／パス／クエリー、プロンプトは保存されません。制限付きの診断情報には、対応するプロトコルバージョンの正確な値、自己申告されたクライアントファミリーの大まかな分類、認識されたケイパビリティフラグ、トレースコンテキストの有無のみ、カタログの生成、ツール選択と引数形式のカテゴリが含まれます。トレース値やクライアントのバージョンは保持されません。また、これらのカテゴリによってクライアントが認証されたり、セッションが関連付けられたりすることはありません。isError: true を含む HTTP 200 はアプリケーションエラーであり、有用なパケット利用ではありません。基盤となるカバレッジやソースの不足は、引き続き明示されます。エラーとバックオフを尊重してください。全体に適用される安全制限により、サービスが一時停止する場合があります。トランスポート固有の障害が発生すると、リモート MCP は無効になりますが、計上処理が正常であれば REST は引き続き利用できます。

公式レジストリのリリース 0.3.0 ではリモートアドレスが追加され、変更されていない 0.2.0 stdio MCPB も引き続き提供されます。既存のリリースが上書きされることはありません。