データや分析をリクエスト

必要だったのに見つからなかったものをお知らせください。リクエストは毎週のレビューで確認し、類似のものを統合します。公開情報源で対応できるデータのうち、要望が最も多いものから実装します。

リクエストするタイミング

必要なデータセット、項目、企業、分析がない場合や、回答が誤っていると思われる場合にリクエストを送信してください。人はフォームを、エージェントはAPIまたはMCPサーバーを使用します。どちらも同じキューに届き、同じ制限が適用されます。

ターミナルでデータが空、対象外、または企業が不明と表示される各画面の末尾には、フォームに内容を自動入力する「リクエストする」リンクがあります。コマンドパレットにも「データや分析をリクエスト」が表示されます。

種類

種類	用途
`dataset`	未提供のデータセット全体
`field`	1つの財務項目や属性
`analysis`	手作業で行う必要があった計算
`coverage`	対象外の企業、取引所、国
`bug`	誤った回答や正常に機能しない回答
`other`	その他

フォームを使う

データや分析をリクエストフォームでは、種類、必要なもの、理由（任意）、企業（任意）を入力します。テキストに個人情報を含めないでください。

リクエストIDはすぐに発行されます。後で状況を確認できるよう、保管してください。

APIから送信する

POST /v1/request-dataはkindとwantを受け取り、任意でwhy、company、endpoint_or_toolも受け取ります。キーは不要で、課金されることはありません。

curl -X POST "https://api.financial.md/v1/request-data" -H "content-type: application/json" \
  -d '{"kind":"dataset","want":"Segment operating margin by quarter","why":"Comparing business lines","company":"ticker:AAPL"}'

レスポンスは201で、リクエストID、統合先の要望項目、そのステータス、これまでのリクエスト数が含まれます。

{
  "data": {
    "request_id": "0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11",
    "item_id": "7c2e0d4b-31a9-4f57-9a3e-5d0b8c1f2a64",
    "status": "new",
    "requests": 3,
    "requesters": 2,
    "status_url": "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11",
    "served_by": null
  },
  "meta": { ... }
}

UTCの1日あたり、アドレスごとに最大10件、全体で500件までリクエストできます。いずれかの上限を超えると、レスポンスはRetry-After付きの429になります（rate_limitedを参照）。GET /v1/request-dataで本文の仕様を確認できます。

エージェントから送信する

MCPサーバーには、このためのツールが2つあります。request_dataは同じフィールドを使ってリクエストを送信し、request_statusはIDでリクエストを検索します。APIで要望を満たせない回答には、種類がrequest_dataの対処方法が含まれるため、エージェントが行き詰まることはありません。

https://mcp.financial.md/mcp

状況を確認する

類似のリクエストは、種類、企業、概念をキーとする1つの要望項目に統合されます。同じリクエストを繰り返すと、票が追加されます。ステータスページまたはGET /v1/request-data/{id}で確認できます。

curl "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"

ステータス	意味
`new`	受信済み、未確認
`triaged`	確認済み、類似のリクエストと統合済み
`planned`	実装を予定しています
`done`	実装済み。`served_by` に、提供するルートまたはツールの名前を記載
`wontfix`	実装しません。理由は公開メモに記載

リクエストと提供済み機能

リクエストと提供済み機能ページには、当社の担当者が確認してタイトルを付けた項目を、件数および対応結果とともに掲載しています。項目が自動的に掲載されることはありません。表示されるのは集計情報のみで、送信者や送信された文章は表示されません。同じデータを JSON フィードでも提供しています：

curl "https://api.financial.md/v1/requested"

変更履歴には一覧へのリンクがあり、提供済みの各項目には、それを提供する機能の名前が記載されています。

実装できるもの

無料の公開情報源と、それらから導き出した独自の分析を基に実装します：

SEC EDGAR の提出書類とデータセット（財務諸表、保有状況、イベント、ファンド）
FRED およびその他の公開統計
提供済みデータを用いた計算（比率、スクリーニング、比較）

コンセンサス予想、アナリスト評価、取引所のリアルタイムデータフィードなど、ライセンスが必要なデータや利用規約で再利用が禁止されているデータには、GET /v1/coverage を参照するメモを付けて wontfix と表示します。その後も同じデータへのリクエストは投票として集計されるため、何が求められているかを把握できます。

プライバシー

リクエストでは個人データを求めません。送信元アドレスは、制限を適用するために、ソルト付きダイジェストとしてのみ保存されます。

現在、フォームではメールアドレスを求めていません。リクエストはその id で追跡してください。今後、返信用メールアドレスの登録機能を提供する場合も、登録は任意であり、チェックボックスを選択した場合にのみ送信され、リクエストとは別に保存されます。用途はリクエストの提供開始または終了の通知に限られ、リクエストの終了時または 365 日後に削除され、共有されることはありません。プライバシーをご覧ください。