Reporting Window Finder

Reporting Window Finder MCP 服务

Mamba Labs 在 Apify 上的 Reporting Window Finder actor 的 MCP 服务。

输入域名、股票代码、ISIN、LEI 或 CIK，即可了解这家上市公司何时发布报告，以及适合在何时联系该公司：财年结束时间、报告频率、下一次报告日期、距离事件的天数，以及你定义的联系窗口的开始和结束时间。

时间信息仅涵盖美国公司。 身份、交易场所和分类信息可在全球范围内为可发布的公司解析。报告日期来自美国 SEC 的申报历史，仅适用于美国公司。非美国公司可以完整解析，并会返回明确说明的 timing_unavailable_reason，而不是猜测日期；由于查询已运行，该公司仍会计为一条时间信息记录。

五种工具，分别对应一种 actor 模式

工具	接受	返回
resolve_company	标识符	身份和交易场所，44 个字段
qualify_company	标识符	上市状态判定
get_reporting_timing	标识符	财年结束时间、报告频率、下一次事件、联系窗口，75 个字段
build_company_universe	筛选条件	公司列表
get_reporting_season	筛选条件	按周或按月统计的报告量

你无需传入 mode。每种工具都会设置该参数，并且只公开其模式实际使用的输入项。

build_company_universe 和 get_reporting_season 根据筛选条件生成列表，不接受公司标识符。请为这两种工具显式设置 limit：默认值为 1000，按返回的行数计费。

参数

除非工具另有说明，否则所有参数均为可选。Tools 列列出了接受该参数的工具。

参数	类型	工具	描述
company_domain	string	resolve_company、qualify_company、get_reporting_timing	单个不带其他内容的域名，例如 stripe.com。适用于 Clay 列的格式。用于解析、资质判定和时机查询。
company_domains	string[]	resolve_company、qualify_company、get_reporting_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[]	全部五个工具	ISO 10383 MIC。覆盖 18 个交易场所。
country_codes	string[]	全部五个工具	ISO 3166-1 alpha-2，例如 US、GB、FR。
regions	string[]	全部五个工具	代表一组交易场所和国家的简写：us、uk、eu。扩大明确指定的交易所或国家筛选范围，而非取而代之。
sectors	string[]	全部五个工具	SEC SIC 行业描述，例如 Pharmaceutical Preparations。约 65% 可发布范围内的公司有此字段。
security_types	string[]	全部五个工具	ordinary_shares、depositary_receipt、preferred_shares。
public_float_bands	string[]	全部五个工具	micro、small、mid、large、mega、unknown。由于本数据集中没有任何地方提供市值，规模按公众持股量划分。
fiscal_year_end_months	string[]	全部五个工具	1 到 12 的整数。本数据集中的财年结束月份实际上仅适用于美国公司。
exclude_december_fiscal_year_end	string（false、true）	全部五个工具	仅保留财年在非 12 月月份结束的公司，即预算周期与日历季度错开的公司。
cadences	string[]	全部五个工具	quarterly、semiannual、annual、unknown。
operating_companies_only	string（false、true）	全部五个工具	排除基金、信托及其他非运营实体。
exclude_blank_checks	string（false、true）	全部五个工具	排除交易前的 SPAC。此筛选项独立于运营公司筛选：空白支票壳公司会被标记为运营公司，因此会通过所有常规公司信息筛选。
foreign_private_issuer	string（any、only、exclude）	全部五个工具	按外国私人发行人状态筛选。
us_registrant_only	string（false、true）	全部五个工具	仅保留具有 SEC CIK 的公司。
min_provenance_confidence	string（any、high）	全部五个工具	设为 high，以排除从未读取过来源条款的行。
exclude_name_only_matches	string（false、true）	全部五个工具	排除仅凭名称和国家一致、而非标识符建立身份关联的行。凡是错误身份关联会造成影响的场景，都应使用此选项。
exclude_share_alike	string（false、true）	全部五个工具	排除源自 CC BY-SA 来源的行，其相同方式共享条件可能不适用于封闭产品。
listed_only	string（false、true）	qualify_company	资质判定模式。仅保留已确认公开上市的行。
suppress_listed	string（false、true）	qualify_company	资质判定模式。排除已确认公开上市的公司，适用于仅向私营公司销售的情况。此选项会排除我们能够确认已上市的公司，但不能保证其余公司都是私营公司。
assume_unmatched_is_private	string（false、true）	qualify_company	资质判定模式。默认情况下，未匹配的公司会返回 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。报告频率置信度低于此值的行会返回包含明确原因的空时机信息块，而非猜测。季度报告频率的平均置信度为 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_split_by	string（none、sector、country、exchange_code）	get_reporting_season	报告季模式。可选的第二个维度。
season_from	string	get_reporting_season	报告季模式。ISO 日期。默认为今天。
season_to	string	get_reporting_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 上按事件付费，按返回的行数计费，而非筛选掉的行数。

事件	价格
公司已解析	每行 $0.006
返回时间行	每行 $0.012
报告季汇总	每行 $0.05
Actor 启动	每次运行 $0.00005

Apify Bronze、Silver 和 Gold 计划分别提供 5%、10% 和 15% 的批量折扣。时间行不会再按已解析公司额外计费。

Mamba Labs GTM Suite 的组成部分

在 Apify 上浏览完整套件。

许可证

MIT