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
- Obtén una clave de API (gratuita) en https://www.secfinapi.com.
- 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
| Herramienta | Devuelve |
|---|---|
get_company_info | Metadatos de la empresa + un enlace a sus presentaciones en SEC EDGAR |
get_income_statement | Estado de resultados estandarizado (con fechas de presentación) |
get_balance_sheet | Balance general estandarizado |
get_cash_flow | Estado de flujo de caja estandarizado |
get_metrics | Más de 40 ratios financieros (ROE, ROIC, márgenes, crecimiento…) |
list_companies | Lista / búsqueda de las empresas públicas estadounidenses disponibles |
Variables de entorno
| Variable | Requerida | Predeterminado |
|---|---|---|
SECFINAPI_KEY | sí | — |
SECFINAPI_BASE_URL | no | la 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