Skillget

stock-api

mcp
Security Audit
Fail
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 1323 GitHub stars
Code Fail
  • rm -rf — Recursive force deletion command in .github/workflows/api-monitor.yml
  • rm -rf — Recursive force deletion command in .github/workflows/pages.yml
  • fs module — File system access in package.json
  • process.env — Environment variable access in scripts/browser-smoke.mjs
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

股票接口 | A股 | 美股 | 港股 | 股票 | 基金 | MCP

README.md

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。

数据源

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

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

文档

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

免责声明

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

License

MIT

Reviews (0)

No results found