FinBridge

Dados financeiros de fontes oficiais para empresas coreanas, americanas, japonesas e taiwanesas (DART, SEC EDGAR, EDINET, TWSE): demonstrações, segmentos, preços, filtros — MCP hospedado + REST, plano gratuito.

GitHubExperimente este MCPPatrocinado

Documentação

FinBridge — DART + SEC + FRED + preços + screeners. Um único MCP.

O MCP financeiro para análise de ações com IA. FinBridge é um serviço de dados hospedado que coleta dados financeiros oficiais para Coreia, Estados Unidos, Japão e Taiwan (além de demonstrações europeias) todas as noites, normaliza tudo em um único esquema e os disponibiliza para ChatGPT, Claude, Cursor ou qualquer cliente MCP — e para qualquer outra coisa via 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
Plano gratuito, sem cartão: 200 chamadas/dia, todas as ferramentas, os últimos 4 exercícios fiscais e 130 sessões de negociação. Planos pagos compram profundidade de histórico, não tentativas.

Somente fontes oficiais, e somente fontes que podemos redistribuir: OpenDART, SEC EDGAR, EDINET, TWSE/TPEx OpenAPI, data.go.kr (Comissão de Serviços Financeiros), Databento (preços diários dos EUA), séries públicas do FRED, dados públicos de exchanges via ccxt. Cada resposta indica sua fonte e data de referência, e cada empresa possui um page_url para uma página pública com o arquivamento por trás de cada número.

Cobertura

Mercado	Fonte	Demonstrações e arquivamentos	Preços diários	Segmentos	Screeners / backtests
Coreia (KRX)	OpenDART · data.go.kr	✅ K-IFRS, normalizado, revisões mantidas	✅ ajustado por eventos corporativos, 2020–	✅	✅
Estados Unidos	SEC EDGAR · Databento	✅ US-GAAP, como arquivado (point-in-time) histórico	✅ desde 2023-03, ajustado por splits	✅ (SEC DERA)	✅
Taiwan	TWSE / TPEx OpenAPI	✅ TW-IFRS	✅ 2004–	—	✅
Japão	EDINET	✅ J-GAAP / IFRS	— (sem fonte redistribuível)	✅	—
Europa	ESEF / IFRS	✅ demonstrações	—	—	—

Páginas públicas para cada empresa operacional listada: https://www.gronox.kr/companies/{kr|us|jp|tw}/{symbol} (ex.: Samsung Electronics).

O que você obtém

Área	Ferramentas
Demonstrações e arquivamentos	DART / EDGAR financeiro (com os cinco pares mais próximos anexados), arquivamentos, eventos relevantes, negociações de insiders (DART · Form 4), participações institucionais 13F, feed de divulgações
Preços e indicadores técnicos	OHLCV diário (KR · US · TW), indicadores técnicos, instantâneos de valuation com percentis de mercado
Screeners	Template de tendência Minervini, CAN SLIM, playbooks de Kell e Schwartz, screens técnicos, screens de ETFs — todas as noites sobre todas as listagens
Pares e segmentos	`get_peers` por grupo industrial e tamanho, ou por similaridade de mix de negócios a partir de segmentos reportados
Pesquisa	Backtests de portfólio com custos de negociação (KR · US · TW), estudos de fatores point-in-time, execuções salvas, SQL somente leitura sobre o banco de dados
Macro e cripto	Séries e instantâneos do FRED, tickers de cripto / OHLCV / prêmio de exchange
Conta	Lista de observação, importação de portfólio

Referência de ferramentas (renderizada a partir do registro ao vivo): https://www.gronox.kr/docs

Início rápido

Claude (claude.ai / Desktop)

Configurações → Conectores → Adicionar conector personalizado → https://mcp.gronox.kr/mcp — faça login com o Google, sem necessidade de chave. Depois, em cada novo chat, abra + → FinBridge para ativá-lo (os conectores ficam desativados por conversa até você fazer isso) e pergunte.

Claude Code

claude mcp add --transport http finbridge https://mcp.gronox.kr/mcp --header "Authorization: Bearer smcp_..."

Obtenha uma chave em https://www.gronox.kr/login (login com Google, emitida instantaneamente).

ChatGPT (modo desenvolvedor)

Configurações → Apps e Conectores → Avançado → Modo desenvolvedor → Criar conector com a URL acima e sua chave smcp_ como token de acesso.

Qualquer cliente MCP (Gemini CLI, Cursor, …)

{"mcpServers": {"finbridge": {"httpUrl": "https://mcp.gronox.kr/mcp",
  "headers": {"Authorization": "Bearer smcp_..."}}}}

REST (sem 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. Mesma chave, mesma cota, mesma profundidade que o MCP.

Prompts integrados

O FinBridge registra três prompts MCP, para você começar sem digitar uma pergunta. No Claude.ai ou Claude Desktop, ative o FinBridge no chat (+ → FinBridge), depois abra + → FinBridge novamente e escolha um prompt; no Claude Code, digite o comando de barra. Clientes que não listam prompts (Cursor, modo desenvolvedor do ChatGPT): cole a linha única.

Prompt	O que faz	Claude Code	Cole em vez disso
Lista de observação da semana	O que passou nos screens de tendência, CAN SLIM, VCP e RS esta semana (KR/US/TW), depois um olhar mais atento aos três mais fortes	`/mcp__finbridge__weekly_watchlist kr`	"Execute a lista de observação do FinBridge desta semana para a Coreia e verifique os três mais fortes com get_valuation e get_technicals."
Check-up de empresa	Uma empresa de ponta a ponta: quatro demonstrações anuais, valuation vs cinco pares, indicadores técnicos, arquivamentos mais recentes, cada número com data	`/mcp__finbridge__company_checkup 005930`	"Faça um check-up do FinBridge da Samsung Electronics (005930) com datas data_as_of."
Três primeiras perguntas	Um tour de um minuto: pares, um screen, quatro anos de demonstrações	`/mcp__finbridge__first_questions`	"Acabei de conectar o FinBridge — responda às três perguntas iniciais e mostre qual ferramenta você usou."

Boas primeiras perguntas

"Compare a Samsung Electronics com seus cinco pares mais próximos em P/L, ROE e crescimento de receita."
"Filtre a KOSDAQ por nomes acima de RS 90 que passem no template de tendência."
"Puxe as últimas quatro demonstrações anuais da Apple e resuma as tendências de margem."

Notas

Os dados são um instantâneo noturno (o feed de arquivamentos é atualizado a cada 5 minutos); não são cotações em tempo real.
As demonstrações seguem o padrão contábil local (K-IFRS, US-GAAP, J-GAAP/IFRS, TW-IFRS), portanto, os índices entre mercados são aproximações.
Apenas informações, não aconselhamento de investimento. O FinBridge não é afiliado a nenhum trader cujos critérios publicados ele implementa.
Este repositório é a listagem pública (manifesto de registro server.json) do serviço hospedado; o servidor em si não é open source.

Contato: 4y.changemaker@gmail.com

Licença

O conteúdo deste repositório (metadados de listagem e documentação) é disponibilizado sob a Licença MIT. O serviço hospedado FinBridge e seu código-fonte não fazem parte deste repositório e são fornecidos sob os Termos de Serviço do FinBridge.