Stock API For MCP

stock-api

Ferramenta TypeScript de dados de ações que suporta consultas de ações A, ações de Hong Kong e ações dos EUA.

English | 简体中文

stock-api é uma ferramenta de cotações de ações com zero dependências em tempo de execução, compatível com Node.js, navegador, CLI e MCP. Por padrão, usa stocks.auto, obtendo cotações automaticamente das fontes de dados disponíveis.

Formas de uso suportadas

Recursos

• API Node.js / Browser bundler + tipos TypeScript
• CLI para consultar cotações, candles e pesquisar ações
• Ferramentas MCP para clientes de IA acessarem diretamente as interfaces de ações
• Fallback automático padrão: tencent -> sina -> eastmoney
• Fonte de dados específica: stocks.tencent / stocks.sina / stocks.eastmoney
• Suporte aos formatos de código de ações A, Hong Kong e EUA
• Zero dependências em tempo de execução

Node.js

Instalação

Requisito de ambiente Node.js: >=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("格力电器");

Os códigos de ações usam os prefixos SH / SZ / HK / US, por exemplo SH510500, SZ000651.

Navegador

Referência

<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>

Exemplo no 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

Conecte stock-api a um cliente de IA compatível com MCP:

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

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

Versões de protocolo MCP suportadas: 2025-11-25, 2025-06-18. Durante o handshake, a versão solicitada pelo cliente é retornada; se não for suportada, faz fallback para a mais recente.

Agente de IA (qualquer ferramenta)

Não quer configurar MCP? Envie a frase abaixo para qualquer ferramenta de IA (Claude Code, Codex, GLM etc.) e ela saberá como usar stock-api após ler:

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

O SKILL.md contém comandos específicos de npx stock-api, então compartilha a mesma lógica de dados do MCP, apenas com uma integração mais simples e universal entre ferramentas.

Fontes de dados

Fontes de dados integradas: Tencent, Sina e Eastmoney, processadas automaticamente por stocks.auto por padrão.

Fonte de dados	Uso	Capacidades
Fallback automático	stocks.auto	Cotação individual, cotações em lote, candles, pesquisa, diagnóstico
Tencent	stocks.tencent	Cotação individual, cotações em lote, candles, pesquisa, diagnóstico
Sina	stocks.sina	Cotação individual, cotações em lote, candles, pesquisa, diagnóstico
Eastmoney	stocks.eastmoney	Ações A: cotação individual, cotações em lote, candles, pesquisa, diagnóstico

A interface de pesquisa da qual stocks.eastmoney.searchStocks depende pode retornar respostas anti-raspagem em alguns ambientes de rede externos (por exemplo, servidores no exterior, IPs de saída de CI) e falhar; cotações/candles não são afetados. Para cenários que dependem diretamente da pesquisa da Eastmoney, recomenda-se usar stocks.auto, que faz fallback automático para Tencent e Sina quando a pesquisa da Eastmoney falha.

Documentação

Documento	Conteúdo
Uso da API	API TypeScript, fallback automático, estrutura de retorno de diagnóstico
Uso da CLI	Comandos, parâmetros, saída, códigos de saída
Arquitetura do projeto	Estrutura de diretórios, fábrica de providers, modelo de parsing e erros
Guia de desenvolvimento	Desenvolvimento local, testes, verificações pré-publicação, adição de novas fontes de dados
Monitoramento da API	Verificação periódica de fontes de dados de terceiros e atualização dos badges de status

Aviso legal

stock-api usa interfaces públicas de cotações de terceiros como fonte de dados e não garante a precisão, integridade, atualidade ou disponibilidade contínua dos dados. Este projeto não fornece aconselhamento de investimento; qualquer decisão de negociação ou investimento deve ser de sua própria responsabilidade. Antes de uso comercial, de alta frequência ou em produção, verifique por conta própria os termos de serviço, o escopo de autorização e os requisitos de conformidade das fontes de dados de terceiros.

Licença

MIT