Reporting Window Finder

Reporting Window Finder MCP サーバー

Apify 上の Mamba Labs の Reporting Window Finder アクター向け MCP サーバーです。

ドメイン、ティッカー、ISIN、LEI、または CIK を指定すると、その上場企業の報告時期と、その前後で連絡を取るタイミングを確認できます。会計年度末、報告頻度、次回の報告日、イベントまでの日数、そして指定した営業期間の開始日と終了日がわかります。

タイミング情報の行は米国企業のみを対象としています。 識別情報、取引市場、分類は、公開可能な対象全体について世界中の企業を解決します。報告日は米国 SEC への提出履歴に基づくため、米国企業のみ取得できます。米国以外の企業は正しく解決され、推測した日付ではなく timing_unavailable_reason が返されます。また、ルックアップが実行されるため、タイミング情報の行として課金されます。

5 つのツール、それぞれアクターのモードに対応

ツール	受け取るもの	返すもの
resolve_company	識別子	識別情報と取引市場、44 フィールド
qualify_company	識別子	上場状況の判定
get_reporting_timing	識別子	会計年度末、報告頻度、次回イベント、営業期間、75 フィールド
build_company_universe	フィルター	企業リスト
get_reporting_season	フィルター	週または月ごとの報告件数

mode を渡す必要はありません。各ツールがモードを設定し、それぞれのモードで実際に使用する入力だけを受け付けます。

build_company_universe と get_reporting_season はフィルターからリストを作成するため、企業識別子は受け付けません。どちらも limit を明示的に設定してください。デフォルトは 1000 で、返された行数ごとに課金されます。

パラメーター

ツールに特段の記載がない限り、すべてのパラメーターは任意です。「ツール」列には、そのパラメーターを受け付けるツールが記載されています。

パラメーター	型	ツール	説明
company_domain	string	resolve_company, qualify_company, get_reporting_timing	単一のドメイン（例：stripe.com）。Clay の列形式です。resolve、qualify、timing で使用します。
company_domains	string[]	resolve_company, qualify_company, get_reporting_timing	複数のドメインを一度に指定します。resolve、qualify、timing で使用します。
tickers	string[]	resolve_company, qualify_company, get_reporting_timing	取引所のティッカー（例：NWLG）。主要ティッカーおよびすべての取引所の上場銘柄と照合します。
isins	string[]	resolve_company, qualify_company, get_reporting_timing	12 文字の ISIN です。
leis	string[]	resolve_company, qualify_company, get_reporting_timing	20 文字の法人識別子です。
ciks	string[]	resolve_company, qualify_company, get_reporting_timing	SEC の中央インデックスキーです。先頭のゼロはあってもなくてもかまいません。
company_names	string[]	resolve_company, qualify_company, get_reporting_timing	法的名称または商号です。正規化された名称で照合します。旧称は利用できません。別名テーブルに含まれるのはティッカーと ISIN のみです。
exchange_codes	string[]	5 つすべて	ISO 10383 MIC です。18 の取引所を対象としています。
country_codes	string[]	5 つすべて	ISO 3166-1 alpha-2（例：US、GB、FR）です。
regions	string[]	5 つすべて	取引所と国のセットを表す略記です：us、uk、eu。明示的な取引所または国のフィルターを置き換えるのではなく、対象を広げます。
sectors	string[]	5 つすべて	SEC SIC の説明（例：Pharmaceutical Preparations）です。公開可能な対象の約 65 パーセントに設定されています。
security_types	string[]	5 つすべて	ordinary_shares、depositary_receipt、preferred_shares です。
public_float_bands	string[]	5 つすべて	micro、small、mid、large、mega、unknown です。このデータセットでは時価総額がどこにも設定されていないため、規模は公開浮動株を基準とします。
fiscal_year_end_months	string[]	5 つすべて	1 から 12 までの整数です。このデータセットでは、会計年度末は実質的に米国の項目です。
exclude_december_fiscal_year_end	string (false, true)	5 つすべて	会計年度末が 12 月以外の企業のみを残します。つまり、予算サイクルが暦四半期とずれている企業です。
cadences	string[]	5 つすべて	quarterly、semiannual、annual、unknown です。
operating_companies_only	string (false, true)	5 つすべて	ファンド、信託、その他の非事業体を除外します。
exclude_blank_checks	string (false, true)	5 つすべて	取引前の SPAC を除外します。事業会社フィルターとは別の設定です。白地小切手会社は事業会社としてフラグ付けされ、通常の企業属性フィルターをすべて通過します。
foreign_private_issuer	string (any, only, exclude)	5 つすべて	外国民間発行体のステータスでフィルタリングします。
us_registrant_only	string (false, true)	5 つすべて	SEC の CIK が付与されている企業のみを残します。
min_provenance_confidence	string (any, high)	5 つすべて	high に設定すると、ソースの利用条件が一度も確認されていない行を除外します。
exclude_name_only_matches	string (false, true)	5 つすべて	識別子ではなく、名称と国の一致に基づいて本人確認されている行を除外します。誤った本人確認が問題となる場合は、常に使用してください。
exclude_share_alike	string (false, true)	5 つすべて	CC BY-SA ソース由来の行を除外します。その継承条件はクローズドな製品に適さない場合があります。
listed_only	string (false, true)	qualify_company	qualify モードです。上場が確認されている行のみを残します。
suppress_listed	string (false, true)	qualify_company	qualify モードです。非公開企業のみを対象に販売する場合に、上場が確認されている企業を除外します。上場していると確認できる企業は除外しますが、残りが非公開企業であることを保証するものではありません。
assume_unmatched_is_private	string (false, true)	qualify_company	qualify モードです。デフォルトでは、照合できない企業の is_listed は null になります。照合できない理由は、企業が非公開であるため、またはそのドメインを保有していないためのいずれかです。true に設定すると、照合できない場合に非公開とみなし、is_listed を false に設定します。
event_types	string[]	get_reporting_timing, get_reporting_season	full_year_results、half_year_results、quarterly_results、trading_update、annual_report_publication、sustainability_report_publication、agm、proxy_filing、capital_markets_day です。
window_lead_days	string	get_reporting_timing	イベントの何日前にアプローチ期間を開始するかを指定します。デフォルトは 70 です。
window_lag_days	string	get_reporting_timing	イベントの何日前にアプローチ期間を終了するかを指定します。デフォルトは 42 です。リード日数より小さくする必要があります。
window_statuses	string[]	get_reporting_timing	次の期間ステータスに該当する行のみを残します：open、not_yet、closed_passed、no_event。
max_days_to_event	string	get_reporting_timing	次のイベントまでの日数がこの値を超える行を除外します。コスト管理に使用します。
min_cadence_confidence	string	get_reporting_timing	0 から 1 までの値です。報告頻度の信頼度がこの値を下回る行では、推測値ではなく、理由を示したうえでタイミングブロックが null になります。四半期ごとの報告頻度の平均信頼度は 0.94、年次は 0.40、半年ごとは 0.21 です。
include_constrained_period	string (true, false)	get_reporting_timing	上場企業が発表できる内容に制限を受ける期間を出力します。同じウィンドウの日数から算出されます。キャンペーンや発表のタイミング設定に便利です。
limit	string	build_company_universe, get_reporting_season	ユニバースとシーズンの最大行数です。切り捨てが発生した場合は必ず報告され、黙って処理されることはありません。
season_group_by	string (week, month)	get_reporting_season	season モードです。グループ化する期間単位です。
season_split_by	string (none, sector, country, exchange_code)	get_reporting_season	season モードです。任意の第 2 軸です。
season_from	string	get_reporting_season	season モードです。ISO 日付です。デフォルトは今日です。
season_to	string	get_reporting_season	season モードです。ISO 日付です。デフォルトは今日から 180 日後です。

インストール

{
  "mcpServers": {
    "mamba-public-company-reporting-window-finder": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-public-company-reporting-window-finder"],
      "env": { "APIFY_TOKEN": "your-apify-token" }
    }
  }
}

console.apify.com/account/integrationsでトークンを取得してください。

出力の読み方

日付は予測値であり、発表済みの日付ではありません。 next_event_is_estimate は、提出履歴から算出した日付の場合に true になります。confidence_band は 0.80 と 0.50 を基準としており、チェーン内で最も弱いリンクに基づいて計算されます。そのため、confidence_effective はイベントと周期の信頼度の平均ではなく、その最小値になります。

フィルターには window_status フィールドを使用してください。 今日を基準に、値は open、not_yet、closed_passed、no_event のいずれかです。no_event は、ウィンドウの基準となる報告イベントがない企業に割り当てられる状態です。

周期が不明な場合は推測せず、結果を返しません。 提出履歴が短すぎる、または不規則な企業の場合は、架空の日付を生成せず、理由とともに周期を null として返します。

何も解決できない行も課金対象です。 公開企業に一致しない識別子の場合、match_method は no_match になり、その他のフィールドはすべて null になります。これは有効な回答であり、結果を返すために照合が実行されています。

料金

Apifyではイベントごとに課金され、フィルタリングで除外された行ではなく、返された行が課金対象です。

イベント	料金
企業の特定	1行あたり $0.006
タイミング行の返却	1行あたり $0.012
報告シーズンの集計	1行あたり $0.05
Actorの起動	1回あたり $0.00005

ApifyのBronze、Silver、Goldプランでは、利用量に応じて5％、10％、15％の割引が適用されます。タイミング行が、特定済み企業として追加で課金されることはありません。

Mamba Labs GTM Suiteの一部

Apifyでスイート全体を見る。

ライセンス

MIT