Public Company Reporting Window Finder

Servidor MCP de Fechas de Ganancias de Empresas Públicas y Buscador de Ventanas de Reporte

Servidor MCP para el actor Buscador de Fechas de Ganancias de Empresas Públicas y Ventanas de Reporte de Mamba Labs en Apify.

Proporciónale un dominio, ticker, ISIN, LEI o CIK y te dice cuándo reporta esa empresa pública, y cuándo contactarla al respecto: fin del año fiscal, cadencia de reporte, próxima fecha de reporte, días hasta el evento, y la apertura y cierre de una ventana de contacto que tú defines.

Las filas de sincronización cubren solo empresas de EE. UU. La identidad, el lugar de cotización y la clasificación se resuelven a nivel mundial en el universo publicable. Las fechas de reporte provienen del historial de presentaciones de la SEC de EE. UU. y existen solo para empresas de EE. UU. Una empresa no estadounidense se resuelve por completo y devuelve un timing_unavailable_reason declarado en lugar de una fecha estimada, y aún se cobra como fila de sincronización porque se ejecutó la búsqueda.

Cinco herramientas, una por modo del actor

Herramienta	Recibe	Devuelve
resolve_company	identificadores	identidad y lugar de cotización, 44 campos
qualify_company	identificadores	un veredicto de estado de cotización
get_reporting_timing	identificadores	fin del año fiscal, cadencia, próximo evento, la ventana de contacto, 75 campos
build_company_universe	filtros	una lista de empresas
get_reporting_season	filtros	carga de reportes por semana o mes

Nunca pasas mode. Cada herramienta lo establece, y cada herramienta expone solo las entradas que su modo realmente utiliza.

build_company_universe y get_reporting_season construyen una lista a partir de filtros y no aceptan identificadores de empresa. Establece limit explícitamente en ambas: su valor predeterminado es 1000 y se te cobra por fila devuelta.

Parámetros

Cada parámetro es opcional a menos que una herramienta indique lo contrario. La columna Herramientas nombra las herramientas que lo aceptan.

Parámetro	Tipo	Herramientas	Descripción
company_domain	string	resolve_company, qualify_company, get_reporting_timing	Un único dominio simple, p. ej. stripe.com. La forma de columna de Clay. Utilizado por resolve, qualify y timing.
company_domains	string[]	resolve_company, qualify_company, get_reporting_timing	Muchos dominios a la vez. Utilizado por resolve, qualify y timing.
tickers	string[]	resolve_company, qualify_company, get_reporting_timing	Tickers de bolsa, p. ej. NWLG. Se comparan con el ticker principal y cada cotización en el lugar de cotización.
isins	string[]	resolve_company, qualify_company, get_reporting_timing	ISIN de 12 caracteres.
leis	string[]	resolve_company, qualify_company, get_reporting_timing	Identificadores de Entidad Legal de 20 caracteres.
ciks	string[]	resolve_company, qualify_company, get_reporting_timing	Claves de Índice Central de la SEC, con o sin ceros a la izquierda.
company_names	string[]	resolve_company, qualify_company, get_reporting_timing	Nombres legales o comerciales. Se comparan con un nombre normalizado. Los nombres anteriores no están disponibles: la tabla de alias solo contiene tickers e ISIN.
exchange_codes	string[]	las cinco	MIC ISO 10383. Se cubren 18 lugares de cotización.
country_codes	string[]	las cinco	ISO 3166-1 alfa-2, p. ej. US, GB, FR.
regions	string[]	las cinco	Abreviatura para un conjunto de lugares de cotización y países: us, uk, eu. Amplía un filtro explícito de bolsa o país en lugar de reemplazarlo.
sectors	string[]	las cinco	Descripciones SIC de la SEC, p. ej. Preparaciones Farmacéuticas. Se completa en aproximadamente el 65 por ciento del universo publicable.
security_types	string[]	las cinco	ordinary_shares, depositary_receipt, preferred_shares.
public_float_bands	string[]	las cinco	micro, small, mid, large, mega, unknown. El tamaño se basa en el flotante público porque la capitalización de mercado no está poblada en ningún lugar de este conjunto de datos.
fiscal_year_end_months	string[]	las cinco	Enteros del 1 al 12. El fin del año fiscal es efectivamente un campo de EE. UU. en este conjunto de datos.
exclude_december_fiscal_year_end	string (false, true)	las cinco	Conserva solo empresas cuyo año fiscal termina en un mes distinto de diciembre, las cuentas cuyo ciclo presupuestario está desfasado con un trimestre calendario.
cadences	string[]	las cinco	quarterly, semiannual, annual, unknown.
operating_companies_only	string (false, true)	las cinco	Elimina fondos, fideicomisos y otras entidades no operativas.
exclude_blank_checks	string (false, true)	las cinco	Elimina SPAC previos a un acuerdo. Separado del filtro de empresa operativa: una empresa de cheque en blanco se marca como empresa operativa y pasa todos los filtros firmográficos ordinarios.
foreign_private_issuer	string (any, only, exclude)	las cinco	Filtra según el estado de emisor privado extranjero.
us_registrant_only	string (false, true)	las cinco	Conserva solo empresas que tienen un CIK de la SEC.
min_provenance_confidence	string (any, high)	las cinco	Establece en high para excluir filas cuyos términos de origen nunca se leyeron.
exclude_name_only_matches	string (false, true)	las cinco	Elimina filas cuyo vínculo de identidad se basa en que un nombre y un país coinciden en lugar de un identificador. Úsalo donde un vínculo de identidad incorrecto importe.
exclude_share_alike	string (false, true)	las cinco	Elimina filas derivadas de fuentes CC BY-SA, cuya condición de compartir igual puede no ser adecuada para un producto cerrado.
listed_only	string (false, true)	qualify_company	Modo qualify. Conserva solo filas que se demuestre que cotizan públicamente.
suppress_listed	string (false, true)	qualify_company	Modo qualify. Elimina empresas que se demuestre que cotizan públicamente, para cualquiera que venda solo a empresas privadas. Elimina lo que podemos demostrar que cotiza; no garantiza que el resto sea privado.
assume_unmatched_is_private	string (false, true)	qualify_company	Modo qualify. Por defecto, una empresa no coincidente devuelve is_listed null, porque una no coincidencia puede significar que la empresa es privada O que no tenemos su dominio. Establece true para optar por leer una no coincidencia como privada, lo que establece 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	Cuántos días antes del evento se abre la ventana de contacto. Predeterminado 70.
window_lag_days	string	get_reporting_timing	Cuántos días antes del evento se cierra la ventana de contacto. Predeterminado 42. Debe ser menor que el anticipo.
window_statuses	string[]	get_reporting_timing	Conserva solo filas en estos estados de ventana: open, not_yet, closed_passed, no_event.
max_days_to_event	string	get_reporting_timing	Elimina filas cuyo próximo evento esté más lejos que esto. Un control de costos.
min_cadence_confidence	string	get_reporting_timing	0 a 1. Las filas cuya confianza de cadencia cae por debajo de esto devuelven un bloque de sincronización nulo con una razón declarada en lugar de una estimación. La cadencia trimestral promedia 0.94, la anual 0.40, la semestral 0.21.
include_constrained_period	string (true, false)	get_reporting_timing	Emite el período en el que una empresa cotizada está restringida en lo que puede anunciar, derivado de los mismos números de ventana. Útil para la sincronización de campañas y anuncios.
limit	string	build_company_universe, get_reporting_season	Filas máximas para universe y season. La truncación siempre se informa, nunca es silenciosa.
season_group_by	string (week, month)	get_reporting_season	Modo season. Tamaño de agrupación.
season_split_by	string (none, sector, country, exchange_code)	get_reporting_season	Modo season. Segunda dimensión opcional.
season_from	string	get_reporting_season	Modo season. Fecha ISO. Predeterminado hoy.
season_to	string	get_reporting_season	Modo season. Fecha ISO. Predeterminado 180 días a partir de hoy.

Instalación

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

Obtén un token en console.apify.com/account/integrations.

Lectura de la salida

Las fechas se predicen, no se anuncian. next_event_is_estimate es true para una fecha derivada del historial de presentaciones. confidence_band se sitúa en 0.80 y 0.50, calculado sobre el eslabón más débil de la cadena, por lo que confidence_effective es el mínimo de las confianzas de evento y cadencia, no un promedio.

window_status es el campo por el que filtrar. Es open, not_yet, closed_passed o no_event en comparación con hoy. no_event es el estado en el que cae una empresa cuando no hay un evento de reporte del cual construir una ventana.

La cadencia desconocida se rechaza, no se estima. Una empresa cuyo historial de presentaciones es demasiado corto o irregular devuelve una cadencia nula con una razón en lugar de una fecha inventada.

Una fila que no resuelve nada aún se factura. Un identificador que no coincide con ninguna empresa pública devuelve match_method de no_match con todos los demás campos nulos. Esa es una respuesta real y la búsqueda se ejecutó para producirla.

Costo

Paga por evento en Apify, cobrado por filas devueltas en lugar de filas filtradas.

Evento	Precio
Empresa resuelta	$0.006 por fila
Fila de sincronización devuelta	$0.012 por fila
Agregado de temporada de reportes	$0.05 por fila
Inicio del actor	$0.00005 por ejecución

Se aplican descuentos por volumen del 5, 10 y 15 por ciento en los planes Bronze, Silver y Gold de Apify. Una fila de sincronización nunca se cobra adicionalmente como empresa resuelta.

Parte del Conjunto GTM de Mamba Labs

Explora el conjunto completo en Apify.

Licencia

MIT