Haruspex

Obtener puntuación de acciones (p. ej. /score NVDA)

Documentación

haruspex-skills

Un servidor MCP para análisis de acciones, además de Skills de Anthropic que se basan en él — impulsado por Haruspex.

Este repositorio contiene dos cosas:

Un servidor MCP — @haruspex-guru/mcp-server, un servidor de Model Context Protocol que expone la API de análisis de acciones de Haruspex como herramientas (get_stock_score, get_stock_score_history, get_batch_scores, search_stocks, get_stock_news). Su código fuente y Dockerfile viven en mcp-server/, y se publica en npm como @haruspex-guru/mcp-server.
Un conjunto de Anthropic Agent Skills (en skills/) que construyen flujos de trabajo estructurados de trading — lecturas de un solo ticker, escaneos de listas de seguimiento, verificaciones de tesis, una variante en japonés — sobre ese servidor MCP.

Servidor MCP

El servidor MCP vive en mcp-server/ y se publica como @haruspex-guru/mcp-server. Habla el Model Context Protocol a través de stdio y expone seis herramientas:

Herramienta	Propósito
`get_stock_briefing`	Resumen hablado breve para asistentes de voz; acepta un ticker o nombre de empresa.
`get_stock_score`	Último puntaje Haruspex (0-100) para un ticker, con perspectiva, señal, desglose dimensional y URL compartible.
`get_stock_score_history`	Puntajes históricos diarios para un ticker.
`get_batch_scores`	Puntajes para hasta 50 tickers en una sola llamada (listas de seguimiento).
`search_stocks`	Encuentra tickers por símbolo o nombre de empresa.
`get_stock_news`	Artículos de noticias recientes para un ticker.

Ejecútalo directamente:

npx -y @haruspex-guru/mcp-server

Compila desde el código fuente (Docker):

docker build -t haruspex-mcp mcp-server/   # or build from repo root: docker build -t haruspex-mcp .

El servidor lee HARUSPEX_API_KEY en tiempo de ejecución para datos en vivo; obtén una clave en https://haruspex.guru/settings. Las Skills de Anthropic a continuación dependen de este servidor MCP para sus datos — si no está instalado, las skills lo detectan, muestran instrucciones de instalación y se detienen; nunca inventarán análisis.

Skills en este repositorio

Skill	Propósito
`haruspex-stock-analyst`	Análisis de fundamentos y señales de un solo ticker. El predeterminado para cualquier pregunta "¿qué tal [TICKER]?".
`haruspex-watchlist-review`	Revisión por lotes de una lista de seguimiento de múltiples tickers. Tablas clasificadas, mayores movimientos, banderas dimensionales.
`haruspex-thesis-tracker`	Mapea una tesis de inversión declarada a las dimensiones relevantes de Haruspex e informa si los datos aún se alinean.
`haruspex-stock-analyst-ja`	Versión en japonés del analista principal, para traders que trabajan en japonés sobre acciones cotizadas en EE. UU. (NYSE/NASDAQ).

Cada skill es una carpeta que contiene un SKILL.md con frontmatter YAML, un reference.md para documentación más profunda, y un examples.md con ejemplos completos de diálogos usando datos reales capturados.

Matriz de soporte por superficie

Superficie	Skills	MCP	Estado
Claude Code (CLI de terminal)	✅ `~/.claude/skills/` de sistema de archivos	✅ `claude mcp add-json`	Totalmente probado
Claude.ai web (navegador)	✅ Carga ZIP vía Configuración → Personalizar → Skills	✅ vía Conectores	Soportado
Claude API (SDK)	✅ paquete en la solicitud	✅ pasar configuración del servidor	Ver documentación de Anthropic
Claude Desktop app	❌ skills instalables por el usuario no soportadas a partir de v0.1.0	✅ `claude_desktop_config.json`	MCP funciona; las skills no (usa Claude Code en su lugar)
Cursor / Windsurf	❌ Anthropic Agent Skills no soportadas nativamente	✅ MCP funciona	Solo MCP; sin runtime de skills

Inicio rápido — Claude Code (recomendado)

Este es el camino que probamos.

Instala las skills. Desde este repositorio:

git clone https://github.com/Haruspex-guru/haruspex-skills.git
mkdir -p ~/.claude/skills
cp -r haruspex-skills/skills/* ~/.claude/skills/

Registra el servidor MCP a nivel de usuario (funciona en cualquier proyecto):

claude mcp add-json --scope user haruspex '{
  "command": "npx",
  "args": ["-y", "@haruspex-guru/mcp-server"],
  "env": { "HARUSPEX_API_KEY": "hrspx_demo_public_REPLACE_ME" }
}'

Reemplaza hrspx_demo_public_REPLACE_ME con tu clave real de https://haruspex.guru.

Verifica:

claude mcp list           # haruspex should show ✓ Connected

Luego en una sesión de Claude Code:

/mcp                      # browse Haruspex tools
/skills                   # see all 4 haruspex skills (✔ on)

Prueba una consulta:
```
What do you think about NVDA?
```
La skill haruspex-stock-analyst se activa automáticamente, llama a las herramientas MCP y devuelve un análisis estructurado con una URL de compartir verificable.

Inicio rápido — Claude.ai (web)

Habilita la ejecución de código en Claude.ai si aún no lo has hecho (Configuración → Capacidades).
Empaqueta cada skill como un ZIP. Desde este repositorio:
```
cd skills
for d in */; do (cd "$d" && zip -r "../${d%/}.zip" .); done
```
Produce 4 ZIPs en el directorio skills/.
Sube cada ZIP: claude.ai → Configuración → Personalizar → Skills → "+" → Subir una skill. Repite para las cuatro.
Configura @haruspex-guru/mcp-server vía Conectores (la interfaz de Conectores es separada de la configuración local de Desktop). Usa tu clave de API de Haruspex.
Prueba una consulta en cualquier chat: "¿Qué opinas sobre NVDA?"

Aviso: las skills subidas a claude.ai están sujetas a las pautas de revisión de Anthropic para contenido de terceros. "Solo instala skills de fuentes confiables" aplica — las skills de Haruspex no ejecutan código arbitrario, pero los usuarios deben revisar los archivos SKILL.md antes de instalar.

Inicio rápido — Claude API / SDK

La API de Claude soporta Agent Skills programáticamente. Agrupa los directorios de skills con tu solicitud y pasa la configuración del servidor MCP junto con ella. Consulta la documentación oficial de Skills API de Anthropic para la sintaxis actual.

Claude Desktop — limitación actual

La aplicación nativa de Claude Desktop no carga skills de sistema de archivos instalables por el usuario a partir de v0.1.0 de este repositorio (abril de 2026). El runtime de skills de Desktop actualmente solo muestra un conjunto integrado (docx, pdf, pptx, etc.).

El lado del servidor MCP sí funciona en Claude Desktop — consulta shared/MCP_SETUP.md para la configuración de claude_desktop_config.json. Pero sin un runtime de skills, te quedarías llamando a las herramientas MCP de forma libre en lugar de obtener el flujo de trabajo estructurado que estas skills imponen.

Para usuarios de Desktop hoy: instala Claude Code y úsalo desde tu terminal, o usa claude.ai web con el flujo de carga ZIP anterior. Anthropic puede agregar soporte de skills de sistema de archivos a Desktop más adelante; este repositorio se actualizará cuando eso suceda.

Requisitos previos

Una clave de API de Haruspex — regístrate en https://haruspex.guru. Nunca comprometas tu clave de API en un repositorio.
Uno de: Claude Code, Claude.ai web, o la API de Claude.
Node.js 18+ si estás ejecutando @haruspex-guru/mcp-server vía npx.

Los detalles completos de configuración de MCP por superficie viven en shared/MCP_SETUP.md.

Cumplimiento y descargo de responsabilidad

Estas skills producen análisis, no asesoramiento. Cada skill está codificada con reglas de cumplimiento que prohíben recomendaciones directas de compra/venta/mantener, predicciones de precios, dimensionamiento de posiciones y detalles de stop-loss/take-profit. Cada salida de skill incluye el pie de página canónico de descargo de responsabilidad.

El lenguaje completo del descargo de responsabilidad y la justificación detrás de cada regla de cumplimiento están en shared/DISCLAIMER.md. Trata ese archivo y las secciones "Reglas de cumplimiento (NUNCA VIOLAR)" de cada SKILL.md como fundamentales.

Nada en este repositorio es asesoramiento de inversión. Los puntajes de Haruspex son señales cuantitativas derivadas de datos públicos, proporcionados solo con fines informativos.

Dimensiones de temas

El puntaje de Haruspex es un compuesto de dimensiones de temas (por ejemplo, competitors, earnings, supplychain, us_china_official). Descripciones en lenguaje sencillo de los 16 están en shared/DIMENSIONS.md. La metodología de puntuación en sí es propietaria e intencionalmente no está documentada aquí.

Contribuciones

Consulta CONTRIBUTING.md. La versión corta:

Abre un issue antes de abrir un PR para cambios no triviales.
Ejecuta bash scripts/validate-skills.sh antes de enviar.
Los ejemplos deben usar datos reales capturados de la API en vivo. La fabricación será rechazada.
El lenguaje de cumplimiento no es negociable.

Consultas de evaluación

eval/queries/ contiene ~20 consultas de prueba de activación por skill (la mitad debería activarse, la mitad no, con casos de ambigüedad entre skills). Úsalas al revisar el campo description de cualquier skill. Consulta eval/README.md para el procedimiento de evaluación manual.

Licencia

MIT. El servidor MCP y las skills (instrucciones y ejemplos en este repositorio) tienen licencia MIT. El algoritmo de puntuación de Haruspex y los datos subyacentes son propietarios; el acceso se rige por los Términos de servicio de la API de Haruspex. Consulta NOTICE para la declaración completa del alcance.

De dónde viene esto

Construido para la comunidad de Haruspex, inspirado en patrones que hemos visto funcionar en flujos de trabajo reales de traders. Las presentaciones al catálogo oficial de anthropics/skills seguirán una vez que las skills tengan una forma estable aquí.