Stock API For MCP

stock-api

Herramienta de datos bursátiles en TypeScript que admite consultas de acciones A, acciones de Hong Kong y acciones de EE. UU.

English | 简体中文

stock-api es una herramienta de cotizaciones bursátiles sin dependencias en tiempo de ejecución, compatible con Node.js, navegador, CLI y MCP. Por defecto usa stocks.auto, que obtiene cotizaciones automáticamente de las fuentes de datos disponibles.

Formas de uso compatibles

Características

• API para Node.js / bundler de navegador + tipos de TypeScript
• CLI para consultar cotizaciones, velas y buscar acciones
• Herramientas MCP para que clientes de IA llamen directamente a las interfaces bursátiles
• Respaldo automático por defecto: tencent -> sina -> eastmoney
• Fuente de datos específica: stocks.tencent / stocks.sina / stocks.eastmoney
• Compatible con formatos de código de acciones A, Hong Kong y EE. UU.
• Sin dependencias en tiempo de ejecución

Node.js

Instalación

El entorno Node.js requiere >=18.

npm install stock-api

Uso

import { stocks } from "stock-api";

const stock = await stocks.auto.getStock("SH510500");
const list = await stocks.auto.getStocks(["SH510500", "SZ000651"]);
const klines = await stocks.auto.getKlines("SH600519", { period: "day" });
const results = await stocks.auto.searchStocks("格力电器");

Los códigos de acciones usan el prefijo SH / SZ / HK / US, por ejemplo SH510500, SZ000651.

Navegador

Referencia

<script src="https://cdn.jsdelivr.net/npm/stock-api/dist/browser/stock-api.iife.min.js"></script>

Uso

<script>
  StockApi.stocks.auto.getStock("SH510500").then(console.log);
  StockApi.stocks.auto.getStocks(["SH510500", "SZ000651"]).then(console.log);
  StockApi.stocks.auto.getKlines("SH600519", { period: "day" }).then(console.log);
  StockApi.stocks.auto.searchStocks("格力电器").then(console.log);
</script>

Ejemplo en navegador: GitHub Pages

CLI

npx stock-api get-stock SH510500
npx stock-api get-stocks SH510500 SZ000651
npx stock-api get-klines SH600519 --period day --count 120
npx stock-api search-stocks 格力电器

MCP

Conecta stock-api a un cliente de IA compatible con MCP:

{
  "mcpServers": {
    "stock-api": {
      "command": "npx",
      "args": ["-y", "stock-api", "mcp"]
    }
  }
}

Herramientas integradas: get_stock, get_stocks, get_klines, search_stocks, inspect_stock.

Versiones de protocolo MCP compatibles: 2025-11-25, 2025-06-18. Durante el handshake se devuelve la versión solicitada por el cliente; si no es compatible, se revierte a la más reciente.

Agente de IA (cualquier herramienta)

¿No quieres configurar MCP? Envía la siguiente frase a cualquier herramienta de IA (Claude Code, Codex, GLM, etc.) y sabrá cómo usar stock-api después de leerla:

请阅读 https://raw.githubusercontent.com/zhangxiangliang/stock-api/main/SKILL.md
然后用 stock-api 回答我的股票问题。

SKILL.md contiene los comandos específicos de npx stock-api, por lo que comparte la misma lógica de datos que MCP, solo que la integración es más simple y funciona entre herramientas.

Fuentes de datos

Incluye fuentes de datos de Tencent, Sina y Eastmoney; por defecto, stocks.auto las maneja automáticamente.

Fuente de datos	Uso	Capacidades
Respaldo automático	stocks.auto	Cotización individual, cotizaciones en lote, velas, búsqueda, diagnóstico
Tencent	stocks.tencent	Cotización individual, cotizaciones en lote, velas, búsqueda, diagnóstico
Sina	stocks.sina	Cotización individual, cotizaciones en lote, velas, búsqueda, diagnóstico
Eastmoney	stocks.eastmoney	Cotización individual de acciones A, cotizaciones en lote, velas, búsqueda, diagnóstico

stocks.eastmoney.searchStocks depende de una interfaz de búsqueda que puede devolver respuestas anti-scraping y fallar en algunos entornos de red fuera de China (por ejemplo, servidores en el extranjero, IPs de salida de CI); las cotizaciones y velas no se ven afectadas. Para escenarios que dependen directamente de la búsqueda de Eastmoney, se recomienda usar stocks.auto, que revierte automáticamente a Tencent y Sina cuando la búsqueda de Eastmoney falla.

Documentación

Documento	Contenido
Uso de API	API de TypeScript, respaldo automático, estructura de respuesta de diagnóstico
Uso de CLI	Comandos, parámetros, salida, códigos de salida
Arquitectura del proyecto	Estructura de directorios, fábrica de providers, modelos de análisis y errores
Guía de desarrollo	Desarrollo local, pruebas, verificaciones previas a la publicación, agregar nuevas fuentes de datos
Monitoreo de API	Verificación periódica de fuentes de datos de terceros y actualización de insignias de estado

Aviso legal

stock-api utiliza interfaces públicas de cotizaciones de terceros como fuente de datos; no garantiza la precisión, integridad, actualidad o disponibilidad continua de los datos. Este proyecto no proporciona asesoramiento de inversión; cualquier decisión de trading o inversión debe ser tomada por ti. Antes de uso comercial, de alta frecuencia o en producción, verifica por tu cuenta los términos de servicio, el alcance de la autorización y los requisitos de cumplimiento de las fuentes de datos de terceros.

Licencia

MIT