FinBridge
Datos financieros de fuentes oficiales para empresas coreanas, estadounidenses, japonesas y taiwanesas (DART, SEC EDGAR, EDINET, TWSE): estados financieros, segmentos, precios, filtros — MCP alojado + REST, nivel gratuito.
Documentación
FinBridge — DART + SEC + FRED + precios + screener. Un solo MCP.
El MCP financiero para análisis de acciones con IA. FinBridge es un servicio de datos alojado que recopila datos financieros oficiales de Corea, Estados Unidos, Japón y Taiwán (además de estados financieros europeos) cada noche, los normaliza en un solo esquema y los sirve a ChatGPT, Claude, Cursor o cualquier cliente MCP — y a todo lo demás a través de una API REST.
- Endpoint MCP (HTTP Streamable):
https://mcp.gronox.kr/mcp - API REST:
https://mcp.gronox.kr/api/v1· OpenAPI 3.1:https://mcp.gronox.kr/api/v1/openapi.json - Plan gratuito, sin tarjeta: 200 llamadas/día, todas las herramientas, los últimos 4 ejercicios fiscales y 130 sesiones de negociación. Los planes de pago amplían la profundidad histórica, no los intentos.
Solo fuentes oficiales, y solo fuentes que podemos redistribuir: OpenDART, SEC EDGAR, EDINET, TWSE/TPEx OpenAPI, data.go.kr (Comisión de Servicios Financieros), Databento (precios diarios de EE. UU.), series públicas de FRED, datos públicos de exchanges vía ccxt. Cada respuesta indica su fuente y fecha de corte, y cada empresa incluye un page_url a una página pública con el documento detrás de cada cifra.
Cobertura
| Mercado | Fuente | Estados y documentos | Precios diarios | Segmentos | Screener / backtests |
|---|---|---|---|---|---|
| Corea (KRX) | OpenDART · data.go.kr | ✅ K-IFRS, normalizados, revisiones conservadas | ✅ ajustados por eventos corporativos, 2020– | ✅ | ✅ |
| Estados Unidos | SEC EDGAR · Databento | ✅ US-GAAP, historial tal como se presentó (point-in-time) | ✅ desde 2023-03, ajustados por splits | ✅ (SEC DERA) | ✅ |
| Taiwán | TWSE / TPEx OpenAPI | ✅ TW-IFRS | ✅ 2004– | — | ✅ |
| Japón | EDINET | ✅ J-GAAP / IFRS | — (sin fuente redistribuible) | ✅ | — |
| Europa | ESEF / IFRS | ✅ estados financieros | — | — | — |
Páginas públicas para cada empresa operativa cotizada: https://www.gronox.kr/companies/{kr|us|jp|tw}/{symbol} (p. ej. Samsung Electronics).
Qué incluye
| Área | Herramientas |
|---|---|
| Estados y documentos | Financieros DART / EDGAR (con los cinco pares más cercanos adjuntos), documentos, eventos relevantes, operaciones de directivos (DART · Form 4), tenencias institucionales 13F, feed de divulgaciones |
| Precios y técnicos | OHLCV diario (KR · US · TW), indicadores técnicos, instantáneas de valoración con percentiles de mercado |
| Screener | Plantilla de tendencia Minervini, CAN SLIM, playbooks de Kell y Schwartz, screener técnicos, screener de ETFs — cada noche sobre todas las cotizaciones |
| Pares y segmentos | get_peers por grupo industrial y tamaño, o por similitud de mezcla de negocio a partir de segmentos reportados |
| Investigación | Backtests de cartera con costos de negociación (KR · US · TW), estudios de factores point-in-time, ejecuciones guardadas, SQL de solo lectura sobre la base de datos |
| Macro y cripto | Series e instantáneas de FRED, tickers de cripto / OHLCV / prima de exchange |
| Cuenta | Lista de seguimiento, importación de cartera |
Referencia de herramientas (generada desde el registro en vivo): https://www.gronox.kr/docs
Inicio rápido
Claude (claude.ai / Desktop)
Configuración → Conectores → Añadir conector personalizado → https://mcp.gronox.kr/mcp — inicia sesión con Google, sin necesidad de clave. Luego, en cada chat nuevo, abre + → FinBridge para activarlo (los conectores están desactivados por conversación hasta que lo hagas) y pregunta.
Claude Code
claude mcp add --transport http finbridge https://mcp.gronox.kr/mcp --header "Authorization: Bearer smcp_..."
Obtén una clave en https://www.gronox.kr/login (inicio de sesión con Google, emitida al instante).
ChatGPT (modo desarrollador)
Configuración → Apps y conectores → Avanzado → Modo desarrollador → Crear conector con la URL anterior y tu clave smcp_ como token de acceso.
Cualquier cliente MCP (Gemini CLI, Cursor, …)
{"mcpServers": {"finbridge": {"httpUrl": "https://mcp.gronox.kr/mcp",
"headers": {"Authorization": "Bearer smcp_..."}}}}
REST (sin cliente MCP)
curl -H "Authorization: Bearer smcp_..." https://mcp.gronox.kr/api/v1/companies/kr/005930/financials
curl -H "Authorization: Bearer smcp_..." "https://mcp.gronox.kr/api/v1/companies/us/AAPL/peers?limit=5"
curl -H "Authorization: Bearer smcp_..." "https://mcp.gronox.kr/api/v1/companies/eu/NL0010273215/peers?limit=5" # Europe by ISIN: statements-based peers, no prices (EU groups all IT/electronics together, so treat the list as a starting point)
Endpoints: /companies/{market}/{symbol} (perfil) · /financials · /valuation · /peers · /prices. Misma clave, misma cuota, misma profundidad que MCP.
Prompts integrados
FinBridge registra tres prompts MCP, para que puedas empezar sin escribir una pregunta. En Claude.ai o Claude Desktop, activa FinBridge en el chat (+ → FinBridge), luego abre + → FinBridge de nuevo y elige un prompt; en Claude Code escribe el comando de barra. Clientes que no muestran prompts (Cursor, modo desarrollador de ChatGPT): pega la línea de una sola frase.
| Prompt | Qué hace | Claude Code | Pegar en su lugar |
|---|---|---|---|
| Lista de seguimiento de esta semana | Qué pasó los screener de tendencia, CAN SLIM, VCP y RS esta semana (KR/US/TW), y luego un análisis más detallado de los tres más fuertes | /mcp__finbridge__weekly_watchlist kr | "Ejecuta la lista de seguimiento de FinBridge de esta semana para Corea y revisa los tres más fuertes con get_valuation y get_technicals." |
| Revisión de empresa | Una empresa completa: cuatro estados anuales, valoración frente a cinco pares, técnicos, últimos documentos, cada cifra con fecha | /mcp__finbridge__company_checkup 005930 | "Dame una revisión de FinBridge de Samsung Electronics (005930) con fechas data_as_of." |
| Tres primeras preguntas | Un recorrido de un minuto: pares, un screener, cuatro años de estados | /mcp__finbridge__first_questions | "Acabo de conectar FinBridge — responde sus tres preguntas iniciales y muestra qué herramienta usaste." |
Buenas primeras preguntas
- "Compara Samsung Electronics con sus cinco pares más cercanos en P/E, ROE y crecimiento de ingresos."
- "Filtra KOSDAQ por nombres con RS superior a 90 que pasen la plantilla de tendencia."
- "Trae los últimos cuatro estados anuales de Apple y resume las tendencias de margen."
Enlaces
- Producto, claves y precios: https://www.gronox.kr · https://www.gronox.kr/pricing
- Guía de conexión: https://www.gronox.kr/connect
- Dónde obtener gratis los datos de cada mercado (guías): https://www.gronox.kr/guides
- Fuentes de datos y licencias: https://www.gronox.kr/sources
- Estado: https://mcp.gronox.kr/status
- Registro:
kr.gronox/finbridgeen el Registro MCP oficial · Smitheryred0920/finbridge· mcp.so - 한국어: https://www.gronox.kr/ko · 日本語: https://www.gronox.kr/ja
Notas
- Los datos son una instantánea nocturna (el feed de documentos se actualiza cada 5 minutos); no son cotizaciones en tiempo real.
- Los estados financieros siguen el estándar contable local (K-IFRS, US-GAAP, J-GAAP/IFRS, TW-IFRS), por lo que los ratios entre mercados son aproximaciones.
- Solo información, no asesoramiento de inversión. FinBridge no está afiliado a ningún operador cuyos criterios publicados implementa.
- Este repositorio es el listado público (manifiesto de registro
server.json) del servicio alojado; el servidor en sí no es de código abierto.
Contacto: 4y.changemaker@gmail.com
Licencia
El contenido de este repositorio (metadatos de listado y documentación) se publica bajo la Licencia MIT. El servicio alojado de FinBridge y su código fuente no forman parte de este repositorio y se proporcionan bajo los Términos de servicio de FinBridge.