SEC EDGAR — Presentaciones de Empresas Públicas

La base de datos de presentaciones de la Comisión de Bolsa y Valores (SEC). Cada empresa pública de EE. UU. presenta aquí, cada presentación tiene marca de tiempo y es inmutable, y cada divulgación (ingresos, deuda, factores de riesgo, compensación ejecutiva, actividad de fusiones y adquisiciones, operaciones con información privilegiada) está estructurada para recuperación automática. Gratuita y autoritativa.

Parte de Pipeworx — un gateway MCP que conecta agentes de IA a más de 1476 fuentes de datos en vivo.

Por qué esto importa para los agentes de IA

Si tu agente responde cualquier cosa sobre una empresa pública de EE. UU. — finanzas, exposición legal, propiedad intelectual, rotación ejecutiva, eventos materiales recientes — la respuesta está en EDGAR. Los datos están estructurados (XBRL), así que no tienes que analizar PDFs.

Los dos flujos clave:

1. Flujo de presentaciones. "Muéstrame el 10-Q reciente de Apple." → edgar_ticker_to_cik("AAPL") → edgar_company_filings(cik) → lista de presentaciones con números de acceso, tipos de formulario y fechas de presentación.

2. Flujo de conceptos. "¿Cuál fue la tendencia de ingresos de Apple en los últimos 4 trimestres?" → edgar_company_concept(cik, "Revenues") → serie temporal de valores etiquetados con XBRL a lo largo de los períodos.

Ambos suelen ir precedidos por edgar_ticker_to_cik o resolve_entity({type: "company", value: "AAPL"}) para obtener el CIK canónico de 10 dígitos.

Related MCP server: SEC EDGAR MCP Server

Autenticación

Ninguna. SEC EDGAR es un servicio gratuito, público y sin autenticación. Pipeworx envía un encabezado User-Agent cortés para cumplir con las pautas de API de la SEC.

URIs citables

pipeworx://edgar/company/{cik}/filings
pipeworx://edgar/company/{cik}/facts

Incrústalas en tu salida. Estables a través de reorganizaciones: las empresas cambian de marca, pero su CIK no cambia.

Tipos de formulario que vale la pena conocer

Para operaciones con información privilegiada específicamente, consulta el paquete dedicado insider-trading — expone cambios de Formulario 4 / 13D / 13G con esquemas más limpios.

Errores comunes

• Deriva del nombre de concepto. Los presentadores de la SEC a veces cambian el concepto XBRL que etiquetan para ingresos. El concepto predeterminado Revenues puede estar desactualizado para años fiscales más recientes; prueba RevenueFromContractWithCustomerExcludingAssessedTax como alternativa.

• Desajustes de período. Los años fiscales terminan en diferentes momentos según la empresa (Apple = septiembre, Microsoft = junio, Google = diciembre). Al comparar, siempre divulga el período.

• Formato del CIK. Algunos endpoints quieren 10 dígitos con ceros a la izquierda (0000320193), otros quieren sin relleno (320193). Pipeworx acepta ambos; el campo cik_padded en edgar_ticker_to_cik es la forma canónica para las URIs de recursos.

• Casi en tiempo real, no en tiempo real. Las presentaciones aparecen en EDGAR en minutos después del envío, pero Pipeworx almacena en caché los resultados. Para una actualidad de noticias de última hora, establece Cache-Control: no-cache (se aplica límite anónimo) o consulta el campo _meta.cache.fresh_until.

• La disponibilidad de conceptos difiere. Los presentadores más pequeños etiquetan menos conceptos XBRL que los grandes. edgar_company_concept puede devolver matrices vacías para conceptos válidos que la empresa simplemente no reporta. Usa edgar_company_facts para ver qué conceptos reporta una empresa.

Inicio rápido

Añádelo a tu cliente MCP (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "edgar": {
      "url": "https://gateway.pipeworx.io/edgar/mcp"
    }
  }
}

Qué sirve realmente este endpoint

tools/list en https://gateway.pipeworx.io/edgar/mcp devuelve las herramientas de la tabla anterior más las meta-herramientas compartidas de Pipeworx — ask_pipeworx, discover_tools, search_within, remember/recall y el resto del conjunto del gateway. Así que el número de herramientas que ves es mayor que esta tabla: un endpoint de un solo paquete actualmente lista aproximadamente 30 herramientas compartidas junto con las propias del paquete. La respuesta initialize de la conexión indica su alcance exacto, y es la respuesta autoritativa para un día dado.

Esto es deliberado, no multiplexación accidental. Las meta-herramientas son lo que permiten que una conexión con alcance responda una pregunta que este paquete no cubre — a través de ask_pipeworx, que enruta a través de todo el catálogo — sin que añadas un segundo servidor MCP. Actualmente no hay forma de montar un endpoint de paquete sin ellas; si los esquemas adicionales te cuestan más contexto de lo que vale el enrutamiento, conéctate al gateway completo una vez en lugar de a varios endpoints de paquetes.

O conéctate al gateway completo de Pipeworx para obtener las herramientas de todos los paquetes listadas directamente, en lugar de solo las de este:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

Ambas URLs llegan al mismo gateway y a las mismas más de 1476 fuentes de datos. La única diferencia es qué herramientas de paquete se listan directamente; ask_pipeworx llega a todas desde cualquiera de las dos.

Uso con ask_pipeworx

En lugar de llamar a las herramientas directamente, puedes hacer preguntas en lenguaje natural — esto funciona tanto en el endpoint del paquete anterior como en el gateway completo:

ask_pipeworx({ question: "your question about Edgar data" })

El gateway elige la herramienta correcta y completa los argumentos automáticamente.

Más

• Documentación y guías

• pipeworx.io

Licencia

MIT