Public Company Reporting Window Finder

Servidor MCP de Datas de Divulgação de Resultados e Janela de Relatórios para Empresas de Capital Aberto

Servidor MCP para o ator Public Company Earnings Dates and Reporting Window Finder da Mamba Labs no Apify.

Forneça um domínio, ticker, ISIN, LEI ou CIK e ele informa quando essa empresa de capital aberto divulga seus resultados e quando entrar em contato em torno disso: fim do ano fiscal, cadência de divulgação, próxima data de divulgação, dias até o evento e a abertura e fechamento de uma janela de contato que você define.

As linhas de timing cobrem apenas empresas dos EUA. Identidade, local de negociação e classificação são resolvidos mundialmente no universo publicável. As datas de divulgação vêm do histórico de arquivamentos da SEC dos EUA e existem apenas para empresas dos EUA. Uma empresa não americana é totalmente resolvida e retorna um timing_unavailable_reason declarado em vez de uma data estimada, e ainda é cobrada como uma linha de timing porque a consulta foi executada.

Cinco ferramentas, uma por modo do ator

Ferramenta	Recebe	Retorna
resolve_company	identificadores	identidade e local de negociação, 44 campos
qualify_company	identificadores	um veredito de status de listagem
get_reporting_timing	identificadores	fim do ano fiscal, cadência, próximo evento, janela de contato, 75 campos
build_company_universe	filtros	uma lista de empresas
get_reporting_season	filtros	carga de divulgação por semana ou mês

Você nunca passa mode. Cada ferramenta o define, e cada ferramenta expõe apenas as entradas que seu modo realmente usa.

build_company_universe e get_reporting_season constroem uma lista a partir de filtros e não aceitam identificadores de empresa. Defina limit explicitamente em ambos: o padrão é 1000 e você é cobrado por linha retornada.

Parâmetros

Todo parâmetro é opcional, a menos que uma ferramenta diga o contrário. A coluna Ferramentas nomeia as ferramentas que o aceitam.

Parâmetro	Tipo	Ferramentas	Descrição
company_domain	string	resolve_company, qualify_company, get_reporting_timing	Um único domínio simples, ex.: stripe.com. O formato da coluna Clay. Usado por resolve, qualify e timing.
company_domains	string[]	resolve_company, qualify_company, get_reporting_timing	Muitos domínios de uma vez. Usado por resolve, qualify e timing.
tickers	string[]	resolve_company, qualify_company, get_reporting_timing	Tickers de bolsa, ex.: NWLG. Correspondidos contra o ticker principal e cada listagem de local de negociação.
isins	string[]	resolve_company, qualify_company, get_reporting_timing	ISINs de 12 caracteres.
leis	string[]	resolve_company, qualify_company, get_reporting_timing	Identificadores de Entidade Legal (LEI) de 20 caracteres.
ciks	string[]	resolve_company, qualify_company, get_reporting_timing	Chaves de Índice Central da SEC (CIK), com ou sem zeros à esquerda.
company_names	string[]	resolve_company, qualify_company, get_reporting_timing	Nomes legais ou comerciais. Correspondidos em um nome normalizado. Nomes anteriores não estão disponíveis: a tabela de aliases contém apenas tickers e ISINs.
exchange_codes	string[]	todas as cinco	MICs ISO 10383. 18 locais de negociação são cobertos.
country_codes	string[]	todas as cinco	ISO 3166-1 alfa-2, ex.: US, GB, FR.
regions	string[]	todas as cinco	Atalho para um conjunto de locais de negociação e países: us, uk, eu. Amplia um filtro explícito de bolsa ou país em vez de substituí-lo.
sectors	string[]	todas as cinco	Descrições SIC da SEC, ex.: Preparações Farmacêuticas. Preenchido em aproximadamente 65 por cento do universo publicável.
security_types	string[]	todas as cinco	ordinary_shares, depositary_receipt, preferred_shares.
public_float_bands	string[]	todas as cinco	micro, small, mid, large, mega, unknown. O tamanho é baseado no free float, porque a capitalização de mercado não é preenchida em nenhum lugar deste conjunto de dados.
fiscal_year_end_months	string[]	todas as cinco	Inteiros de 1 a 12. O fim do ano fiscal é efetivamente um campo dos Estados Unidos neste conjunto de dados.
exclude_december_fiscal_year_end	string (false, true)	todas as cinco	Manter apenas empresas cujo ano fiscal termina em um mês diferente de dezembro, as contas cujo ciclo orçamentário está fora de fase com um trimestre de calendário.
cadences	string[]	todas as cinco	quarterly, semiannual, annual, unknown.
operating_companies_only	string (false, true)	todas as cinco	Remover fundos, trusts e outras entidades não operacionais.
exclude_blank_checks	string (false, true)	todas as cinco	Remover SPACs pré-acordo. Separado do filtro de empresa operacional: um shell de cheque em branco é marcado como empresa operacional e passa em todos os filtros firmográficos comuns.
foreign_private_issuer	string (any, only, exclude)	todas as cinco	Filtrar pelo status de emissor privado estrangeiro.
us_registrant_only	string (false, true)	todas as cinco	Manter apenas empresas que possuem um CIK da SEC.
min_provenance_confidence	string (any, high)	todas as cinco	Definir como high para excluir linhas cujos termos de origem nunca foram lidos.
exclude_name_only_matches	string (false, true)	todas as cinco	Remover linhas cujo vínculo de identidade se baseia em nome e país coincidindo, em vez de um identificador. Use isso onde um vínculo de identidade incorreto importa.
exclude_share_alike	string (false, true)	todas as cinco	Remover linhas derivadas de fontes CC BY-SA, cuja condição de compartilhamento igual pode não ser adequada para um produto fechado.
listed_only	string (false, true)	qualify_company	Modo qualify. Manter apenas linhas comprovadamente listadas publicamente.
suppress_listed	string (false, true)	qualify_company	Modo qualify. Remover empresas comprovadamente listadas publicamente, para quem vende apenas para empresas privadas. Remove o que podemos provar que está listado; não garante que o restante seja privado.
assume_unmatched_is_private	string (false, true)	qualify_company	Modo qualify. Por padrão, uma empresa sem correspondência retorna is_listed null, porque uma não correspondência pode significar que a empresa é privada OU que não temos seu domínio. Defina como true para optar por ler uma não correspondência como privada, o que define is_listed como 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	Quantos dias antes do evento a janela de contato abre. Padrão 70.
window_lag_days	string	get_reporting_timing	Quantos dias antes do evento a janela de contato fecha. Padrão 42. Deve ser menor que a antecedência.
window_statuses	string[]	get_reporting_timing	Manter apenas linhas nestes estados de janela: open, not_yet, closed_passed, no_event.
max_days_to_event	string	get_reporting_timing	Remover linhas cujo próximo evento está mais distante do que isso. Um controle de custo.
min_cadence_confidence	string	get_reporting_timing	0 a 1. Linhas cuja confiança de cadência cai abaixo disso retornam um bloco de timing nulo com um motivo declarado em vez de uma estimativa. A cadência trimestral tem média de 0,94, anual 0,40, semestral 0,21.
include_constrained_period	string (true, false)	get_reporting_timing	Emitir o período em que uma empresa listada está restrita no que pode anunciar, derivado dos mesmos números de janela. Útil para campanhas e timing de anúncios.
limit	string	build_company_universe, get_reporting_season	Máximo de linhas para universe e season. A truncagem é sempre relatada, nunca silenciosa.
season_group_by	string (week, month)	get_reporting_season	Modo season. Tamanho do agrupamento.
season_split_by	string (none, sector, country, exchange_code)	get_reporting_season	Modo season. Segunda dimensão opcional.
season_from	string	get_reporting_season	Modo season. Data ISO. Padrão é hoje.
season_to	string	get_reporting_season	Modo season. Data ISO. Padrão é 180 dias a partir de hoje.

Instalação

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

Obtenha um token em console.apify.com/account/integrations.

Lendo a saída

As datas são previstas, não anunciadas. next_event_is_estimate é verdadeiro para uma data derivada do histórico de arquivamentos. confidence_band está em 0,80 e 0,50, calculado no elo mais fraco da cadeia, então confidence_effective é o mínimo das confianças de evento e cadência, em vez de uma média.

window_status é o campo para filtrar. É open, not_yet, closed_passed ou no_event em relação a hoje. no_event é o estado em que uma empresa cai quando não há evento de divulgação para construir uma janela.

Cadência desconhecida é recusada, não estimada. Uma empresa cujo histórico de arquivamentos é muito curto ou irregular retorna uma cadência nula com um motivo, em vez de uma data inventada.

Uma linha que não resolve nada ainda é cobrada. Um identificador que não corresponde a nenhuma empresa de capital aberto retorna match_method de no_match com todos os outros campos nulos. Essa é uma resposta real e a consulta foi executada para produzi-la.

Custo

Pague por evento no Apify, cobrado por linhas retornadas em vez de linhas filtradas.

Evento	Preço
Empresa resolvida	$0,006 por linha
Linha de timing retornada	$0,012 por linha
Agregado de temporada de divulgação	$0,05 por linha
Início do ator	$0,00005 por execução

Descontos por volume de 5, 10 e 15 por cento se aplicam nos planos Bronze, Silver e Gold do Apify. Uma linha de timing nunca é cobrada adicionalmente como uma empresa resolvida.

Parte do Conjunto GTM da Mamba Labs

Explore o conjunto completo no Apify.

Licença

MIT