Stock API For MCP

stock-api là bộ công cụ dữ liệu thị trường chứng khoán không phụ thuộc runtime, dành cho Node.js, trình duyệt, sử dụng CLI và các ứng dụng AI tương thích MCP. Mặc định sử dụng stocks.auto để đọc từ nhà cung cấp khả dụng đầu tiên.

GitHub
1.8k

Tài liệu

stock-api

支持 A 股、港股、美股行情查询的 TypeScript 股票数据工具。

English | 简体中文

Downloads Version License TypeScript

接口状态 腾讯状态 新浪状态 东方财富状态

在线体验 项目主页

stock-api 是一个零运行时依赖的股票行情工具，支持 Node.js、浏览器、CLI 和 MCP。默认使用 stocks.auto，自动从可用数据源获取行情。

支持使用方式

Node.js Browser CLI MCP

特性

  • Node.js / Browser bundler API + TypeScript 类型
  • CLI 查询股票行情、K 线和搜索股票
  • MCP tools 给 AI 客户端直接调用股票接口
  • 默认自动兜底：tencent -> sina -> eastmoney
  • 指定数据源：stocks.tencent / stocks.sina / stocks.eastmoney
  • 支持 A 股、港股、美股代码格式
  • 零运行时依赖

Node.js

安装

Node.js 环境要求 >=18。

npm install stock-api

使用

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("格力电器");

股票代码使用 SH / SZ / HK / US 前缀，例如 SH510500、SZ000651。

浏览器

引用

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

使用

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

浏览器示例：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

把 stock-api 接到支持 MCP 的 AI 客户端：

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

内置工具：get_stock、get_stocks、get_klines、search_stocks、inspect_stock。

AI Agent（任意工具）

不想配置 MCP？把下面这句话发给任意 AI 工具（Claude Code、Codex、GLM 等），它读完就知道怎么用 stock-api：

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

SKILL.md 里写了具体的 npx stock-api 命令，所以和 MCP 共用同一套数据逻辑，只是接入方式更简单、跨工具通用。

数据源

内置腾讯、新浪、东方财富数据源，默认由 stocks.auto 自动处理。

数据源用法能力
自动兜底stocks.auto单只行情、批量行情、K 线、搜索、诊断
腾讯stocks.tencent单只行情、批量行情、K 线、搜索、诊断
新浪stocks.sina单只行情、批量行情、K 线、搜索、诊断
东方财富stocks.eastmoneyA 股单只行情、批量行情、K 线、搜索、诊断

文档

文档内容
API 使用TypeScript API、自动兜底、诊断返回结构
CLI 使用命令、参数、输出、退出码
项目架构目录结构、provider 工厂、解析和错误模型
开发指南本地开发、测试、发布前检查、新增数据源
API 监控定时检查第三方数据源并更新状态徽章

免责声明

stock-api 使用第三方公开行情接口作为数据来源，不保证数据的准确性、完整性、实时性或持续可用性。本项目不提供投资建议，任何交易或投资决策都应由你自行判断。商业、高频或生产使用前，请自行确认第三方数据源的服务条款、授权范围和合规要求。

License

MIT