Equibles

Equibles

Equibles es un servidor MCP de datos financieros de código abierto y autoalojado — una alternativa de código abierto a un Terminal Bloomberg, construido para agentes de IA en lugar de humanos. Recopila, almacena y sirve presentaciones SEC y estados financieros XBRL, tenencias institucionales 13F, operaciones de personas con información privilegiada y del Congreso, datos de ventas en corto de FINRA/SEC, indicadores económicos de FRED, posicionamiento de CFTC y CBOE, presentaciones de fondos, contratos gubernamentales y precios diarios de acciones — y expone todo ello a través del Protocolo de Contexto de Modelo, para que Claude, ChatGPT, Cursor o cualquier agente pueda consultarlo directamente. Se ejecuta en tu propio hardware con Docker, de forma gratuita y para siempre.

Este es el núcleo de código abierto de Equibles. Equibles Cloud ejecuta este mismo núcleo y añade más herramientas encima — transcripciones y audio de llamadas de resultados, cotizaciones en tiempo real, cadenas de opciones con griegas, KPIs y guía extraídos por LLM, recompra de acciones, presentaciones IPO, cambios ejecutivos, múltiplos de valoración, composición de índices, seguimiento de carteras y un screener completo del mercado estadounidense. Mismo protocolo, mismos nombres de herramientas, nada que ejecutar — consulta lo que incluye.

¿No quieres ejecutar nada? Apunta tu asistente de IA a https://mcp.equibles.com/mcp y obtén una clave API gratuita en equibles.com/mcp — 100 solicitudes/día, sin tarjeta. Las guías de configuración por cliente están en daniel3303/stock-market-mcp-server.

Consulta docs/ para la guía de usuario y la documentación técnica.

Qué Incluye

Todo lo marcado como Autoalojado es recopilado, almacenado y servido por este repositorio — 61 herramientas MCP, sin cuenta, sin clave. Equibles Cloud ejecuta este mismo núcleo sobre el mismo protocolo con los mismos nombres de herramientas, y añade más herramientas encima.

Dominio	Fuente de Datos	Autoalojado	Equibles Cloud	Descripción
Presentaciones SEC	SEC EDGAR	✅	✅	Informes anuales/trimestrales/actuales 10-K, 10-Q, 8-K con búsqueda de texto completo
Estados Financieros	SEC XBRL	✅	✅	Estado de resultados, balance general y flujo de caja analizados por período fiscal
Tenencia	SEC 13F-HR	✅	✅	Propiedad institucional — quién posee qué, cuánto y la tendencia a lo largo del tiempo
Presentaciones de Fondos	SEC NPORT / N-CEN / Form D	✅	✅	Tenencias de carteras de fondos, operaciones de fondos registrados (proveedores de servicios) y ofertas exentas (colocaciones privadas)
Asesores de Inversión	SEC Form ADV	✅	✅	Asesores registrados en la SEC — activos bajo gestión, oficina principal, número de empleados, estructura de tarifas
Operaciones de Información Privilegiada	SEC Forms 3/4/5/144	✅	✅	Transacciones de directores, ejecutivos y propietarios del 10%, declaraciones anuales de propiedad y ventas propuestas (Form 144)
Operaciones del Congreso	Declaraciones de Cámara/Senado	✅	✅	Transacciones de valores por miembros del Congreso, incluyendo la acción, opción, bono u otro instrumento presentado
Datos de Ventas en Corto	SEC / FINRA	✅	✅	Fallos de entrega (SEC), volumen diario de ventas en corto e interés corto (FINRA)
Indicadores Económicos	FRED (Reserva Federal)	✅	✅	Tasas de interés, inflación, empleo, PIB, diferenciales de rendimiento y más
Precios de Acciones	Yahoo Finance	✅	✅	Precios diarios OHLCV con indicadores técnicos (SMA, RSI, MACD)
Posicionamiento de Futuros	CFTC	✅	✅	Datos de Compromisos de los Operadores (COT) para más de 30 contratos de futuros
Indicadores de Mercado	CBOE	✅	✅	Índice de volatilidad VIX (1990+) y ratios put/call por categoría
Contratos Gubernamentales	USAspending.gov	✅	✅	Adjudicaciones de contratos federales a empresas públicas — montos, agencias adjudicadoras, fechas y códigos NAICS/PSC
Catalizadores FDA	FDA.gov	✅	✅	Calendario de reuniones del comité asesor (AdComm) — fechas programadas de paneles de la FDA, centro y título que actúan como catalizadores regulatorios para acciones de biotecnología/farmacéuticas
Transcripciones de Llamadas de Resultados	Webcasts de empresas	—	✅	Transcripciones completas de llamadas trimestrales con atribución de oradores, buscables junto con las presentaciones
Audio de Llamadas de Resultados	Webcasts de empresas	—	✅	La llamada grabada en sí, reproducible y alineada con la transcripción
Resúmenes de Resultados, Guía y Cambio Narrativo	Llamadas de resultados + comunicados	—	✅	Resúmenes trimestrales aprobados por verificadores, citas de llamadas, cambios narrativos derivados, revisiones de guía de gestión y resultados reportados frente a la guía previa de la empresa
Cotizaciones en Vivo	Fuente de mercado licenciada	—	✅	Cotizaciones de acciones estadounidenses en tiempo real
Cadenas de Opciones	Fuente de opciones licenciada	—	✅	Cadenas por vencimiento y precio de ejercicio con bid/ask, volumen, interés abierto, volatilidad implícita y delta/gamma/theta/vega
KPIs de Empresa	Presentaciones + comunicados de resultados	—	✅	Métricas operativas que una empresa reporta pero XBRL nunca estandarizó, más puentes GAAP a no-GAAP
Guía	Comunicados de resultados + llamadas	—	✅	Guía prospectiva de la gestión, sus rangos y cómo se movió entre trimestres
Recompra de Acciones y ATM	8-K / 10-Q	—	✅	Programas de recompra autorizados y programas de capital en el mercado, con montos y fechas
Feed IPO	SEC S-1 / F-1	—	✅	Nuevos registros con términos de oferta, aseguradores, factores de riesgo y finanzas pre-IPO
Relaciones con Inversores	Sitios de RI de empresas	—	✅	Próximos eventos, apariciones en conferencias y comunicados de prensa de RI
Ejecutivos	SEC 8-K / DEF 14A	—	✅	Nombramientos y salidas, más cifras de la Tabla de Compensación Resumida
Múltiplos de Valoración	Derivados	—	✅	P/E, P/S, P/B, EV/EBIT, EV/EBITDA actuales e históricos y más, con los períodos de los que se calcularon
Screener	Derivados	—	✅	Filtra todo el mercado estadounidense por valoración, márgenes, crecimiento, propiedad, datos de ventas en corto y dividendos
Dinero Inteligente	Derivados	—	✅	Puntuaciones de sentimiento de información privilegiada, carteras de superinversores y actividad del Congreso en todo el mercado
Indicadores de Riesgo	Presentaciones SEC	—	✅	Lenguaje de empresa en funcionamiento y divulgaciones de concentración de clientes
Contexto de Mercado	Derivados	—	✅	Acciones correlacionadas, más calendario de mercado y estado abierto/cerrado
Composición de Índices	SEC N-PORT + archivos de tenencias de fondos	—	✅	Constituyentes e historial de cambios de membresía para el S&P 500/400/600, Nasdaq-100, Russell 1000/2000 y el Dow, más pronósticos de adición y eliminación basados en reglas
Carteras	Tu propia cuenta	—	✅	Seguimiento de tenencias y listas de seguimiento en acciones y opciones, con base de costo y P&L realizado/no realizado. Las únicas herramientas del servidor que escriben

Por Qué Algunos Datos Son Solo en la Nube

Nada de lo anterior se retiene de este repositorio. Las filas solo en la nube son datos cuya producción necesita infraestructura que no montarías en casa:

• Transcripciones y audio — las llamadas de resultados son webcasts, no presentaciones. Cada una debe ser descubierta y grabada por una flota de navegadores, luego procesada con reconocimiento de voz por GPU con diarización de oradores, cada llamada, cada trimestre.
• Cotizaciones en vivo y cadenas de opciones — feeds en tiempo real licenciados, más un servicio de streaming siempre activo para distribuirlos. Ni la licencia ni el tiempo de actividad caben en un contenedor en un portátil.
• KPIs, guía, recompra de acciones, términos IPO, ejecutivos, indicadores de riesgo — extraídos de presentaciones, poderes y comunicados de resultados mediante canales de extracción LLM con pasos de verificación y una cola de revisión humana, lo que requiere capacidad de inferencia sostenida.
• Eventos y noticias de relaciones con inversores — recopilados de miles de sitios de RI de empresas, necesitando la misma flota de navegadores sigilosos que los webcasts.
• Múltiplos, screener, dinero inteligente, contexto de mercado — derivados, y solo significativos sobre un corpus completamente retroalimentado de todo el mercado en lugar de los tickers que has recopilado hasta ahora.
• Composición de índices — ensamblada a partir del cronograma N-PORT de cada fondo de seguimiento más el archivo de tenencias de cada fondo obtenido diariamente, lo que necesita el corpus NPORT completo y un buscador que siga reaprendiendo dónde se movieron esos archivos.
• Carteras — no son datos recopilados en absoluto: son tuyos, almacenados contra tu cuenta. La versión autoalojada no tiene cuentas, por lo que no hay nada contra lo que almacenarlos.

Más allá de los datos, la nube ya está retroalimentada y mantenida al día, y está gestionada — sin scrapers que cuidar. Este repositorio es gratuito para siempre bajo AGPL-3.0; la nube tiene un nivel gratuito de 100 solicitudes/día sin tarjeta.

Comienza en el nivel gratuito y autoalójalo cuando prefieras ser dueño de la pila.

Inicio Rápido

Docker Compose (recomendado)

La forma más rápida de tener todo funcionando. Requiere 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

Esto inicia:

Servicio	Puerto	Descripción
db	5432	ParadeDB (PostgreSQL + pgvector + pg_search)
web	8080	Portal web para navegar por los datos
mcp	8081	Servidor MCP para asistentes de IA
worker	—	Scrapers (SEC, FINRA, Congreso, FRED, Yahoo, CFTC, CBOE, USAspending, FDA)

La recopilación de datos comienza automáticamente. Las presentaciones SEC, tenencias, operaciones de información privilegiada y operaciones del Congreso comenzarán a poblarse en minutos.

Configuración

Todos los ajustes se pueden configurar mediante un archivo .env en la raíz del proyecto (recomendado para Docker) o variables de entorno.

Datos de Ventas en Corto de FINRA (clave API gratuita requerida):

El scraper de FINRA (volumen de ventas en corto e interés corto) requiere una clave API gratuita. Sin ella, el scraper se omite correctamente y todos los demás scrapers funcionan con normalidad. Los datos de fallos de entrega provienen de la SEC y funcionan sin credenciales de FINRA.

Para obtener una clave:

1. Ve a la Consola API de FINRA e inicia sesión (una cuenta de Google funciona)
2. Abre el menú Credenciales API y crea una nueva Clave API
3. Copia el ID de Cliente y el Secreto de Cliente
4. Establece Finra__ClientId y Finra__ClientSecret en tu archivo .env o variables de entorno

El flujo anterior de developer.finra.org "Teams & Apps" ha sido retirado — usa la Consola API anterior.

Datos Económicos de FRED (clave API gratuita requerida):

El scraper de FRED requiere una clave API gratuita del Banco de la Reserva Federal de St. Louis. Sin ella, el scraper se omite correctamente y todos los demás scrapers funcionan con normalidad.

Para obtener una clave:

1. Regístrate en fred.stlouisfed.org/docs/api/api_key.html
2. Copia la clave API de 32 caracteres
3. Establece Fred__ApiKey en tu archivo .env o variables de entorno

Filtrado de Tickers (opcional):

Por defecto, todos los tickers se sincronizan. Para limitar la sincronización de datos a acciones específicas, establece una lista única de tickers que se aplique a todos los scrapers:

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

Cuando no se establece, se sincronizan todas las acciones.

Fecha Mínima de Sincronización (opcional):

Por defecto, todos los scrapers comienzan desde enero de 2020. Establece una fecha más reciente para una sincronización inicial más rápida, o retrocede hasta 2000-01-01 para más datos históricos:

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

Embedding (opt-in):

Configuración	Predeterminado	Descripción
Embedding__Enabled	false	Establece en true para habilitar la generación de embeddings vectoriales
Embedding__Provider	Ollama	Ollama (/api/embed) o OpenAI (/v1/embeddings — vLLM, Text-Embeddings-Inference u OpenAI)
Embedding__BaseUrl	—	Endpoint de embedding (p. ej., http://localhost:11434)
Embedding__ModelName	—	Nombre del modelo (p. ej., qwen3-embedding:0.6b)
Embedding__ApiKey	—	Token Bearer, si el servidor lo requiere (p. ej., vLLM --api-key)
Embedding__BatchSize	10	Textos por lote de embedding

Notificaciones de actualización (opcional):

Configuración	Predeterminado	Descripción
CHECK_FOR_UPDATES	true	Cuando true, el portal web verifica los lanzamientos de GitHub y muestra un banner cuando hay una versión más reciente disponible. Establece en false para deshabilitar.

Autenticación (opcional):

Configuración	Predeterminado	Descripción
AUTH_USERNAME	—	Nombre de usuario del portal web (autenticación deshabilitada si está vacío)
AUTH_PASSWORD	—	Contraseña del portal web (autenticación deshabilitada si está vacía)
MCP_API_KEY	—	Clave API del servidor MCP (autenticación deshabilitada si está vacía)

Cuando se establecen, el portal web requiere inicio de sesión y el servidor MCP requiere el encabezado Authorization: Bearer <key>. Cuando no se establecen, todo es de acceso abierto (predeterminado).

Actualización

El portal web verifica los lanzamientos de GitHub en un horario programado y muestra un banner cuando hay una versión más reciente disponible (deshabilitar con CHECK_FOR_UPDATES=false). Para actualizar a la última versión:

Docker Compose:

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

Incluya cualquier archivo de anulación de Compose opcional en el comando de actualización para que esos servicios permanezcan habilitados.

Desde el código fuente:

git pull
dotnet build Equibles.sln

Las migraciones de base de datos se aplican automáticamente al iniciar. Revise el registro de cambios para ver cambios notables antes de actualizar.

Portal Web

El portal web en http://localhost:8080 proporciona una interfaz basada en navegador para explorar datos:

• Acciones — Explore y busque todas las empresas rastreadas, vea gráficos de precios con indicadores técnicos (SMA, EMA, RSI, MACD, Bandas de Bollinger), insignias de cruce dorado/de muerte y rachas de precios, rendimiento frente a SPY, además de pestañas por acción para tenencias institucionales, datos de venta en corto, presentaciones ante la SEC, estados financieros, operaciones de información privilegiada, ventas propuestas (Formulario 144), tenencias de fondos (NPORT), operaciones de fondos (N-CEN), ofertas exentas (Formulario D) y operaciones del Congreso
• Instituciones — Explore tenedores institucionales (fondos de cobertura, gestores de activos), vea perfiles detallados con desgloses de cartera, asignación por industria, actividad trimestral, backtesting y comparaciones lado a lado. Los declarantes se puntúan según el rendimiento ajustado al riesgo (alfa frente a un índice de referencia) y una página de Índice de Dinero Inteligente agrega los fondos con mayor puntuación en una señal de consenso. Incluye un filtro de tenencias con filtros (número de declarantes, valor, % de flotación, ubicación, AUM/número de posiciones, industria) y exportación CSV
• Asesores — Explore asesores de inversión registrados en la SEC (/advisers), clasificados por activos bajo gestión, con perfiles por firma (AUM regulatorio, oficina principal, número de empleados, estructura de tarifas)
• Operaciones de Información Privilegiada — Panel que muestra las principales compras, ventas y transacciones más grandes de información privilegiada en los últimos 90 días
• Actividad de Venta en Corto — Tabla de líderes de mayor venta en corto (/most-shorted, clasificados por interés corto de FINRA) y mayor volumen diario de venta en corto (/short-volume), cada uno con selector de fecha, ordenación en servidor y paginación
• Economía — Explore indicadores económicos de FRED agrupados por categoría (tasas de interés, inflación, empleo, PIB, etc.) con gráficos y estadísticas
• Futuros — Datos de posicionamiento de Compromisos de los Operadores de la CFTC para más de 30 contratos de futuros (materias primas, índices, divisas) con gráficos de posiciones comerciales/no comerciales
• Mercado — Indicadores de mercado de CBOE: índice de volatilidad VIX con gráficos OHLC, ratios put/call (acciones, índices, total, VIX, ETP)
• Búsqueda — Búsqueda global en acciones, instituciones, información privilegiada y miembros del Congreso con filtrado por categoría y rangos de fechas
• Estado — Salud del sistema, estado de los trabajadores, recuentos de datos y registro de errores

Servidor MCP

El servidor MCP expone herramientas de datos financieros para asistentes de IA (Claude, ChatGPT, etc.):

• Tenencia Institucional — Principales tenedores, historial de propiedad, carteras y resumen de instituciones, asignación sectorial, actividad trimestral, acciones más mantenidas, tenencias de consenso, superposición de fondos, actividad 13F en todo el mercado, búsqueda de instituciones
• Operaciones de Información Privilegiada — Transacciones de información privilegiada, resumen de propiedad, ventas propuestas (Formulario 144), búsqueda de información privilegiada
• Operaciones del Congreso — Operaciones para un ticker, operaciones de un miembro, búsqueda de miembros
• Documentos SEC — Búsqueda de texto completo, búsqueda semántica, navegación de documentos, búsqueda de palabras clave dentro de presentaciones
• Estados Financieros — Series temporales de hechos XBRL por ticker, comparación de hechos entre tickers, estado de resultados / balance general / flujo de caja completo por período fiscal
• Presentaciones de Fondos y Asesores — Tenencias de cartera de fondos (NPORT), operaciones de fondos registrados (N-CEN), ofertas exentas (Formulario D) y búsqueda y consulta de asesores de inversión registrados en la SEC (Formulario ADV)
• Datos de Venta en Corto — Volumen diario de venta en corto, mayor volumen diario de venta en corto en todo el mercado, interés corto quincenal y la instantánea más reciente de interés corto en todos los tickers
• Indicadores Económicos — Consulta de datos FRED, instantánea macro más reciente, búsqueda de indicadores por categorías
• Precios de Acciones — Historial diario OHLCV con cierre ajustado, cierre más reciente en uno o más tickers e indicadores técnicos bajo demanda (EMA, Oscilador Estocástico, Rango Verdadero Promedio, Volumen en Balance, Bandas de Bollinger)
• Posicionamiento de Futuros — Datos de posicionamiento COT, instantánea más reciente en todos los contratos, búsqueda de contratos
• Indicadores de Mercado — Datos históricos de VIX, ratios put/call por tipo (acciones, índices, total, VIX, ETP)
• Contratos Gubernamentales — Adjudicaciones de contratos federales ganadas por un ticker (agencia adjudicadora, monto, fechas del período) y una clasificación de los principales contratistas de empresas públicas por total de dólares federales en un rango de fechas (USAspending.gov)
• Catalizadores FDA — Reuniones programadas del comité asesor (AdComm) de la FDA en un rango de fechas: las fechas de catalizadores regulatorios que mueven las acciones de biotecnología y farmacéuticas (FDA.gov)

Formato de Salida (GCF, opcional)

Por defecto, las herramientas de tablas devuelven tablas markdown. Establecer EQUIBLES_OUTPUT_FORMAT=gcf usa Formato de Gráfico Compacto cuando es más pequeño; de lo contrario, vuelve a markdown. GCF lleva las mismas celdas que mostraría la tabla markdown, con los nombres de columnas factorizados en un solo encabezado y el | de relleno por celda y la fila separadora eliminados. En las formas de tabla propias de las herramientas, esto es aproximadamente 13–16% menos tokens (o200k), sin pérdidas.

Es deliberadamente conservador: cada valor de celda se conserva textualmente (el formato USD compacto, agrupado por comas, decimal adaptativo y guion largo no se toca — GCF solo cambia el marco, no los números que un modelo lee), y cualquier fila que no coincida con la forma de columna del encabezado vuelve a la tabla markdown, por lo que un resultado nunca se pierde o se distorsiona. La salida predeterminada no cambia a menos que se establezca la variable. GCF tiene licencia MIT y su codificador no tiene dependencias.

Conexión a Claude Desktop

Agregue esto a su archivo de configuración de 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 Claude Desktop y las herramientas de Equibles estarán disponibles. Luego puede hacer preguntas como "¿Quiénes son los principales tenedores institucionales de AAPL?" o "Busque en el último 10-K de Apple la discusión sobre el crecimiento de ingresos".

Conexión a Claude Code

Agregue el servidor MCP a Claude Code:

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

Conexión a ChatGPT Desktop

Agregue esto a su archivo de configuración de 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 ChatGPT Desktop y las herramientas de Equibles estarán disponibles.

Conexión a OpenClaw

En OpenClaw, agregue un servidor MCP con la URL http://localhost:8081/mcp (transporte HTTP).

Otros Clientes MCP

Cualquier cliente compatible con MCP puede conectarse a http://localhost:8081/mcp (transporte HTTP).

Herramientas

Esta compilación autoalojada expone 61 herramientas a través de MCP. El servidor alojado en https://mcp.equibles.com/mcp ejecuta este mismo núcleo y agrega más encima. Catálogo completo y configuración del cliente: daniel3303/stock-market-mcp-server.

Tenencia institucional 13F

• GetInstitutionCloneBacktest — backtest de clonación de la cartera 13F de un declarante frente a un índice de referencia
• GetTopHolders — principales tenedores institucionales de una acción (13F-HR)
• GetInstitutionalOwnershipHistory — tendencia de propiedad institucional entre trimestres
• GetInstitutionPortfolio — cartera 13F de una institución
• SearchInstitutions — búsqueda tokenizada de nombre/CIK de primer estricto con fecha de presentación, AUM 13F y número de posiciones
• GetTopInstitutionalBuyersSellers — mayores aumentos/reducciones en una acción este trimestre
• GetMarketWide13FActivity — tablas de líderes 13F en todo el mercado
• GetMostHeldStocks — acciones por amplitud institucional
• GetInstitutionSummary — resumen del declarante (valor, concentración, rotación)
• GetInstitutionSectorAllocation — asignación por sector
• GetInstitutionQuarterlyActivity — iniciado/aumentado/reducido/salido frente al trimestre anterior
• CompareInstitutionPortfolios — superposición de carteras entre dos instituciones
• GetInstitutionConsensusHoldings — cartera de consenso de 2–25 instituciones

Operaciones de información privilegiada

• GetInsiderTransactions — transacciones de información privilegiada de los Formularios 4/5
• GetInsiderOwnership — propiedad de información privilegiada clasificada por acciones
• GetForm144ProposedSales — ventas propuestas del Formulario 144
• SearchInsiders — búsqueda estricta de nombre completo de primera palabra con alias de nombre público verificados

Búsqueda de presentaciones SEC

• SearchDocuments — búsqueda híbrida de palabras clave + semántica en todas las presentaciones, opcionalmente limitada por ticker
• SearchDocument — búsqueda dentro de una sola presentación
• ListCompanyDocuments — navegue las presentaciones de una empresa
• ReadDocumentLines — lea un rango de líneas de una presentación

Fondos, ETFs y asesores

• SearchInvestmentAdvisers — búsqueda tokenizada estricta de nombre de asesor (Formulario ADV)
• GetInvestmentAdviser — perfil ADV por CRD
• GetFundNcenReports — operaciones de fondos de N-CEN con resolución exacta de identificador de directorio
• GetFundsHoldingStock — fondos que mantienen una acción
• GetFormDOfferings — colocaciones privadas (Formulario D)
• GetFailsToDeliver — datos FTD de la SEC
• SearchFunds — búsqueda tokenizada estricta de fondo/registrante/ticker con alias de clase de acción verificados
• GetFundProfile — perfil de fondo + tenencias NPORT-P con recuentos de cobertura explícitos reportados frente a almacenados

Fundamentales (XBRL)

• GetFinancialStatement — estado de resultados / balance / flujo de caja anclado a un fin de período; los flujos USD trimestrales se reportan como trimestres discretos o restos derivados exactos, nunca totales YTD
• GetFinancialFact — un concepto a lo largo del tiempo con rangos exactos y advertencias de cobertura de alias obsoletos
• CompareFinancialFact — un concepto entre empresas
• GetRevenueBreakdown — ingresos por segmento/geografía/producto más ingreso operativo de segmento reportado y margen derivado

Datos económicos (FRED)

• GetEconomicIndicator — una serie FRED
• GetLatestEconomicIndicators — valores más recientes por categoría
• SearchEconomicIndicators — búsqueda tokenizada estricta de series seleccionadas con alias macro estándar
• GetEconomicCalendar — calendario de publicaciones macro de EE. UU.

Futuros (CFTC COT)

• GetCftcPositioning — posicionamiento COT para un contrato
• GetLatestCftcPositioning — instantánea COT más reciente
• SearchCftcMarkets — búsqueda tokenizada estricta por nombre, código o símbolo de futuros estándar

Volatilidad (CBOE)

• GetPutCallRatios — ratios put/call
• GetVixHistory — OHLC diario de VIX

Calendario FDA

• GetFdaAdvisoryCommitteeMeetings — reuniones programadas del comité asesor de la FDA

Operaciones del Congreso

• GetCongressionalTrades — operaciones para un ticker
• GetMemberTrades — operaciones de un miembro
• GetMemberNetWorth — historial de patrimonio neto de un miembro
• SearchCongressMembers — búsqueda tokenizada estricta de la lista con alias de nombre público verificados

Datos de venta en corto (FINRA)

• GetShortVolume — volumen diario de venta en corto
• GetShortInterest — interés corto quincenal
• GetShortInterestSnapshot — instantánea en todo el mercado
• GetLargestShortVolume — mayor volumen diario de venta en corto
• GetShortSqueezeScores — puntuaciones compuestas de contracción corta
• GetOffExchangeVolume — volumen de dark pool/OTC

Precios de acciones

• GetStockPrices — OHLCV diario más el cierre ajustado auxiliar almacenado cuando difiere
• GetLatestClosingPrices — cierre/cambio/volumen más reciente
• GetStochasticOscillator — oscilador estocástico (%K/%D)
• GetAverageTrueRange — rango verdadero promedio (ATR)
• GetOnBalanceVolume — volumen en balance (OBV)
• GetBollingerBands — Bandas de Bollinger

Contratos gubernamentales (USAspending)

• GetGovernmentContracts — adjudicaciones de contratos federales para una empresa
• GetTopGovernmentContractors — mayores contratistas de empresas públicas

Incrustaciones Vectoriales (avanzado, opcional)

Los embeddings vectoriales permiten búsqueda semántica sobre presentaciones SEC (p. ej., "encontrar discusión sobre crecimiento de ingresos en el 10-K de Apple"). Esto requiere descargar el runtime de Ollama (~2GB) y el modelo Qwen3-Embedding-0.6B (~640MB).

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

Esto añade Ollama y configura los servicios existentes de web, MCP y worker para usarlo:

Servicio	Puerto	Descripción
embedding	11434	Servidor Ollama con el modelo Qwen3-Embedding-0.6B
embedding-pull	—	Descarga del modelo en una sola ejecución antes de que el worker arranque
worker	—	El worker existente, con generación de embeddings habilitada

Sin la anulación de embeddings, la búsqueda de texto completo BM25 mediante ParadeDB sigue funcionando de serie — la búsqueda vectorial es puramente aditiva.

Ollama incluido es la opción predeterminada porque no requiere GPU y funciona en cualquier lugar. Para embeddings masivos a gran escala, apunta Embedding__Provider=OpenAI a un servidor por lotes como vLLM o Text-Embeddings-Inference — estos procesan por lotes continuamente en la GPU y son mucho más rápidos que Ollama para corpus grandes. Consulta docs/guide/how-to-use-external-embedding-endpoint.md.

Capturas de pantalla

Detalle de Acción	Acciones
Datos Económicos	Detalle de Indicador Económico

Contribuciones

Consulta CONTRIBUTING.md para la configuración de desarrollo, la arquitectura del proyecto y cómo extender la plataforma. Los contribuyentes deben firmar el Acuerdo de Licencia de Contribuyente — esto lo gestiona automáticamente un bot cuando abres una solicitud de extracción.

Licencia

AGPL-3.0

Autor

Daniel Oliveira