chengzuopeng/stock-sdk

ブラウザと Node.js で動作する、A 株・香港株・米国株・投信の実時行情と K 線データを取得できるTypeScript 製株価 SDK です。

開発の材料自由に使える · ISC投資・金融TypeScript難易度
1,9950 保存
203フォーク0Issue

中辛 の解説

TypeScript / JavaScript ベースで、ESM・CommonJS・subpath exports に対応した軽量ライブラリです。ネットワーク層と計算層が分離されており、テクニカル指標や選株アルゴリズムはバンドルサイズに影響しません。命名空間 API(sdk.quotes.cn()・sdk.kline.hk() など)で IDE の自動補完が効き、複数市場の統一シンボル解析に対応しているため、すぐに実装できます。デモアプリケーションや社内ダッシュボードの構築から、量化戦略のプロトタイプ検証まで幅広く使えます。

こんなリポジトリです

こんなときに便利です

  • 社内株価ダッシュボード・行情ビジュアライゼーション(ECharts・TradingView)の構築
  • 量化取引戦略のプロトタイプ検証と Node.js 定時バッチ処理
  • Cursor や Claude Desktop などの AI 工具へのデータソース統合

主な機能

A 株・香港株・米国株・投信の実時行情・K 線・テクニカル指標(MA・MACD・KDJ など 17 個)を統一 API で提供筹码分布・信号検出・選股・バックテスト機能を純関数で備備CLI・MCP server・subpath exports により、多様な使用パターン(ブラウザ・Node.js・AI 工具)を支援

ほかとの違い

Python 中心の金融データエコシステムと異なり、JavaScript/TypeScript ネイティブで設計され、後端なしにブラウザと Node.js で即座に動作し、AI ツール連携(MCP)も組み込まれています。

このリポジトリの作り方

はじめてですか? むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。

準備するもの

  • Node.js 18 以上

すぐに始める

  1. パッケージをインストールしてください。
npm install stock-sdk
  1. SDK をインポートして初期化します。
node -e "import('stock-sdk').then(m => { const sdk = new m.StockSDK(); return sdk.quotes.cnSimple(['sh600519']).then(q => console.log(q)); })"
  1. 行情データを取得します(Node.js/TypeScript の場合)。
node << 'EOF'
import { StockSDK } from 'stock-sdk';
const sdk = new StockSDK();
const quotes = await sdk.quotes.cnSimple(['sh000001', 'sh600519']);
console.log(quotes);
EOF
  1. CLI で行情を直接確認できます。
npx stock-sdk quote 600519 00700 AAPL
  1. K 線と技術指標を取得します。
node << 'EOF'
import { StockSDK } from 'stock-sdk';
const sdk = new StockSDK();
const kline = await sdk.kline.withIndicators('600519', { period: 'daily', indicators: { ma: { periods: [5, 10, 20] }, macd: {} } });
console.log(kline);
EOF
  1. MCP サーバーを起動して AI 統合します。
npx stock-sdk mcp

ギット飯トライで味見

入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。

ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。

npx gitbap-try chengzuopeng/stock-sdk

Node.js さえあれば、インストールなしで動きます · ギット飯トライとは? →

スター推移 · 7日

1,9957日間の増加数を計算するための比較データが不足しています

確認日時

使いやすさ · まねしやすいか

まねしやすいサンプル評点 46/100
  • ゆるいライセンス
  • テストあり
  • サンプル集
  • 最近の更新
  • AGENTS.md
  • llms.txt
  • テンプレート

最近の更新あり · 2025 年に作成

「投資・金融」 こういうリポジトリを毎週受け取りませんか?

毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。

自分のリポジトリですか? README にギット飯バッジを貼る
[![깃밥](https://www.gitbap.com/badge/chengzuopeng/stock-sdk.svg)](https://www.gitbap.com/r/chengzuopeng/stock-sdk)
Claude からそのまま使う — ギット飯のつなぎ方

ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。

方法 ① コネクタ URL

Claude の設定 → コネクタにこのアドレスを貼り付け。

https://www.gitbap.com/api/mcp
方法 ② プラグイン(試用まで)

プラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
つなぎ方をくわしく →

AI が README をもとに要約しました · 原文を見る