@t2b2c/agent-stock-sdk 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (88) hide show
  1. package/README.md +185 -2
  2. package/dist/board/ge7-themes.d.ts +4 -0
  3. package/dist/board/ge7-themes.d.ts.map +1 -0
  4. package/dist/board/ge7-themes.js +10 -0
  5. package/dist/board/limit-up-ladder.d.ts +8 -0
  6. package/dist/board/limit-up-ladder.d.ts.map +1 -0
  7. package/dist/board/limit-up-ladder.js +13 -0
  8. package/dist/client.d.ts +76 -0
  9. package/dist/client.d.ts.map +1 -0
  10. package/dist/client.js +130 -0
  11. package/dist/config.d.ts +34 -0
  12. package/dist/config.d.ts.map +1 -0
  13. package/dist/config.js +12 -0
  14. package/dist/http.d.ts +12 -0
  15. package/dist/http.d.ts.map +1 -0
  16. package/dist/http.js +60 -0
  17. package/dist/index.d.ts +35 -0
  18. package/dist/index.d.ts.map +1 -0
  19. package/dist/index.js +22 -0
  20. package/dist/kline/capture-kline-screenshots.d.ts +10 -0
  21. package/dist/kline/capture-kline-screenshots.d.ts.map +1 -0
  22. package/dist/kline/capture-kline-screenshots.js +155 -0
  23. package/dist/kline/capture-market-kline-screenshots.d.ts +8 -0
  24. package/dist/kline/capture-market-kline-screenshots.d.ts.map +1 -0
  25. package/dist/kline/capture-market-kline-screenshots.js +149 -0
  26. package/dist/kline/fetch-kline.d.ts +30 -0
  27. package/dist/kline/fetch-kline.d.ts.map +1 -0
  28. package/dist/kline/fetch-kline.js +54 -0
  29. package/dist/kline/fetch-market-kline.d.ts +10 -0
  30. package/dist/kline/fetch-market-kline.d.ts.map +1 -0
  31. package/dist/kline/fetch-market-kline.js +67 -0
  32. package/dist/kline/kline-list-url.d.ts +14 -0
  33. package/dist/kline/kline-list-url.d.ts.map +1 -0
  34. package/dist/kline/kline-list-url.js +46 -0
  35. package/dist/kline/market-symbols.d.ts +22 -0
  36. package/dist/kline/market-symbols.d.ts.map +1 -0
  37. package/dist/kline/market-symbols.js +105 -0
  38. package/dist/kline/normalize.d.ts +17 -0
  39. package/dist/kline/normalize.d.ts.map +1 -0
  40. package/dist/kline/normalize.js +34 -0
  41. package/dist/kline/screenshot-route.d.ts +25 -0
  42. package/dist/kline/screenshot-route.d.ts.map +1 -0
  43. package/dist/kline/screenshot-route.js +65 -0
  44. package/dist/kline/webbridge-client.d.ts +22 -0
  45. package/dist/kline/webbridge-client.d.ts.map +1 -0
  46. package/dist/kline/webbridge-client.js +41 -0
  47. package/dist/pool/large-cap-limit-up-3d.d.ts +7 -0
  48. package/dist/pool/large-cap-limit-up-3d.d.ts.map +1 -0
  49. package/dist/pool/large-cap-limit-up-3d.js +20 -0
  50. package/dist/pool/large-cap-trend.d.ts +7 -0
  51. package/dist/pool/large-cap-trend.d.ts.map +1 -0
  52. package/dist/pool/large-cap-trend.js +20 -0
  53. package/dist/pool/limit-up-30d.d.ts +8 -0
  54. package/dist/pool/limit-up-30d.d.ts.map +1 -0
  55. package/dist/pool/limit-up-30d.js +21 -0
  56. package/dist/pool/pick-and-merge.d.ts +12 -0
  57. package/dist/pool/pick-and-merge.d.ts.map +1 -0
  58. package/dist/pool/pick-and-merge.js +110 -0
  59. package/dist/pool/query-bodies.d.ts +68 -0
  60. package/dist/pool/query-bodies.d.ts.map +1 -0
  61. package/dist/pool/query-bodies.js +121 -0
  62. package/dist/pool/small-cap-trend.d.ts +8 -0
  63. package/dist/pool/small-cap-trend.d.ts.map +1 -0
  64. package/dist/pool/small-cap-trend.js +27 -0
  65. package/dist/pool/snapshot-query.d.ts +5 -0
  66. package/dist/pool/snapshot-query.d.ts.map +1 -0
  67. package/dist/pool/snapshot-query.js +15 -0
  68. package/dist/types/board.d.ts +67 -0
  69. package/dist/types/board.d.ts.map +1 -0
  70. package/dist/types/board.js +1 -0
  71. package/dist/types/kline-screenshot.d.ts +62 -0
  72. package/dist/types/kline-screenshot.d.ts.map +1 -0
  73. package/dist/types/kline-screenshot.js +1 -0
  74. package/dist/types/kline.d.ts +31 -0
  75. package/dist/types/kline.d.ts.map +1 -0
  76. package/dist/types/kline.js +6 -0
  77. package/dist/types/market-kline-screenshot.d.ts +27 -0
  78. package/dist/types/market-kline-screenshot.d.ts.map +1 -0
  79. package/dist/types/market-kline-screenshot.js +1 -0
  80. package/dist/types/snapshot-pool.d.ts +53 -0
  81. package/dist/types/snapshot-pool.d.ts.map +1 -0
  82. package/dist/types/snapshot-pool.js +1 -0
  83. package/docs//344/270/244/344/270/252/350/266/213/345/212/277/347/245/250curl.md +102 -0
  84. package/docs//350/266/213/345/212/277/347/245/250/344/270/216/346/211/223/346/235/277/350/202/241/347/245/250/346/261/240.md +260 -0
  85. package/examples/capture-kline-screenshots.ts +151 -0
  86. package/examples/capture-market-kline-screenshots.ts +81 -0
  87. package/examples/fetch-snapshot-pools.ts +237 -0
  88. package/package.json +52 -4
@@ -0,0 +1,237 @@
1
+ /**
2
+ * Executable demo: fetch snapshot stock pools via Nest `POST /stocks/snapshot/query`.
3
+ *
4
+ * Prerequisites:
5
+ * stock-api reachable (default http://192.168.188.1:9301)
6
+ *
7
+ * Run from monorepo root:
8
+ * pnpm --filter @t2b2c/agent-stock-sdk example:snapshot-pools
9
+ *
10
+ * Options:
11
+ * pnpm --filter @t2b2c/agent-stock-sdk example:snapshot-pools -- \
12
+ * --pool=all --page-size=100 --out=./tmp/snapshot-pools
13
+ */
14
+
15
+ import { mkdir, writeFile } from 'node:fs/promises'
16
+ import { resolve } from 'node:path'
17
+ import {
18
+ AgentStockSdk,
19
+ AgentStockSdkHttpError,
20
+ type SnapshotPoolItem,
21
+ type SnapshotPoolResult,
22
+ } from '../src/index.js'
23
+
24
+ type PoolKind =
25
+ | 'trend'
26
+ | 'limitup'
27
+ | 'large-trend'
28
+ | 'large-limitup'
29
+ | 'both'
30
+ | 'all'
31
+
32
+ const POOL_KINDS = new Set<PoolKind>([
33
+ 'trend',
34
+ 'limitup',
35
+ 'large-trend',
36
+ 'large-limitup',
37
+ 'both',
38
+ 'all',
39
+ ])
40
+
41
+ function printUsage(): void {
42
+ console.log(`Usage:
43
+ pnpm --filter @t2b2c/agent-stock-sdk example:snapshot-pools -- [options]
44
+
45
+ Options:
46
+ --pool=trend|limitup|large-trend|large-limitup|both|all
47
+ Which pool(s) (default: all)
48
+ --page=0 Query page (default: 0)
49
+ --page-size=100 Query pageSize (default: 100)
50
+ --api=URL Nest stock-api origin (default: http://192.168.188.1:9301)
51
+ --out=DIR Write JSON summaries under DIR (optional)
52
+ --codes-only Print only codes, one per line
53
+ --help Show this help
54
+
55
+ Pools:
56
+ trend 小市值找趋势股(A1∪A2)
57
+ limitup 近 30 自然日涨停活跃(打板二波 / 中军)
58
+ large-trend 大市值趋势(≥500 亿)
59
+ large-limitup 大市值涨停观察(≥300 亿,异动近 3 日)
60
+ both trend + limitup
61
+ all 以上全部
62
+ `)
63
+ }
64
+
65
+ function parseArgs(argv: string[]) {
66
+ const opts: {
67
+ pool: PoolKind
68
+ page: number
69
+ pageSize: number
70
+ apiBaseUrl?: string
71
+ out?: string
72
+ codesOnly: boolean
73
+ help: boolean
74
+ } = {
75
+ pool: 'all',
76
+ page: 0,
77
+ pageSize: 100,
78
+ codesOnly: false,
79
+ help: false,
80
+ }
81
+
82
+ for (const arg of argv) {
83
+ if (arg === '--') continue
84
+ if (arg === '--help' || arg === '-h') {
85
+ opts.help = true
86
+ continue
87
+ }
88
+ if (arg === '--codes-only') {
89
+ opts.codesOnly = true
90
+ continue
91
+ }
92
+ const m = /^--([^=]+)=(.*)$/.exec(arg)
93
+ if (!m) {
94
+ console.warn(`Ignoring unknown argument: ${arg}`)
95
+ continue
96
+ }
97
+ const [, key, value] = m
98
+ switch (key) {
99
+ case 'pool':
100
+ if (!POOL_KINDS.has(value as PoolKind)) {
101
+ throw new Error(`Invalid --pool=${value}`)
102
+ }
103
+ opts.pool = value as PoolKind
104
+ break
105
+ case 'page': {
106
+ const n = Number(value)
107
+ if (!Number.isInteger(n) || n < 0) throw new Error(`Invalid --page=${value}`)
108
+ opts.page = n
109
+ break
110
+ }
111
+ case 'page-size': {
112
+ const n = Number(value)
113
+ if (!Number.isInteger(n) || n <= 0) throw new Error(`Invalid --page-size=${value}`)
114
+ opts.pageSize = n
115
+ break
116
+ }
117
+ case 'api':
118
+ opts.apiBaseUrl = value
119
+ break
120
+ case 'out':
121
+ opts.out = resolve(process.cwd(), value)
122
+ break
123
+ default:
124
+ console.warn(`Ignoring unknown option: --${key}`)
125
+ }
126
+ }
127
+
128
+ return opts
129
+ }
130
+
131
+ function wants(
132
+ pool: PoolKind,
133
+ kind: 'trend' | 'limitup' | 'large-trend' | 'large-limitup',
134
+ ): boolean {
135
+ if (pool === 'all') return true
136
+ if (pool === 'both') return kind === 'trend' || kind === 'limitup'
137
+ return pool === kind
138
+ }
139
+
140
+ function summarizeItem(row: SnapshotPoolItem): string {
141
+ const bits = [
142
+ row.code,
143
+ row.name ?? '',
144
+ row.jiuyanFieldName ? `题材=${row.jiuyanFieldName}` : '',
145
+ row.jiuyanActDate ? `异动=${row.jiuyanActDate}` : '',
146
+ row.jiuyanLimitUpTotalDays != null ? `涨停天=${row.jiuyanLimitUpTotalDays}` : '',
147
+ row.dayReturn20d != null ? `20d=${row.dayReturn20d}` : '',
148
+ row.dayReturn40d != null ? `40d=${row.dayReturn40d}` : '',
149
+ row.dayReturn60d != null ? `60d=${row.dayReturn60d}` : '',
150
+ row.floatMarketCapYuan != null
151
+ ? `流通=${(row.floatMarketCapYuan / 1e8).toFixed(1)}亿`
152
+ : '',
153
+ row.fundHoldingsCount != null ? `基金=${row.fundHoldingsCount}` : '',
154
+ ].filter(Boolean)
155
+ return bits.join(' ')
156
+ }
157
+
158
+ function printPool(label: string, pool: SnapshotPoolResult, codesOnly: boolean): void {
159
+ console.log(`\n=== ${label} ===`)
160
+ console.log(` count: ${pool.items.length}`)
161
+ console.log(` sourceTotals: ${JSON.stringify(pool.sourceTotals)}`)
162
+ if (pool.dataVersion != null) console.log(` dataVersion: ${pool.dataVersion}`)
163
+ if (pool.stale != null) console.log(` stale: ${pool.stale}`)
164
+
165
+ for (const row of pool.items) {
166
+ console.log(codesOnly ? row.code : ` ${summarizeItem(row)}`)
167
+ }
168
+ }
169
+
170
+ async function writePool(
171
+ out: string | undefined,
172
+ filename: string,
173
+ pool: SnapshotPoolResult,
174
+ ): Promise<void> {
175
+ if (!out) return
176
+ const path = resolve(out, filename)
177
+ await writeFile(path, `${JSON.stringify(pool, null, 2)}\n`, 'utf8')
178
+ console.log(` wrote: ${path}`)
179
+ }
180
+
181
+ async function main(): Promise<void> {
182
+ const opts = parseArgs(process.argv.slice(2))
183
+ if (opts.help) {
184
+ printUsage()
185
+ return
186
+ }
187
+
188
+ const sdk = new AgentStockSdk({ apiBaseUrl: opts.apiBaseUrl })
189
+ const paging = { page: opts.page, pageSize: opts.pageSize }
190
+
191
+ console.log('Fetching snapshot pools…')
192
+ console.log(` api: ${sdk.apiBaseUrl}`)
193
+ console.log(` pool: ${opts.pool}`)
194
+ console.log(` page: ${paging.page}`)
195
+ console.log(` pageSize: ${paging.pageSize}`)
196
+
197
+ if (opts.out) {
198
+ await mkdir(opts.out, { recursive: true })
199
+ }
200
+
201
+ if (wants(opts.pool, 'trend')) {
202
+ const trend = await sdk.getSmallCapTrendPool(paging)
203
+ printPool('小市值趋势股 (A1∪A2)', trend, opts.codesOnly)
204
+ await writePool(opts.out, 'small-cap-trend-pool.json', trend)
205
+ }
206
+
207
+ if (wants(opts.pool, 'limitup')) {
208
+ const limitUp = await sdk.getLimitUp30dPool(paging)
209
+ printPool('近30自然日涨停活跃 (打板二波/中军)', limitUp, opts.codesOnly)
210
+ await writePool(opts.out, 'limit-up-30d-pool.json', limitUp)
211
+ }
212
+
213
+ if (wants(opts.pool, 'large-trend')) {
214
+ const largeTrend = await sdk.getLargeCapTrendPool(paging)
215
+ printPool('大市值趋势 (≥500亿)', largeTrend, opts.codesOnly)
216
+ await writePool(opts.out, 'large-cap-trend-pool.json', largeTrend)
217
+ }
218
+
219
+ if (wants(opts.pool, 'large-limitup')) {
220
+ const largeLimitUp = await sdk.getLargeCapLimitUp3dPool(paging)
221
+ printPool('大市值涨停观察 (≥300亿, 异动近3日)', largeLimitUp, opts.codesOnly)
222
+ await writePool(opts.out, 'large-cap-limit-up-3d-pool.json', largeLimitUp)
223
+ }
224
+
225
+ console.log('\nDone.')
226
+ }
227
+
228
+ main().catch((err) => {
229
+ if (err instanceof AgentStockSdkHttpError) {
230
+ console.error(`\nHTTP ${err.status}: ${err.message}`)
231
+ console.error(` url: ${err.url}`)
232
+ console.error('Check stock-api is up (default :9301).')
233
+ } else {
234
+ console.error(err instanceof Error ? err.message : err)
235
+ }
236
+ process.exitCode = 1
237
+ })
package/package.json CHANGED
@@ -1,6 +1,54 @@
1
1
  {
2
2
  "name": "@t2b2c/agent-stock-sdk",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.0",
4
+ "description": "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",
5
+ "type": "module",
6
+ "main": "./dist/index.js",
7
+ "types": "./dist/index.d.ts",
8
+ "exports": {
9
+ ".": {
10
+ "types": "./dist/index.d.ts",
11
+ "import": "./dist/index.js",
12
+ "default": "./dist/index.js"
13
+ }
14
+ },
15
+ "files": [
16
+ "dist",
17
+ "README.md",
18
+ "docs",
19
+ "examples"
20
+ ],
21
+ "publishConfig": {
22
+ "access": "public"
23
+ },
24
+ "scripts": {
25
+ "build": "tsc -p tsconfig.json",
26
+ "typecheck": "tsc -p tsconfig.json --noEmit",
27
+ "test": "vitest run",
28
+ "example:kline-shot": "tsx examples/capture-kline-screenshots.ts",
29
+ "example:market-kline-shot": "tsx examples/capture-market-kline-screenshots.ts",
30
+ "example:snapshot-pools": "tsx examples/fetch-snapshot-pools.ts",
31
+ "prepublishOnly": "pnpm run build"
32
+ },
33
+ "engines": {
34
+ "node": ">=18"
35
+ },
36
+ "keywords": [
37
+ "stock",
38
+ "sdk",
39
+ "limit-up",
40
+ "kline",
41
+ "agent"
42
+ ],
43
+ "license": "UNLICENSED",
44
+ "dependencies": {
45
+ "stock-sdk": "^2.4.6"
46
+ },
47
+ "devDependencies": {
48
+ "@t2b2c/shared-config": "workspace:*",
49
+ "@types/node": "^22.19.1",
50
+ "tsx": "^4.19.4",
51
+ "typescript": "^5.9.3",
52
+ "vitest": "catalog:"
53
+ }
54
+ }