stock-api

View on GitHub

查询 A 股、美股、港股与场内基金行情，并通过 Node.js、浏览器、CLI 或 MCP 快速接入。

1,844 stars TypeScriptOthers Updated Sep 3, 2026

browsermcpnodejsstocks

Documentation

stock-api

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

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

支持使用方式

特性

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

shell

npm install stock-api

使用

typescript

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

浏览器

引用

html

// Code block

使用

html

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

浏览器示例：GitHub Pages

CLI

shell

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 客户端：

json

{
  "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`：

text

请阅读 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.eastmoney`	A 股单只行情、批量行情、K 线、搜索、诊断

文档

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