SECfinAPI

Los archivos SEC contienen los estados financieros de todas las empresas públicas de EE. UU., pero están en XBRL, lo que es difícil de analizar. Construí **SECfinAPI** para estandarizarlos en JSON limpio, y un **servidor MCP** para que los asistentes de IA puedan usarlos directamente.

Documentación

secfinapi-mcp

Servidor MCP para SECfinAPI — datos financieros estandarizados de SEC EDGAR (estados de resultados, balances generales, flujo de caja, más de 40 ratios) como herramientas para Claude, Cursor y otros asistentes de IA.

Pregunta a tu asistente de IA cosas como "¿Cuál es la tendencia de ingresos de Apple?" o "Compara los márgenes operativos de MSFT y GOOGL" — obtiene los datos en vivo a través de SECfinAPI.

Se ejecuta localmente en tu máquina y es un envoltorio ligero sobre la API REST de SECfinAPI. Sin servidor que alojar, sin costo adicional.

Configuración

  1. Obtén una clave de API (gratuita) en https://www.secfinapi.com.
  2. Agrega el servidor a la configuración MCP de tu asistente de IA.

Claude Desktop

Abre Configuración → Desarrollador → Editar configuración y agrega:

Una vez publicado en npm:

{
  "mcpServers": {
    "secfinapi": {
      "command": "npx",
      "args": ["-y", "secfinapi-mcp"],
      "env": { "SECFINAPI_KEY": "your-api-key-here" }
    }
  }
}

Ejecutando desde el código fuente (antes de publicar):

{
  "mcpServers": {
    "secfinapi": {
      "command": "node",
      "args": ["C:/path/to/sec-financial-mcp/dist/index.js"],
      "env": { "SECFINAPI_KEY": "your-api-key-here" }
    }
  }
}

Reinicia Claude Desktop. Las 6 herramientas siguientes aparecen en el menú de herramientas (🔌).

Cursor / VS Code

La misma forma de configuración en los ajustes MCP del editor — command, args y la variable de entorno SECFINAPI_KEY.

Herramientas

HerramientaDevuelve
get_company_infoMetadatos de la empresa + un enlace a sus presentaciones en SEC EDGAR
get_income_statementEstado de resultados estandarizado (con fechas de presentación)
get_balance_sheetBalance general estandarizado
get_cash_flowEstado de flujo de caja estandarizado
get_metricsMás de 40 ratios financieros (ROE, ROIC, márgenes, crecimiento…)
list_companiesLista / búsqueda de las empresas públicas estadounidenses disponibles

Variables de entorno

VariableRequeridaPredeterminado
SECFINAPI_KEYsí—
SECFINAPI_BASE_URLnola API de producción de SECfinAPI

Ejecutar desde el código fuente

npm install
npm run build
SECFINAPI_KEY=your-key node dist/index.js

Publicación (mantenedor)

npm run build
npm publish

Licencia

MIT