Equibles

Equibles

Equibles é um servidor MCP de dados financeiros open-source e auto-hospedado — uma alternativa open-source a um Terminal Bloomberg, construído para agentes de IA em vez de humanos. Ele coleta, armazena e serve arquivos da SEC e dados financeiros XBRL, participações institucionais 13F, negociações de insiders e do congresso, dados de vendas a descoberto FINRA/SEC, indicadores econômicos FRED, posicionamento CFTC e CBOE, arquivamentos de fundos, contratos governamentais e preços diários de ações — e expõe tudo isso através do Model Context Protocol, para que Claude, ChatGPT, Cursor ou qualquer agente possa consultá-lo diretamente. Roda no seu próprio hardware com Docker, gratuitamente, para sempre.

Este é o núcleo open-source do Equibles. O Equibles Cloud executa exatamente este núcleo e adiciona mais ferramentas por cima — transcrições e áudio de calls de resultados, cotações em tempo real, cadeias de opções com Gregos, KPIs e guidance extraídos por LLM, recompra de ações, arquivamentos de IPO, mudanças executivas, múltiplos de valuation, composição de índices, acompanhamento de portfólio e um screener completo do mercado dos EUA. Mesmo protocolo, mesmos nomes de ferramentas, nada para rodar — veja o que está incluído.

Não quer rodar nada? Aponte seu assistente de IA para https://mcp.equibles.com/mcp e obtenha uma chave de API gratuita em equibles.com/mcp — 100 requisições/dia, sem cartão. Guias de configuração por cliente estão em daniel3303/stock-market-mcp-server.

Veja docs/ para o guia do usuário e documentação técnica.

O que está incluído

Tudo marcado como Auto-hospedado é coletado, armazenado e servido por este repositório — 61 ferramentas MCP, sem conta, sem chave. O Equibles Cloud executa exatamente este núcleo através do mesmo protocolo com os mesmos nomes de ferramentas, e adiciona mais ferramentas por cima.

Domínio	Fonte de Dados	Auto-hospedado	Equibles Cloud	Descrição
Arquivamentos SEC	SEC EDGAR	✅	✅	Relatórios anuais/trimestrais/atuais 10-K, 10-Q, 8-K com busca em texto completo
Demonstrações Financeiras	SEC XBRL	✅	✅	Demonstração de resultados, balanço patrimonial e fatos de fluxo de caixa analisados por período fiscal
Participações	SEC 13F-HR	✅	✅	Propriedade institucional — quem possui o quê, quanto e tendência ao longo do tempo
Arquivamentos de Fundos	SEC NPORT / N-CEN / Form D	✅	✅	Participações de portfólio de fundos, operações de fundos registrados (provedores de serviços) e ofertas isentas (colocações privadas)
Consultores de Investimento	SEC Form ADV	✅	✅	Consultores registrados na SEC — ativos sob gestão, escritório principal, contagem de funcionários, estrutura de taxas
Negociação de Insiders	SEC Forms 3/4/5/144	✅	✅	Transações de diretores, executivos e proprietários de 10%, declarações anuais de propriedade e vendas propostas (Form 144)
Negociação do Congresso	Divulgações da Câmara/Senado	✅	✅	Transações de valores mobiliários por membros do Congresso, incluindo a ação, opção, título ou outro instrumento arquivado
Dados de Vendas a Descoberto	SEC / FINRA	✅	✅	Falhas de entrega (SEC), volume diário de vendas a descoberto e juros a descoberto (FINRA)
Indicadores Econômicos	FRED (Federal Reserve)	✅	✅	Taxas de juros, inflação, emprego, PIB, spreads de rendimento e mais
Preços de Ações	Yahoo Finance	✅	✅	Preços diários OHLCV com indicadores técnicos (SMA, RSI, MACD)
Posicionamento de Futuros	CFTC	✅	✅	Dados de Compromissos dos Traders (COT) para mais de 30 contratos futuros
Indicadores de Mercado	CBOE	✅	✅	Índice de volatilidade VIX (1990+) e índices de opções de compra/venda por categoria
Contratos Governamentais	USAspending.gov	✅	✅	Prêmios de contratos federais para empresas públicas — valores, agências concedentes, datas e códigos NAICS/PSC
Catalisadores FDA	FDA.gov	✅	✅	Calendário de reuniões do comitê consultivo (AdComm) — datas programadas do painel da FDA, centro e título que atuam como catalisadores regulatórios para ações de biotecnologia/farmacêuticas
Transcrições de Calls de Resultados	Webcasts de empresas	—	✅	Transcrições completas de calls trimestrais com atribuição de falantes, pesquisáveis junto com arquivamentos
Áudio de Calls de Resultados	Webcasts de empresas	—	✅	A gravação do call em si, reproduzível e alinhada à transcrição
Resumos de Resultados, Guidance e Mudança Narrativa	Calls de resultados + comunicados	—	✅	Resumos trimestrais aprovados por verificadores, citações de calls, mudanças narrativas derivadas, revisões de guidance da gestão e resultados reportados versus guidance anterior da empresa
Cotações em Tempo Real	Feed de mercado licenciado	—	✅	Cotações em tempo real de ações dos EUA
Cadeias de Opções	Feed de opções licenciado	—	✅	Cadeias por vencimento e preço de exercício com bid/ask, volume, juros em aberto, volatilidade implícita e delta/gamma/theta/vega
KPIs de Empresas	Arquivamentos + comunicados de resultados	—	✅	Métricas operacionais que uma empresa reporta mas o XBRL nunca padronizou, além de pontes GAAP-para-não-GAAP
Guidance	Comunicados de resultados + calls	—	✅	Guidance futuro da gestão, seus intervalos e como mudou entre trimestres
Recompra de Ações e ATM	8-K / 10-Q	—	✅	Programas autorizados de recompra e programas de equity at-the-market, com valores e datas
Feed de IPO	SEC S-1 / F-1	—	✅	Novos registros com termos de oferta, subscritores, fatores de risco e financeiros pré-IPO
Relações com Investidores	Sites de RI de empresas	—	✅	Próximos eventos, aparições em conferências e comunicados do newsroom de RI
Executivos	SEC 8-K / DEF 14A	—	✅	Nomeações e saídas, além de valores da Tabela de Remuneração Resumida
Múltiplos de Valuation	Derivados	—	✅	P/L, P/V, P/VP, EV/EBIT, EV/EBITDA atuais e históricos e mais, com os períodos em que cada um foi calculado
Screener	Derivados	—	✅	Filtre todo o mercado dos EUA por valuation, margens, crescimento, propriedade, dados de vendas a descoberto e dividendos
Smart Money	Derivados	—	✅	Pontuações de sentimento de insiders, portfólios de superinvestidores e atividade congressional em todo o mercado
Sinais de Risco	Arquivamentos SEC	—	✅	Linguagem de continuidade operacional e divulgações de concentração de clientes
Contexto de Mercado	Derivados	—	✅	Ações correlacionadas, além de calendário de mercado e status de aberto/fechado
Composição de Índices	SEC N-PORT + arquivos de participações de fundos	—	✅	Constituintes e histórico de mudanças de membros para S&P 500/400/600, Nasdaq-100, Russell 1000/2000 e Dow, além de previsões de adição e exclusão baseadas em regras
Portfólios	Sua própria conta	—	✅	Acompanhe participações e listas de observação em ações e opções, com custo base e lucro/prejuízo realizado/não realizado. As únicas ferramentas no servidor que escrevem

Por que alguns dados são apenas na nuvem

Nada acima é retido deste repositório. As linhas apenas na nuvem são dados cuja produção precisa de infraestrutura que você não montaria em casa:

• Transcrições e áudio — calls de resultados são webcasts, não arquivamentos. Cada um precisa ser descoberto e gravado por uma frota de navegadores, depois processado por reconhecimento de fala em GPU com diarização de falantes, a cada call, a cada trimestre.
• Cotações em tempo real e cadeias de opções — feeds em tempo real licenciados, além de um serviço de streaming sempre ativo para distribuí-los. Nem a licença nem o tempo de atividade cabem em um contêiner em um laptop.
• KPIs, guidance, recompras, termos de IPO, executivos, sinais de risco — extraídos de arquivamentos, procurações e comunicados de resultados por pipelines de extração LLM com passes de verificação e uma fila de revisão humana, o que requer capacidade de inferência sustentada.
• Eventos e notícias de relações com investidores — coletados de milhares de sites de RI de empresas, precisando da mesma frota de navegadores furtivos que os webcasts.
• Múltiplos, screener, smart money, contexto de mercado — derivados, e só fazem sentido sobre um corpus totalmente retroalimentado de todo o mercado, em vez dos tickers que você por acaso coletou até agora.
• Composição de índices — montada a partir do cronograma N-PORT de cada fundo de rastreamento, além do arquivo de participações de cada fundo buscado diariamente, o que precisa do corpus NPORT completo e de um buscador que continua reaprendendo para onde esses arquivos foram movidos.
• Portfólios — não são dados coletados: são seus, armazenados contra sua conta. A versão auto-hospedada não tem contas, então não há contra o que armazená-los.

Além dos dados, a nuvem já está retroalimentada e mantida atualizada, e é gerenciada — sem scrapers para cuidar. Este repositório é gratuito para sempre sob AGPL-3.0; a nuvem tem um nível gratuito de 100 requisições/dia sem cartão.

Comece no nível gratuito e auto-hospede quando preferir ser dono da stack.

Início Rápido

Docker Compose (recomendado)

A maneira mais rápida de colocar tudo em funcionamento. Requer Docker.

git clone https://github.com/daniel3303/Equibles.git
cd Equibles
cp .env.example .env
# Edit .env and set SEC_CONTACT_EMAIL (required by SEC EDGAR fair access policy)
docker compose up

Isso inicia:

Serviço	Porta	Descrição
db	5432	ParadeDB (PostgreSQL + pgvector + pg_search)
web	8080	Portal web para navegar nos dados
mcp	8081	Servidor MCP para assistentes de IA
worker	—	Scrapers (SEC, FINRA, Congresso, FRED, Yahoo, CFTC, CBOE, USAspending, FDA)

A coleta de dados começa automaticamente. Arquivamentos SEC, participações, negociações de insiders e negociações do congresso começarão a ser populados em minutos.

Configuração

Todas as configurações podem ser definidas via um arquivo .env na raiz do projeto (recomendado para Docker) ou variáveis de ambiente.

Dados de Vendas a Descoberto FINRA (chave de API gratuita necessária):

O scraper da FINRA (volume de vendas a descoberto e juros a descoberto) requer uma chave de API gratuita. Sem ela, o scraper é ignorado graciosamente e todos os outros scrapers funcionam normalmente. Dados de falhas de entrega vêm da SEC e funcionam sem credenciais FINRA.

Para obter uma chave:

1. Vá ao Console de API da FINRA e entre (uma conta Google funciona)
2. Abra o menu API Credentials e crie uma nova API Key
3. Copie o Client ID e o Client Secret
4. Defina Finra__ClientId e Finra__ClientSecret no seu arquivo .env ou nas variáveis de ambiente

O fluxo mais antigo developer.finra.org "Teams & Apps" foi aposentado — use o Console de API acima.

Dados Econômicos FRED (chave de API gratuita necessária):

O scraper da FRED requer uma chave de API gratuita do Federal Reserve Bank de St. Louis. Sem ela, o scraper é ignorado graciosamente e todos os outros scrapers funcionam normalmente.

Para obter uma chave:

1. Registre-se em fred.stlouisfed.org/docs/api/api_key.html
2. Copie a chave de API de 32 caracteres
3. Defina Fred__ApiKey no seu arquivo .env ou nas variáveis de ambiente

Filtragem de Tickers (opcional):

Por padrão, todos os tickers são sincronizados. Para limitar a sincronização de dados a ações específicas, defina uma única lista de tickers que se aplica a todos os scrapers:

# .env — sync only these tickers (applies to all scrapers)
Worker__TickersToSync__0=AAPL
Worker__TickersToSync__1=MSFT
Worker__TickersToSync__2=GOOGL

Quando não definido, todas as ações são sincronizadas.

Data Mínima de Sincronização (opcional):

Por padrão, todos os scrapers começam em janeiro de 2020. Defina uma data mais recente para sincronização inicial mais rápida, ou vá tão longe quanto 2000-01-01 para mais dados históricos:

# .env — start syncing from 2024 instead of 2020
Worker__MinSyncDate=2024-01-01

Embedding (opt-in):

Configuração	Padrão	Descrição
Embedding__Enabled	false	Defina como true para habilitar a geração de embeddings vetoriais
Embedding__Provider	Ollama	Ollama (/api/embed) ou OpenAI (/v1/embeddings — vLLM, Text-Embeddings-Inference ou OpenAI)
Embedding__BaseUrl	—	Endpoint de embedding (ex.: http://localhost:11434)
Embedding__ModelName	—	Nome do modelo (ex.: qwen3-embedding:0.6b)
Embedding__ApiKey	—	Token Bearer, se o servidor exigir um (ex.: vLLM --api-key)
Embedding__BatchSize	10	Textos por lote de embedding

Notificações de atualização (opcional):

Configuração	Padrão	Descrição
CHECK_FOR_UPDATES	true	Quando true, o portal web verifica os Releases do GitHub e mostra um banner quando uma versão mais recente está disponível. Defina como false para desativar.

Autenticação (opcional):

Configuração	Padrão	Descrição
AUTH_USERNAME	—	Nome de usuário do portal web (autenticação desativada se vazio)
AUTH_PASSWORD	—	Senha do portal web (autenticação desativada se vazio)
MCP_API_KEY	—	Chave de API do servidor MCP (autenticação desativada se vazio)

Quando definidos, o portal web exige login e o servidor MCP exige o cabeçalho Authorization: Bearer <key>. Quando não definidos, tudo é de acesso aberto (padrão).

Atualização

O portal web verifica os lançamentos do GitHub em um cronograma e mostra um banner quando uma versão mais recente está disponível (desative com CHECK_FOR_UPDATES=false). Para atualizar para o lançamento mais recente:

Docker Compose:

git pull
docker compose up -d --build --remove-orphans

Inclua quaisquer arquivos de override do Compose opcionais no comando de atualização para que esses serviços permaneçam habilitados.

A partir do código-fonte:

git pull
dotnet build Equibles.sln

As migrações de banco de dados são aplicadas automaticamente na inicialização. Revise o changelog para mudanças notáveis antes de atualizar.

Portal Web

O portal web em http://localhost:8080 fornece uma interface baseada em navegador para explorar dados:

• Ações — Navegue e pesquise todas as empresas monitoradas, visualize gráficos de preços com indicadores técnicos (SMA, EMA, RSI, MACD, Bandas de Bollinger), selos de cruzamento dourado/death-cross e sequência de preços, desempenho versus SPY, além de abas por ação para participações institucionais, dados de vendas a descoberto, arquivamentos SEC, demonstrações financeiras, negociações de insiders, vendas propostas (Formulário 144), participações de fundos (NPORT), operações de fundos (N-CEN), ofertas isentas (Formulário D) e negociações de congressistas
• Instituições — Navegue pelos detentores institucionais (hedge funds, gestores de ativos), visualize perfis detalhados com detalhamento de portfólio, alocação por setor, atividade trimestral, backtesting e comparações lado a lado. Os declarantes são pontuados com base no desempenho ajustado ao risco (alfa vs. um benchmark) e uma página de Índice de Dinheiro Inteligente agrega os fundos com maior pontuação em um sinal de consenso. Inclui um screener de participações com filtros (número de declarantes, valor, % de float, localização, AUM/número de posições, setor) e exportação CSV
• Assessores — Navegue pelos assessores de investimento registrados na SEC (/advisers), classificados por ativos sob gestão, com perfis por empresa (AUM regulatório, escritório principal, número de funcionários, estrutura de taxas)
• Negociação de Insiders — Painel mostrando as maiores compras, vendas e transações de insiders nos últimos 90 dias
• Atividade de Vendas a Descoberto — Ranking dos mais vendidos a descoberto (/most-shorted, classificados pelo interesse de vendas a descoberto da FINRA) e maior volume diário de vendas a descoberto (/short-volume), cada um com seletor de data, ordenação no servidor e paginação
• Economia — Navegue pelos indicadores econômicos FRED agrupados por categoria (taxas de juros, inflação, emprego, PIB, etc.) com gráficos e estatísticas
• Futuros — Dados de posicionamento do CFTC Commitments of Traders para mais de 30 contratos futuros (commodities, índices, moedas) com gráficos de posições comerciais/não comerciais
• Mercado — Indicadores de mercado CBOE: índice de volatilidade VIX com gráficos OHLC, índices put/call (ações, índices, total, VIX, ETP)
• Busca — Busca global em ações, instituições, insiders e membros do congresso com filtros por categoria e intervalos de datas
• Status — Saúde do sistema, status dos workers, contagens de dados e log de erros

Servidor MCP

O servidor MCP expõe ferramentas de dados financeiros para assistentes de IA (Claude, ChatGPT, etc.):

• Participações Institucionais — Principais detentores, histórico de propriedade, portfólios e resumo de instituições, alocação por setor, atividade trimestral, ações mais detidas, participações de consenso, sobreposição de fundos, atividade 13F em todo o mercado, busca de instituições
• Negociação de Insiders — Transações de insiders, resumo de propriedade, vendas propostas (Formulário 144), busca de insiders
• Negociação de Congressistas — Negociações para um ticker, negociações de um membro, busca de membros
• Documentos SEC — Busca de texto completo, busca semântica, navegação de documentos, busca por palavras-chave dentro de arquivamentos
• Demonstrações Financeiras — Série temporal de fatos XBRL por ticker, comparação de fatos entre tickers, demonstração de resultados / balanço patrimonial / fluxo de caixa completos por período fiscal
• Arquivamentos de Fundos e Assessores — Participações de portfólio de fundos (NPORT), operações de fundos registrados (N-CEN), ofertas isentas (Formulário D) e consulta e busca de assessores de investimento registrados na SEC (Formulário ADV)
• Dados de Vendas a Descoberto — Volume diário de vendas a descoberto, maior volume diário de vendas a descoberto em todo o mercado, interesse de vendas a descoberto quinzenal e o snapshot mais recente de interesse de vendas a descoberto entre tickers
• Indicadores Econômicos — Consulta de dados FRED, snapshot macro mais recente, busca de indicadores entre categorias
• Preços de Ações — Histórico diário OHLCV com fechamento ajustado, fechamento mais recente de um ou mais tickers e indicadores técnicos sob demanda (EMA, Oscilador Estocástico, Average True Range, On-Balance Volume, Bandas de Bollinger)
• Posicionamento de Futuros — Dados de posicionamento COT, snapshot mais recente de todos os contratos, busca de contratos
• Indicadores de Mercado — Dados históricos do VIX, índices put/call por tipo (ações, índices, total, VIX, ETP)
• Contratos Governamentais — Prêmios de contratos federais vencidos por um ticker (agência concedente, valor, datas do período) e um ranking dos maiores contratantes de empresas públicas por total de dólares federais em um intervalo de datas (USAspending.gov)
• Catalisadores FDA — Reuniões agendadas do comitê consultivo (AdComm) da FDA em um intervalo de datas — as datas de catalisadores regulatórios que movem ações de biotecnologia e farmacêuticas (FDA.gov)

Formato de Saída (GCF, opt-in)

Por padrão, as ferramentas de tabela retornam tabelas markdown. Definir EQUIBLES_OUTPUT_FORMAT=gcf usa o Graph Compact Format quando ele é menor; caso contrário, volta para markdown. O GCF carrega as mesmas células que a tabela markdown mostraria, com os nomes das colunas fatorados em um único cabeçalho e o preenchimento | por célula e a linha separadora removidos. Nas formas de tabela das próprias ferramentas, isso é aproximadamente 13–16% menos tokens (o200k), sem perdas.

Ele é deliberadamente conservador: cada valor de célula é preservado literalmente (a formatação compacta-USD, agrupada por vírgulas, decimal adaptativo e travessão não é alterada — o GCF apenas muda o enquadramento, não os números que um modelo lê), e qualquer linha que não corresponda à forma das colunas do cabeçalho volta para a tabela markdown, então um resultado nunca é descartado ou corrompido. A saída padrão não é alterada, a menos que a variável seja definida. O GCF é licenciado sob MIT e seu codificador é sem dependências.

Conectando ao Claude Desktop

Adicione isto ao arquivo de configuração do Claude Desktop (claude_desktop_config.json):

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "equibles": {
      "url": "http://localhost:8081/mcp"
    }
  }
}

Reinicie o Claude Desktop e as ferramentas Equibles estarão disponíveis. Você pode então fazer perguntas como "Quem são os principais detentores institucionais da AAPL?" ou "Pesquise o 10-K mais recente da Apple para discutir o crescimento da receita."

Conectando ao Claude Code

Adicione o servidor MCP ao Claude Code:

claude mcp add equibles --transport http http://localhost:8081/mcp

Conectando ao ChatGPT Desktop

Adicione isto ao arquivo de configuração do ChatGPT Desktop:

macOS: ~/Library/Application Support/com.openai.chat/mcp.json Windows: %APPDATA%\com.openai.chat\mcp.json

{
  "servers": {
    "equibles": {
      "url": "http://localhost:8081/mcp"
    }
  }
}

Reinicie o ChatGPT Desktop e as ferramentas Equibles estarão disponíveis.

Conectando ao OpenClaw

No OpenClaw, adicione um servidor MCP com a URL http://localhost:8081/mcp (transporte HTTP).

Outros Clientes MCP

Qualquer cliente compatível com MCP pode se conectar a http://localhost:8081/mcp (transporte HTTP).

Ferramentas

Esta build auto-hospedada expõe 61 ferramentas via MCP. O servidor hospedado em https://mcp.equibles.com/mcp executa o mesmo núcleo e adiciona mais por cima. Catálogo completo e configuração do cliente: daniel3303/stock-market-mcp-server.

Participações institucionais 13F

• GetInstitutionCloneBacktest — backtest de clonagem do portfólio 13F de um declarante vs. um benchmark
• GetTopHolders — principais detentores institucionais de uma ação (13F-HR)
• GetInstitutionalOwnershipHistory — tendência de propriedade institucional entre trimestres
• GetInstitutionPortfolio — portfólio 13F de uma instituição
• SearchInstitutions — busca tokenizada estrita por nome/CIK com data de arquivamento, AUM 13F e número de posições
• GetTopInstitutionalBuyersSellers — maiores adições/reduções em uma ação neste trimestre
• GetMarketWide13FActivity — rankings 13F em todo o mercado
• GetMostHeldStocks — ações por amplitude institucional
• GetInstitutionSummary — resumo do declarante (valor, concentração, rotatividade)
• GetInstitutionSectorAllocation — alocação por setor
• GetInstitutionQuarterlyActivity — iniciado/aumentado/reduzido/saído vs. trimestre anterior
• CompareInstitutionPortfolios — sobreposição de portfólio entre duas instituições
• GetInstitutionConsensusHoldings — portfólio de consenso de 2–25 instituições

Negociação de insiders

• GetInsiderTransactions — transações de insiders dos Formulários 4/5
• GetInsiderOwnership — propriedade de insiders classificada por ações
• GetForm144ProposedSales — vendas propostas do Formulário 144
• SearchInsiders — busca estrita por palavra inteira de nomes arquivados com aliases públicos verificados

Busca de arquivamentos SEC

• SearchDocuments — busca híbrida por palavras-chave + semântica em todos os arquivamentos, opcionalmente limitada por ticker
• SearchDocument — busca dentro de um único arquivamento
• ListCompanyDocuments — navegue pelos arquivamentos de uma empresa
• ReadDocumentLines — leia um intervalo de linhas de um arquivamento

Fundos, ETFs e assessores

• SearchInvestmentAdvisers — busca tokenizada estrita por nome de assessor (Formulário ADV)
• GetInvestmentAdviser — perfil ADV por CRD
• GetFundNcenReports — operações de fundos do N-CEN com resolução exata de identificador de diretório
• GetFundsHoldingStock — fundos que detêm uma ação
• GetFormDOfferings — colocações privadas (Formulário D)
• GetFailsToDeliver — dados FTD da SEC
• SearchFunds — busca tokenizada estrita por fundo/registrante/ticker com aliases verificados de classes de ações
• GetFundProfile — perfil do fundo + participações NPORT-P com contagens explícitas de cobertura reportada versus armazenada

Fundamentos (XBRL)

• GetFinancialStatement — demonstração de resultados/balanço/fluxo de caixa ancorada em um fim de período; fluxos USD trimestrais são trimestres discretos reportados ou restos derivados exatos, nunca totais YTD
• GetFinancialFact — um conceito ao longo do tempo com intervalos exatos e avisos de cobertura de aliases desatualizados
• CompareFinancialFact — um conceito entre empresas
• GetRevenueBreakdown — receita por segmento/geografia/produto, além de lucro operacional por segmento reportado e margem derivada

Dados econômicos (FRED)

• GetEconomicIndicator — uma série FRED
• GetLatestEconomicIndicators — valores mais recentes por categoria
• SearchEconomicIndicators — busca tokenizada estrita de séries selecionadas com aliases macro padrão
• GetEconomicCalendar — calendário de lançamentos macro dos EUA

Futuros (CFTC COT)

• GetCftcPositioning — posicionamento COT para um contrato
• GetLatestCftcPositioning — snapshot COT mais recente
• SearchCftcMarkets — busca tokenizada estrita por nome, código ou símbolo padrão de futuros

Volatilidade (CBOE)

• GetPutCallRatios — índices put/call
• GetVixHistory — OHLC diário do VIX

Calendário FDA

• GetFdaAdvisoryCommitteeMeetings — reuniões agendadas do comitê consultivo da FDA

Negociação de congressistas

• GetCongressionalTrades — negociações para um ticker
• GetMemberTrades — negociações de um membro
• GetMemberNetWorth — histórico de patrimônio líquido do membro
• SearchCongressMembers — busca tokenizada estrita do quadro com aliases públicos verificados

Dados de vendas a descoberto (FINRA)

• GetShortVolume — volume diário de vendas a descoberto
• GetShortInterest — interesse de vendas a descoberto quinzenal
• GetShortInterestSnapshot — snapshot em todo o mercado
• GetLargestShortVolume — maior volume diário de vendas a descoberto
• GetShortSqueezeScores — pontuações compostas de short squeeze
• GetOffExchangeVolume — volume de dark-pool/OTC

Preços de ações

• GetStockPrices — OHLCV diário mais o fechamento ajustado auxiliar armazenado quando difere
• GetLatestClosingPrices — fechamento/variação/volume mais recentes
• GetStochasticOscillator — oscilador estocástico (%K/%D)
• GetAverageTrueRange — average true range (ATR)
• GetOnBalanceVolume — on-balance volume (OBV)
• GetBollingerBands — Bandas de Bollinger

Contratos governamentais (USAspending)

• GetGovernmentContracts — prêmios de contratos federais para uma empresa
• GetTopGovernmentContractors — maiores contratantes de empresas públicas

Embeddings Vetoriais (avançado, opt-in)

Vector embeddings permitem busca semântica em documentos SEC (ex.: "encontrar discussão sobre crescimento de receita no 10-K da Apple"). Isso requer o download do runtime Ollama (~2GB) e do modelo Qwen3-Embedding-0.6B (~640MB).

docker compose -f docker-compose.yml -f docker-compose.embedding.yml up

Isso adiciona o Ollama e configura os serviços existentes de web, MCP e worker para usá-lo:

Serviço	Porta	Descrição
embedding	11434	Servidor Ollama com o modelo Qwen3-Embedding-0.6B
embedding-pull	—	Download único do modelo antes de o worker iniciar
worker	—	O worker existente, com geração de embeddings habilitada

Sem a substituição de embedding, a busca de texto completo BM25 via ParadeDB ainda funciona de fábrica — a busca vetorial é puramente aditiva.

O Ollama integrado é o padrão porque não requer GPU e roda em qualquer lugar. Para embedding em lote em escala, aponte Embedding__Provider=OpenAI para um servidor em lote como vLLM ou Text-Embeddings-Inference — eles processam continuamente em lote na GPU e são muito mais rápidos que o Ollama para grandes corpora. Consulte docs/guide/how-to-use-external-embedding-endpoint.md.

Capturas de tela

Detalhe da Ação	Ações
Dados Econômicos	Detalhe do Indicador Econômico

Contribuindo

Consulte CONTRIBUTING.md para configuração de desenvolvimento, arquitetura do projeto e como estender a plataforma. Contribuidores devem assinar o Contrato de Licença de Contribuidor — isso é tratado automaticamente por um bot quando você abre um pull request.

Licença

AGPL-3.0

Autor

Daniel Oliveira