Fairquery EDGAR

Presentaciones SEC y datos financieros XBRL por ticker, CIK o nombre; cinco herramientas gratuitas consultan sec.gov directamente.

GitHub

Documentación

Fairquery EDGAR: Presentaciones y Datos Financieros de Empresas ante la SEC

Resuelve tickers, CIKs o nombres de empresas de EE. UU. a través de SEC EDGAR y devuelve presentaciones y datos financieros XBRL como filas estructuradas, desde $1.50 por cada 1,000 empresas. Pagas $0.0015 por empresa resuelta, $0.001 por fila de presentación, $0.0002 por fila de dato y $0.002 por extracto de texto. Las filas de error son gratuitas. Ejemplo: 2 empresas con 5 presentaciones cada una y 16 filas de datos cada una cuestan 2 × $0.0015 + 10 × $0.001 + 32 × $0.0002 = $0.02, más la tarifa de inicio de Actor de Apify de $0.00005.

Apify Store · MCP vía Apify · Contacto: info@getfairquery.com

Actor público de Apify que convierte los datos públicos de EDGAR de la SEC en filas limpias y estructuradas para agentes de IA y clientes MCP. Consulta por ticker, CIK o nombre de empresa. Devuelve metadatos oficiales de la entidad, presentaciones recientes (10-K, 10-Q, 8-K y más) con URLs de documentos, datos financieros XBRL de la empresa (Activos, Ingresos, PérdidaNeta, EPS diluido y más), y extractos opcionales en texto plano. Cada fila incluye una versión de esquema, una URL fuente de la SEC y una marca de tiempo. Los errores son códigos legibles por máquina.

No es asesoramiento de inversión. La salida es un espejo estructurado de los datos públicos de SEC EDGAR para investigación y herramientas. No es una recomendación de comprar, vender o mantener ningún valor.

Cuándo usar esto (selección de LLM / herramienta)

Usa este Actor cuando un agente necesite:

  • Mapear un ticker, CIK o nombre de empresa → CIK oficial de la SEC / metadatos de entidad
  • Presentaciones recientes ante la SEC (10-K, 10-Q, 8-K, …) con URLs de documentos
  • Datos financieros XBRL (Activos, PérdidaNeta, EPS, …) de companyfacts
  • Extractos opcionales en texto plano de documentos de presentación primarios

No lo uses para cotizaciones en tiempo real, cadenas de opciones, análisis de Formulario 4 de información privilegiada más allá de lo que exponen las presentaciones, o registros no estadounidenses.

Conexión MCP (alojado en Apify)

Conecta cualquier cliente MCP al servidor MCP de Apify con este Actor incluido:

{
  "mcpServers": {
    "fairquery-edgar": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=fetch-actor-details,fairquery/edgar-company-facts-filings"
    }
  }
}

Los clientes sin OAuth pueden agregar "headers": {"Authorization": "Bearer <APIFY_TOKEN>"}.

URL MCP: https://mcp.apify.com/?tools=fetch-actor-details,fairquery/edgar-company-facts-filings

ID de Actor: fairquery/edgar-company-facts-filings (en minúsculas).

Ejemplos de indicaciones para agentes

  • "Usando la herramienta EDGAR, obtén las presentaciones 10-K y 10-Q de Apple y Microsoft desde 2023 y sus últimos Activos, PérdidaNeta y EPS diluido."
  • "Encuentra el CIK de Nvidia y lista sus últimas cinco presentaciones 8-K con enlaces."

Servidor MCP stdio local

Este repositorio también incluye un servidor MCP stdio (TypeScript, @modelcontextprotocol/sdk) en mcp/ con herramientas de propósito único. Seis son gratuitas y llaman directamente a sec.gov (sin token, User-Agent de marca Fairquery, limitado a ≤5 req/s); una herramienta opcional de procesamiento por lotes ejecuta el Actor de Apify. initialize y tools/list funcionan sin token.

HerramientaQué hacePaginaciónCosto
edgar_resolve_companyTicker / CIK / fragmento de nombre → CIK de la SEC, ticker, nombre del registrante–gratis
edgar_list_filingsPresentaciones de una empresa, filtradas por formTypes, since, until; historial completo opcionallimit/offsetgratis
edgar_get_filing_documentDocumento de presentación primario (o nombrado) de los Archivos de sec.gov como texto plano, por URL o número de accesooffset/maxChars (caracteres)gratis
edgar_get_filing_indexCada archivo de una presentación (documento primario, anexos, archivos de datos XBRL) con tipo de documento de la SEC, tamaño y URL directa, más datos de encabezado (formulario, fecha de presentación, período, elementos 8-K, presentadores), desde la página de índice de presentaciones de EDGAR; filtro opcional docTypeslimit/offsetgratis
edgar_get_company_factsDatos XBRL: lista de conceptos disponibles (con search) o series temporales para concepts, filtro por formulario / período fiscal / fechalimit/offsetgratis
edgar_get_concept_across_companiesUn concepto para un período en todos los presentadores (API de marcos de la SEC), ordenable, filtro de empresa opcionallimit/offsetgratis
edgar_batch_exportExportación multiempresa de presentaciones + datos + extractos a través del Actor de Apify–pago por evento, requiere APIFY_TOKEN

Las herramientas paginadas devuelven {count, total, offset, hasMore, nextOffset, meta, items}. Los errores se devuelven como {error, message, retryable} con códigos como COMPANY_NOT_FOUND, FILING_NOT_FOUND, NOT_FOUND, INVALID_URL, SEC_FETCH_FAILED.

Prueba en vivo de todas las herramientas gratuitas: cd mcp && npm run build && node scripts/live-test.mjs.

Instalación y ejecución (Node)

cd mcp
npm install
npm run build
node dist/index.js            # free tools
APIFY_TOKEN=your_token node dist/index.js   # also enables edgar_batch_export

Configuración del cliente MCP (Cursor / Claude Desktop)

{
  "mcpServers": {
    "fairquery-edgar": {
      "command": "node",
      "args": ["/absolute/path/to/edgar-company-facts-filings/mcp/dist/index.js"],
      "env": {
        "APIFY_TOKEN": "your_apify_token"
      }
    }
  }
}

Docker

Compila desde mcp/:

cd mcp
docker build -t fairquery-edgar-mcp .
docker run -i -e APIFY_TOKEN=your_token fairquery-edgar-mcp

El Dockerfile de la raíz del repositorio compila este servidor MCP stdio (contexto de compilación = raíz del repositorio) y es lo que usa Glama. La imagen del Actor de Apify se compila desde .actor/Dockerfile.

Glama

glama.json lista a fairquery como mantenedor. Después de que Glama indexe el servidor, reclama la propiedad si es necesario.

Fuentes de datos (acceso justo de la SEC)

RecursoURL
Mapa de tickershttps://www.sec.gov/files/company_tickers.json
Presentacioneshttps://data.sec.gov/submissions/CIK##########.json
Datos de la empresahttps://data.sec.gov/api/xbrl/companyfacts/CIK##########.json

El Actor envía User-Agent: Fairquery fairquery@proton.me y limita a ≤ 5 solicitudes/segundo.

Entrada

CampoTipoPredeterminadoDescripción
companiesstring[]—Tickers (AAPL), CIKs (320193) o fragmentos de nombre (Apple)
modefilings | facts | bothbothQué tipos de filas emitir (siempre emite company cuando se resuelve)
formTypesstring[]["10-K","10-Q","8-K"]Filtro de formulario (sin distinción de mayúsculas); pasa [] para todos los formularios
sinceYYYY-MM-DD—Conserva presentaciones con filingDate >= since
maxFilingsPerCompanyint (1–200)5Límite de filas de presentación por empresa
metricsstring[]["Assets","NetIncomeLoss","EarningsPerShareDiluted","Revenues"]Nombres de conceptos XBRL (sin distinción de mayúsculas); [] usa un conjunto curado de 10 conceptos us-gaap
maxFactsPerMetricint (1–50)4Valores más recientes por concepto/unidad
includeTextExcerptboolfalseObtener texto del documento primario
excerptMaxCharsint (200–20,000)2000Límite de longitud de extracto en caracteres

Ejemplo de entrada

{
  "companies": ["AAPL", "MSFT"],
  "mode": "both",
  "formTypes": ["10-K", "10-Q"],
  "since": "2023-01-01",
  "maxFilingsPerCompany": 5,
  "metrics": ["Assets", "NetIncomeLoss", "EarningsPerShareDiluted"],
  "includeTextExcerpt": false
}

Mínimo:

{"companies":["AAPL"],"mode":"both","formTypes":["10-K"],"metrics":["Assets","NetIncomeLoss"]}

Salida

Una fila de conjunto de datos por empresa, presentación, dato, extracto de texto o error. Cada fila incluye:

  • schema_version — actualmente 1.0.0
  • type — company | filing | fact | text_excerpt | error
  • source_url — URL de la SEC de la que proviene la fila
  • scraped_at — marca de tiempo ISO

Filas de error (legibles por máquina)

{
  "schema_version": "1.0.0",
  "type": "error",
  "code": "COMPANY_NOT_FOUND",
  "message": "Could not resolve company query: ZZNOTREAL",
  "retryable": false,
  "query": "ZZNOTREAL",
  "source_url": "https://data.sec.gov/"
}

Los códigos incluyen: INPUT_EMPTY, COMPANY_NOT_FOUND, RESOLVE_FAILED, SUBMISSIONS_FETCH_FAILED, FACTS_FETCH_FAILED, EXCERPT_FETCH_FAILED.

Resumen de ejecución

Registro de almacén de clave-valor RUN_SUMMARY con conteos, total de solicitudes a la SEC y entrada repetida.

Orden de datos: para cada concepto y unidad, las filas de datos se ordenan por fecha de fin de período (más reciente primero), luego por fecha de presentación. Un valor que presentaciones posteriores vuelven a informar (por ejemplo, la columna del año anterior de un 10-Q) se devuelve una vez, desde la presentación más reciente, por lo que maxFactsPerMetric te da los períodos más recientes.

Precios

Sin suscripción. Pagas por estos eventos:

EventoPrecioCuándo
company-resolved$0.0015Cada fila de empresa resuelta exitosamente
filing$0.001Cada fila de presentación
financial-fact$0.0002Cada fila de dato XBRL
text-excerpt$0.002Cada fila de extracto de texto de documento primario
apify-actor-start$0.00005Una vez por ejecución, por GB de memoria (evento predeterminado de Apify)

Las filas de error (COMPANY_NOT_FOUND, FACTS_FETCH_FAILED, …) no se cobran.

Ejemplo práctico: {"companies": ["AAPL", "MSFT"], "mode": "both", "maxFilingsPerCompany": 5, "metrics": ["Assets", "NetIncomeLoss", "EarningsPerShareDiluted", "Revenues"], "maxFactsPerMetric": 4} devuelve 2 filas de empresa, hasta 10 filas de presentación y hasta 32 filas de datos: 2 × $0.0015 + 10 × $0.001 + 32 × $0.0002 = $0.02 como máximo, más $0.00005. Activar includeTextExcerpt agrega $0.002 por presentación.

Para limitar el gasto, usa mode: "facts" o "filings", reduce maxFilingsPerCompany / maxFactsPerMetric, o establece un costo máximo por ejecución en las opciones de ejecución (el Actor se detiene limpiamente en el límite). Los precios provienen de la pestaña de precios de la Tienda (octubre de 2026).

Memoria / tiempo de ejecución

256 MB predeterminados, tiempo de espera de 300 s. Solo HTTP (sin navegador).

Solución de problemas

SíntomaCausa y solución
Llamada a la API rechazada: companies es obligatorioLa entrada no tenía empresas. Los tickers de muestra en el formulario de la Consola son solo de relleno y no se envían con las llamadas a la API.
COMPANY_NOT_FOUNDEl ticker, CIK o fragmento de nombre no está en el mapa de tickers de la SEC (por ejemplo, una empresa no estadounidense o excluida de la lista). Prueba con el CIK. Estas filas son gratuitas.
Menos presentaciones de las esperadasformTypes predetermina a 10-K, 10-Q y 8-K. Pasa [] para todos los formularios y verifica since y maxFilingsPerCompany.
Falta una métrica en los datosLa empresa no informa ese concepto us-gaap (por ejemplo, Revenues vs RevenueFromContractWithCustomerExcludingAssessedTax). Usa el nombre exacto del concepto XBRL. Algunos conceptos dejan de informarse: los valores de Revenues de Apple terminan en 2018, mientras que RevenueFromContractWithCustomerExcludingAssessedTax es actual.
SUBMISSIONS_FETCH_FAILED / FACTS_FETCH_FAILEDLos servidores de la SEC estaban lentos o limitando la tasa (retryable: true). El Actor se mantiene en o por debajo de 5 solicitudes/segundo; vuelve a ejecutarlo más tarde.

Preguntas frecuentes

¿De dónde provienen los datos?

De los endpoints JSON públicos de EDGAR de la SEC (mapa de tickers, presentaciones, datos de la empresa), obtenidos con un User-Agent declarado bajo las reglas de acceso justo de la SEC.

¿Es esto asesoramiento de inversión?

No. Es un espejo estructurado de datos públicos de la SEC para investigación y herramientas.

¿Incluye precios en tiempo real o empresas no estadounidenses?

No. Cubre solo a registrantes de la SEC, sin datos de mercado.

¿Cuánto cuesta una ejecución?

Desde $0.0015 por empresa resuelta, más $0.001 por fila de presentación, $0.0002 por fila de dato y $0.002 por extracto. Un ejemplo de dos empresas con presentaciones y datos cuesta alrededor de $0.02.

¿Puede llamarlo un agente de IA?

Sí, a través de Apify MCP (consulta la URL incluida en la sección MCP anterior). El servidor MCP stdio en el repositorio de GitHub también tiene herramientas gratuitas que consultan sec.gov directamente.

Familia Fairquery

Otras herramientas de Fairquery en la Tienda de Apify. Cada una devuelve filas estructuradas con códigos de error legibles por máquina, y las filas de error nunca se cobran:

Todos los Actores de Fairquery: https://apify.com/fairquery

Kits y plantillas

Guías opcionales de Fairquery para conectar este Actor a agentes y automatizaciones (el Actor funciona bien sin ellas):

Aviso legal

Los datos provienen del sistema EDGAR de la Comisión de Bolsa y Valores de EE. UU. Fairquery y este Actor no ofrecen garantía de integridad ni idoneidad para decisiones de trading. Esto no es asesoramiento de inversión.

Enlaces

Desarrollo

Notas de desarrollo local, pruebas e implementación están en DEVELOPMENT.md. El README de Apify Store es .actor/README.md.