@t2b2c/agent-stock-sdk
v0.1.1
Published
Agent-facing stock SDK: dabang boards, snapshot trend/limit-up pools (Nest API), index/gold K-lines via stock-sdk, and K-line card screenshots via Kimi WebBridge
Maintainers
Readme
@t2b2c/agent-stock-sdk
面向 Agent / Node 脚本的股票数据 SDK:
- 打板模块:对接 Nest
stock-api(默认http://192.168.188.1:9301) - snapshot 股票池:
POST /stocks/snapshot/query- 池 A
getSmallCapTrendPool:小市值趋势股(两路 query 按code合并) - 池 B
getLimitUp30dPool:近 30 自然日涨停活跃(打板二波 / 中军候选) - 池 C
getLargeCapTrendPool:大市值趋势(≥500 亿) - 池 D
getLargeCapLimitUp3dPool:大市值涨停观察(≥300 亿,异动近 3 日)
- 池 A
- 指数 / 黄金 K 线:基于 npm
stock-sdk - K 线卡片截图(Kimi WebBridge,
years默认 2.5):- A 股个股 →
/kline-list(captureKlineScreenshots,按data-code) - A 股指数 / 黄金 / 美股指数 / 美股个股 →
/market-kline-list(captureMarketKlineScreenshots,按data-symbol)
- A 股个股 →
前端页面
:9311/a-share-sentiment、/jiuyan-limit-up-board、/kline-list、/market-kline-list仅为 UI;打板 / 指数 / snapshot 数据直接读 Nest JSON 或 stock-sdk;截图走本机 WebBridge +:9311。
股票池字段约定见docs/趋势票与打板股票池.md。
Install
pnpm add @t2b2c/agent-stock-sdk
# or
npm publish # from packages/ts-agent-stock-sdk after buildQuick start
import { AgentStockSdk } from '@t2b2c/agent-stock-sdk'
const sdk = new AgentStockSdk({
apiBaseUrl: 'http://192.168.188.1:9301',
stockAppBaseUrl: 'http://192.168.188.1:9311',
})
// 高板主题(≥7 连板日行)
const ge7 = await sdk.getGe7BoardThemes()
// 涨停快照(今/昨)
const snapshot = await sdk.getLimitUpSnapshot()
// 多日对比
const multiDay = await sdk.getMultiDayCompare()
// 小市值趋势股池(A1∪A2,按 code 合并,已裁剪网格必要字段)
const trendPool = await sdk.getSmallCapTrendPool()
// 近 30 自然日涨停活跃池(打板二波 / 中军候选)
const limitUpPool = await sdk.getLimitUp30dPool()
// 大市值趋势 / 大市值涨停观察
const largeTrend = await sdk.getLargeCapTrendPool()
const largeLimitUp3d = await sdk.getLargeCapLimitUp3dPool()
// 创业板 / 上证 / 纳指 / 黄金 日或周 K
const cybDaily = await sdk.getCybKline({ period: 'daily' })
const sseWeekly = await sdk.getSseKline({ period: 'weekly' })
const nasdaq = await sdk.getNasdaqKline({ period: 'daily' })
const gold = await sdk.getGoldKline({ period: 'weekly' })Snapshot 股票池 example
# 默认拉全部池(A–D)
pnpm --filter @t2b2c/agent-stock-sdk example:snapshot-pools
pnpm --filter @t2b2c/agent-stock-sdk example:snapshot-pools -- \
--pool=large-trend \
--out=./tmp/snapshot-pools
pnpm --filter @t2b2c/agent-stock-sdk example:snapshot-pools -- \
--pool=large-limitup \
--codes-onlyK 线截图(Kimi WebBridge)
前置:本机已装 WebBridge,daemon 在跑,浏览器扩展已连接。
~/.kimi-webbridge/bin/kimi-webbridge start截图分流
| 标的 | API | 页面 | 选择器 |
|------|-----|------|--------|
| A 股个股(6 位) | captureKlineScreenshots | /kline-list | [data-kline-card][data-code="000595"] |
| 指数 / 黄金 / 美股 | captureMarketKlineScreenshots | /market-kline-list | [data-kline-card][data-symbol="cyb"] / us:AAPL |
混合同一批 token 时可先分流:
import { partitionKlineScreenshotTargets } from '@t2b2c/agent-stock-sdk'
const { aShareCodes, marketSymbols } = partitionKlineScreenshotTargets([
'000595',
'cyb',
'us:AAPL',
])
// aShareCodes → captureKlineScreenshots
// marketSymbols → captureMarketKlineScreenshots可执行案例
# A 股个股:默认 codes=000595,000665,002187 · years=2.5
pnpm --filter @t2b2c/agent-stock-sdk example:kline-shot
pnpm --filter @t2b2c/agent-stock-sdk example:kline-shot -- \
--codes=000595,000665,002187 \
--years=2.5 \
--out=./tmp/kline-exports
# 市场标的:默认 cyb,sse,nasdaq,gold
pnpm --filter @t2b2c/agent-stock-sdk example:market-kline-shot
pnpm --filter @t2b2c/agent-stock-sdk example:market-kline-shot -- \
--symbols=cyb,sse,nasdaq,gold,us:AAPL \
--years=2.5 \
--stock-app=http://localhost:9311 \
--out=./tmp/market-kline-exports市场截图默认
layout=per-symbol,并用 CDP 固定视口 + 裁剪卡片(不再依赖 WebBridgescreenshot+selector,避免错位/超宽压扁)。
代码调用
import {
AgentStockSdk,
captureKlineScreenshots,
captureMarketKlineScreenshots,
} from '@t2b2c/agent-stock-sdk'
const sdk = new AgentStockSdk()
// A 股个股 → /kline-list?codes=…&years=2.5
const aShareShot = await sdk.captureKlineScreenshots({
codes: ['000595', '000665', '002187'],
})
// 指数 / 黄金 / 美股 → /market-kline-list?symbols=…&years=2.5
const marketShot = await sdk.captureMarketKlineScreenshots({
symbols: ['cyb', 'sse', 'nasdaq', 'gold', 'us:AAPL'],
})API map
| SDK | Nest / stock-sdk / UI |
|-----|------------------|
| getGe7BoardThemes() | GET /market-sentiment/ge7-board-day-rows |
| getLimitUpSnapshot() | GET /jiuyan/limit-up-ladder → today_yesterday |
| getMultiDayCompare() | GET /jiuyan/limit-up-ladder → multi_day |
| getSmallCapTrendPool() | POST /stocks/snapshot/query ×2(A1∪A2) |
| getLimitUp30dPool() | POST /stocks/snapshot/query(近 30 日涨停) |
| getLargeCapTrendPool() | POST /stocks/snapshot/query(大市值 ≥500 亿) |
| getLargeCapLimitUp3dPool() | POST /stocks/snapshot/query(大市值异动近 3 日) |
| getCybKline | stock-sdk kline.cn('sz399006') |
| getSseKline | stock-sdk kline.cn('sh000001') |
| getNasdaqKline | stock-sdk kline.us('IXIC') |
| getGoldKline | stock-sdk futures.globalKline('GC00Y') |
| getMarketKlines / fetchMarketSymbolKline | stock-sdk cn / us / futures |
| captureKlineScreenshots | WebBridge → :9311/kline-list?codes=&years= |
| captureMarketKlineScreenshots | WebBridge → :9311/market-kline-list?symbols=&years= |
Publish
pnpm --filter @t2b2c/agent-stock-sdk build
pnpm --filter @t2b2c/agent-stock-sdk publish --access publicOptions
new AgentStockSdk({
apiBaseUrl: 'http://192.168.188.1:9301',
stockAppBaseUrl: 'http://192.168.188.1:9311',
webbridgeBaseUrl: 'http://127.0.0.1:10086',
// nestQuery: null, // disable SuperTokens bypass query
// fetch: customFetch,
// stockSdk: injectedStockSdk, // tests
})