Edgrapi — SEC EDGAR Financials

Datos financieros limpios de empresas SEC EDGAR, ratios, presentaciones y secciones 10-K/10-Q como JSON normalizado: un servidor MCP alojado con 5 herramientas y un nivel gratuito.

GitHubPrueba este MCPPatrocinado

Documentación

edgrapi-skills

La API de datos del Gobierno de EE. UU. para agentes. Un servidor MCP alojado que sirve datos oficiales del gobierno de EE. UU. como JSON limpio con una sola clave: presentaciones SEC EDGAR (operaciones de información privilegiada, 8-K, tenencias 13F, participaciones 13D/G, fundamentos, ratios), oportunidades de contratos SAM.gov, adjudicaciones USAspending, subvenciones Grants.gov y operaciones bursátiles del Congreso — a través de la API de Edgrapi. Además, habilidades Python integradas para el flujo de trabajo financiero de la SEC.

Los datos oficiales son gratuitos, pero cada fuente trae su propio dolor de cabeza: desviación de etiquetas XBRL, lenguajes de consulta específicos de cada agencia, estados separados por tuberías, rangos de dólares. Edgrapi normaliza todo en un único esquema JSON limpio, para que tu agente obtenga números confiables en una sola llamada.

Gratis para comenzar — obtén una clave (100 créditos gratuitos cada mes, sin necesidad de tarjeta) y estarás extrayendo datos desde Claude, ChatGPT, Cursor o tu propio bucle de agente en menos de dos minutos.

El servidor MCP alojado expone el conjunto completo de herramientas, incluidos los endpoints de datos gubernamentales (get_opportunities, get_awards, get_grants, get_congress). Las habilidades Python empaquetadas skills/ a continuación cubren el flujo de trabajo de finanzas de empresas de la SEC; usa el servidor MCP para todo lo demás.

Biblioteca estándar de Python puro. Sin dependencias. Licencia MIT-0.

Instalación

# Claude Code, Cursor, Cline, etc. — `skills` CLI, installs straight from this repo
npx skills add paperandbeyond23-gif/edgrapi-skills --all
# or pick one: npx skills add paperandbeyond23-gif/edgrapi-skills --skill edgrapi-full

# OpenClaw / ClawHub — published to the ClawHub registry
npx clawhub@latest install edgrapi-full   # also: edgrapi-fundamentals, edgrapi-filings

Úsalo como servidor MCP

Las habilidades anteriores son una forma de acceso. La otra es el servidor MCP alojado: apunta cualquier cliente MCP a una única URL, sin nada que instalar y sin proceso local:

{
  "mcpServers": {
    "edgrapi": {
      "url": "https://api.edgrapi.com/mcp",
      "headers": { "Authorization": "Bearer edgr_YOUR_KEY" }
    }
  }
}

Funciona en Claude Desktop, Claude Code, Cursor y Cline. El transporte es streamable-http. La autenticación es Authorization: Bearer edgr_..., u OAuth 2.1 — el servidor es su propio proveedor. El descubrimiento (initialize, tools/list) está abierto, para que puedas inspeccionar la lista de herramientas sin clave; tools/call requiere una.

La superficie MCP es más amplia que las habilidades de este repositorio: además de fundamentos y presentaciones, cubre operaciones de información privilegiada del Formulario 4 con detección de compras en clúster, eventos materiales 8-K tipificados, tenencias de fondos 13F comparadas trimestre a trimestre, participaciones activistas 13D/13G >5%, XBRL a JSON, acciones en circulación, resolución de entidades y búsqueda de texto completo en todas las presentaciones desde 2001. Para la lista actualizada, llama a tools/list o lee la tarjeta del servidor — ambas se generan desde el propio servidor, por lo que ninguna queda desactualizada.

Habilidades en este repositorio

Habilidad	Propósito
`edgrapi-full`	Kit completo: fundamentos, ratios, perfil de empresa y presentaciones
`edgrapi-fundamentals`	Estados financieros normalizados + ratios calculados
`edgrapi-filings`	Perfiles de empresa + presentaciones SEC recientes (10-K/10-Q/8-K)

Instala el edgrapi-full incluido para agentes que necesitan amplia cobertura. Instala las variantes enfocadas cuando quieras una superficie de herramientas mínima.

Herramientas

Herramienta	Devuelve
`get_fundamentals(ticker, period, limit)`	Estado de resultados, balance general, flujo de caja — periodizados, USD
`get_ratios(ticker)`	Márgenes, retornos (ROE/ROA), apalancamiento, liquidez
`get_company(ticker)`	CIK, nombre legal, industria SIC, fin de año fiscal, bolsas, sitio web
`get_filings(ticker, limit, form)`	Presentaciones recientes con fechas de presentación/informe y enlaces a documentos

Autenticación

Establece la variable de entorno EDGRAPI_KEY con tu clave de Edgrapi (formato edgr_...). Se envía como el encabezado X-API-Key — la URL base está codificada, por lo que la clave nunca llega a otro host.

export EDGRAPI_KEY="edgr_..."

Obtén una clave gratuita — 100 créditos gratuitos cada mes, sin necesidad de tarjeta. La misma clave funciona para estas habilidades y llamadas REST directas.

Precios

Los créditos se ponderan por endpoint, no uno por solicitud: empresa, presentaciones, eventos, resolución de entidades y búsqueda de texto completo cuestan 1; fundamentos, ratios y XBRL cuestan 3; secciones, información privilegiada, tenencias y activismo cuestan 5. Los créditos nunca caducan. Todos los datos provienen del EDGAR público de la SEC.

Plan	Precio	Créditos
Gratis	$0	100 / mes
Starter	$10/mes	10,000 / mes
Pro (mensual)	$29/mes	30,000 / mes
Pro (anual)	$290/año	360,000 por adelantado

Paquetes de recarga (únicos, nunca caducan): 5,000 / $7 · 15,000 / $18 · 50,000 / $55.

Gestiona los planes en https://edgrapi.com/pricing. También disponible con medición en RapidAPI.

Fuente

Documentación: https://edgrapi.com/docs · OpenAPI: https://edgrapi.com/openapi.json
Inicio rápido: obtén una clave en https://edgrapi.com/app, luego llama a cualquier herramienta

Problemas y contribuciones

Consulta CONTRIBUTING.md. Informes de seguridad: SECURITY.md.

Licencia

MIT Sin Atribución. Haz fork, publica, sublicencia — sin atribución requerida.

Independencia

Edgrapi es un servicio independiente y no está afiliado, respaldado ni patrocinado por la Comisión de Bolsa y Valores de EE. UU. Todos los datos provienen del sistema público EDGAR de la SEC. "EDGAR" es un sistema operado por la SEC de EE. UU.