AlphaSMO
Servidor CLI + MCP para tenencias institucionales SEC 13F, operaciones con información privilegiada y señales de convergencia de dinero inteligente. Nivel anónimo gratuito, sin necesidad de registro.
Documentación
AlphaSMO — La API definitiva de Smart Money para IA
CLI + servidor MCP para AlphaSMO — Tenencias institucionales 13F de SEC EDGAR, operaciones de información privilegiada (Formulario 4) y señales de "convergencia de smart money" (tickers donde los fondos de cobertura y los insiders de la empresa están comprando al mismo tiempo), consultables desde tu terminal, tus scripts o cualquier agente de IA compatible con MCP (Claude, ChatGPT, Cursor, etc.).
Sin registro, sin clave API, sin configuración — pruébalo ahora mismo:
npx alphasmo stocks flows --limit 10
Ejemplo de salida:
┌────────┬──────────────────────────────┬────────────────────┬──────────────┬──────────────┐
│ ticker │ issuer │ net flow (USD) │ avg weight % │ institutions │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ BRK-A │ BERKSHIRE HATHAWAY INC-CL A │ 247,455,256,379 │ 1.42 │ 1418 │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ AZN │ AstraZeneca PLC │ 148,465,847,587.12 │ 0.47 │ 1309 │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ XOM │ EXXON MOBIL CORP │ 138,784,059,363.77 │ 0.78 │ 4716 │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ CVX │ CHEVRON CORP │ 77,783,933,645.44 │ 0.6 │ 4261 │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ JNJ │ JOHNSON & JOHNSON │ 64,498,075,844.9 │ 0.76 │ 4603 │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ SNDK │ SANDISK CORP │ 58,662,972,096.01 │ 0.65 │ 1172 │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ MU │ MICRON TECHNOLOGY INC │ 55,374,569,969.23 │ 0.7 │ 2993 │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ AMAT │ APPLIED MATERIALS INC │ 48,790,109,328.41 │ 0.52 │ 2931 │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ EEM │ ISHARES MSCI EMERGING MARKET │ 48,211,222,155.7 │ 0.59 │ 1637 │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ CAT │ CATERPILLAR INC │ 46,035,710,179.58 │ 0.5 │ 3724 │
└────────┴──────────────────────────────┴────────────────────┴──────────────┴──────────────┘
Por qué AlphaSMO
- 📊 Tenencias institucionales 13F — las presentaciones trimestrales ante la SEC de cada fondo de cobertura y gestor de activos: AUM, posiciones y "puntajes de personalidad" conductuales (concentración, rotación, convicción sectorial). Lee nuestra guía sobre ¿Qué es una presentación 13F? y Cómo leer los cambios en tenencias institucionales.
- 🕵️ Operaciones de información privilegiada (Formulario 4 y 144) — compras y ventas de directivos, funcionarios y propietarios del 10%, con un puntaje de confianza por ticker. Aprende más en ¿Qué es una presentación del Formulario 4? y ¿Qué es una presentación del Formulario 144?.
- 🚀 Convergencia de smart money — la señal insignia: tickers donde las instituciones 13F y los insiders de la empresa están comprando ambos en este momento.
- 🤖 Diseñado para agentes de IA — un servidor MCP listo para usar, para que Claude, ChatGPT, Cursor o cualquier cliente MCP pueda obtener datos financieros reales en medio de la conversación.
- 🆓 Nivel anónimo gratuito — sin registro para probarlo; obtén una clave API gratuita en cualquier momento para aumentar tu límite de tasa.
Casos de uso
"What is smart money buying right now?" → alphasmo convergence
"What does Berkshire Hathaway hold?" → alphasmo institutions holdings berkshire-hathaway-inc
"Are insiders buying or selling NVDA?" → alphasmo insider summary NVDA
"Which stocks are institutions dumping?" → alphasmo stocks flows --direction sell
Conecta el servidor MCP a Claude Desktop, Claude Code, Cursor o cualquier cliente MCP (ver abajo) y haz estas preguntas en lenguaje natural — sin necesidad de código.
CLI
npx alphasmo institutions search "Berkshire"
npx alphasmo stocks get AAPL
npx alphasmo convergence -l 5
No se requiere instalación — npx lo descarga y ejecuta. O instálalo globalmente:
npm install -g alphasmo
alphasmo --help
Comandos
| Comando | Qué devuelve |
|---|---|
alphasmo institutions search <query> [-l|--limit] | Buscar instituciones 13F por nombre |
alphasmo institutions list [-l|--limit] [-o|--offset] | Paginar el universo completo de instituciones (sin consulta) |
alphasmo institutions get <slug> | Detalle completo de la institución, ponderaciones sectoriales |
alphasmo institutions holdings <slug> | Últimas tenencias 13F de una institución |
alphasmo stocks get <identifier> | Detalle completo de la acción — número de tenedores, flujos, principales tenedores (identificador = ticker o CUSIP) |
alphasmo stocks flows [-d|--direction buy|sell] [-l|--limit] | Acciones clasificadas por flujo neto de compra/venta institucional |
alphasmo insider trades <ticker> | Operaciones recientes de información privilegiada (Formulario 4) para un ticker |
alphasmo insider summary <ticker> | Puntajes de confianza de insiders (30d/90d) para un ticker |
alphasmo convergence [-l|--limit] [--min-confidence] [--days] | Tickers donde las instituciones 13F y los insiders están comprando ambos — la señal insignia |
alphasmo mcp | Iniciar el servidor MCP sobre stdio |
Banderas globales en cada comando: --api-key <key> (env ALPHASMO_API_KEY), --base-url <url> (env ALPHASMO_BASE_URL), -f/--format json|compact|table|csv, --json (abreviatura de --format json), --csv (abreviatura de --format csv).
El formato de salida se autodetecta según tu contexto — sin necesidad de bandera en el caso común:
- Escrito directamente en una terminal → una tabla legible, con números formateados con comas (
263,095,703,570). - Canalizado, redirigido o generado por un script/agente de IA (stdout no es un TTY) → JSON, seguro para canalizar a
jqo alimentar a un agente. --format/--json/--csvsiempre anulan la autodetección en cualquier caso.
alphasmo stocks flows --csv > flows.csv
alphasmo insider trades AAPL --csv | column -s, -t
Los errores van a stderr con un código de salida distintivo (2 no encontrado, 3 autenticación, 4 límite de tasa, 5 forma de respuesta inesperada, 1 otro), para que los scripts puedan ramificar sin comparar cadenas.
Obtén una clave API
Las solicitudes anónimas están limitadas por tasa según la IP. Regístrate y crea una clave gratuita en alphasmo.com/developer, luego:
alphasmo convergence --api-key ask_live_...
# or
export ALPHASMO_API_KEY=ask_live_...
Servidor MCP
Opción 1: claude mcp add (recomendada)
Si usas Claude Code, registra el servidor con un solo comando:
claude mcp add alphasmo -- npx -y alphasmo@latest mcp
Agrega -e ALPHASMO_API_KEY=ask_live_... antes del -- para aumentar tu límite de tasa. Ejecuta claude mcp list para confirmar que está conectado.
Opción 2: configuración manual del cliente MCP
Para Claude Desktop, Cursor o cualquier otro cliente MCP, agrega esto a tu archivo de configuración directamente:
{
"mcpServers": {
"alphasmo": {
"command": "npx",
"args": ["alphasmo", "mcp"],
"env": { "ALPHASMO_API_KEY": "optional-your-key-here" }
}
}
}
Ambas opciones funcionan de forma anónima de inmediato, con límites de tasa más bajos que con una clave. Herramientas expuestas: search_institutions, get_institution_profile, get_institution_holdings, get_stock_overview, get_stock_flows, get_insider_activity, get_smart_money_convergence.
Referencia completa de endpoints: alphasmo.com/developer/docs.
Uso programático
import { AlphasmoClient } from "alphasmo";
const client = new AlphasmoClient(); // no apiKey needed to try it
console.log(await client.getSmartMoneyConvergence({ limit: 5 }));
npm install alphasmo
También hay disponible un cliente Python + servidor MCP — consulta alphasmo.com/developer para la configuración.
Aprende más
- alphasmo.com — la aplicación web completa: perfiles de instituciones, filtros de acciones, tablas de líderes de operaciones de información privilegiada
- alphasmo.com/developer — obtén una clave API gratuita
- alphasmo.com/developer/docs — referencia completa de la API pública
Guías educativas y análisis profundos de presentaciones SEC
Profundiza tu comprensión de las tenencias institucionales y la dinámica de las presentaciones SEC:
- ¿Qué es una presentación 13F? — Guía para principiantes sobre las divulgaciones de tenencias institucionales.
- ¿Qué es una presentación del Formulario 4? — Cómo se reportan las compras y ventas de insiders.
- ¿Qué es una presentación del Formulario 144? — Comprende los avisos previos a la venta de la SEC antes de las descargas de insiders.
- 13D vs. 13G Beneficio de propiedad — Descubre las presentaciones de propiedad del 5% y la intención de los inversores activistas.
- Cómo leer los cambios en tenencias institucionales — Navega los cambios de cartera 13F sin dejarte engañar por divisiones de acciones o mecánicas de opciones.
Licencia
MIT