@jackwener/opencli 1.7.3 → 1.7.5

package/clis/eastmoney/hot-rank.test.js

@@ -0,0 +1,59 @@
+import { describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '@jackwener/opencli/registry';
+import './hot-rank.js';
+
+describe('eastmoney hot-rank command', () => {
+  it('registers the command with correct metadata', () => {
+    const command = getRegistry().get('eastmoney/hot-rank');
+    expect(command).toBeDefined();
+    expect(command).toMatchObject({
+      site: 'eastmoney',
+      name: 'hot-rank',
+      description: expect.stringContaining('东方财富'),
+      domain: 'guba.eastmoney.com',
+      navigateBefore: true,
+    });
+  });
+
+  it('returns hot stock data from the page', async () => {
+    const command = getRegistry().get('eastmoney/hot-rank');
+    const mockData = [
+      { rank: 1, symbol: '600519', name: '贵州茅台', price: '1680.00', changePercent: '+2.35%', heat: '28.5万', url: 'https://guba.eastmoney.com/list,600519.html' },
+      { rank: 2, symbol: '000001', name: '平安银行', price: '12.50', changePercent: '-0.80%', heat: '15.2万', url: 'https://guba.eastmoney.com/list,000001.html' },
+    ];
+    const page = {
+      goto: vi.fn().mockResolvedValue(undefined),
+      wait: vi.fn().mockResolvedValue(undefined),
+      evaluate: vi.fn().mockResolvedValue(mockData),
+    };
+    const result = await command.func(page, { limit: 20 });
+    expect(result).toHaveLength(2);
+    expect(result[0]).toEqual(mockData[0]);
+    expect(page.goto).toHaveBeenCalledWith('https://guba.eastmoney.com/rank/');
+  });
+
+  it('respects the limit parameter', async () => {
+    const command = getRegistry().get('eastmoney/hot-rank');
+    const mockData = Array.from({ length: 30 }, (_, i) => ({
+      rank: i + 1, symbol: `${i}`, name: `stock${i}`, price: '0', changePercent: '0%', heat: '0', url: '',
+    }));
+    const page = {
+      goto: vi.fn().mockResolvedValue(undefined),
+      wait: vi.fn().mockResolvedValue(undefined),
+      evaluate: vi.fn().mockResolvedValue(mockData),
+    };
+    const result = await command.func(page, { limit: 10 });
+    expect(result).toHaveLength(10);
+  });
+
+  it('returns empty array when evaluate returns non-array', async () => {
+    const command = getRegistry().get('eastmoney/hot-rank');
+    const page = {
+      goto: vi.fn().mockResolvedValue(undefined),
+      wait: vi.fn().mockResolvedValue(undefined),
+      evaluate: vi.fn().mockResolvedValue(null),
+    };
+    const result = await command.func(page, { limit: 20 });
+    expect(result).toEqual([]);
+  });
+});

package/clis/eastmoney/index-board.js

@@ -0,0 +1,96 @@
+// eastmoney index-board — live quotes for key Chinese market indices.
+//
+// Data source: push2.eastmoney.com (Tier 1 public JSON, no auth).
+//   opencli eastmoney index-board
+//   opencli eastmoney index-board --group all
+
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
+
+const INDEX_GROUPS = {
+  main: [
+    ['1.000001', '上证指数'],
+    ['0.399001', '深证成指'],
+    ['0.399006', '创业板指'],
+    ['1.000688', '科创50'],
+    ['1.000300', '沪深300'],
+    ['1.000905', '中证500'],
+  ],
+  hk: [
+    ['100.HSI', '恒生指数'],
+    ['100.HSCEI', '恒生国企'],
+    ['100.HSTECH', '恒生科技'],
+  ],
+  us: [
+    ['100.DJIA', '道琼斯'],
+    ['100.SPX', '标普500'],
+    ['100.NDX', '纳斯达克100'],
+    ['100.IXIC', '纳斯达克综指'],
+  ],
+};
+
+const FIELDS = 'f2,f3,f4,f12,f13,f14,f15,f16,f17,f18';
+
+cli({
+  site: 'eastmoney',
+  name: 'index-board',
+  description: '主要市场指数行情（A股 / 港股 / 美股）',
+  domain: 'push2.eastmoney.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    {
+      name: 'group',
+      type: 'string',
+      default: 'main',
+      help: '指数分组：main (A股主要), hk (港股), us (美股), all',
+    },
+  ],
+  columns: ['code', 'name', 'price', 'changePercent', 'change', 'open', 'high', 'low', 'prevClose'],
+  func: async (_page, args) => {
+    const group = String(args.group ?? 'main').toLowerCase();
+    /** @type {[string,string][]} */
+    let entries;
+    if (group === 'all') {
+      entries = [...INDEX_GROUPS.main, ...INDEX_GROUPS.hk, ...INDEX_GROUPS.us];
+    } else if (INDEX_GROUPS[group]) {
+      entries = INDEX_GROUPS[group];
+    } else {
+      throw new CliError('INVALID_ARGUMENT', `Unknown group "${group}". Valid: main, hk, us, all`);
+    }
+
+    const secids = entries.map(([secid]) => secid).join(',');
+    const url = new URL('https://push2.eastmoney.com/api/qt/ulist.np/get');
+    url.searchParams.set('secids', secids);
+    url.searchParams.set('fltt', '2');
+    url.searchParams.set('fields', FIELDS);
+    url.searchParams.set('ut', 'bd1d9ddb04089700cf9c27f6f7426281');
+
+    const resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0', Accept: 'application/json' } });
+    if (!resp.ok) throw new CliError('HTTP_ERROR', `eastmoney index-board failed: HTTP ${resp.status}`);
+    const data = await resp.json();
+    const diff = Array.isArray(data?.data?.diff) ? data.data.diff : [];
+    if (diff.length === 0) throw new CliError('NO_DATA', 'eastmoney returned no index data');
+
+    // Preserve the order defined in INDEX_GROUPS regardless of API ordering
+    const byCode = new Map(diff.map((it) => [String(it.f12), it]));
+    return entries
+      .map(([secid, fallbackName]) => {
+        const code = secid.split('.')[1];
+        const it = byCode.get(code);
+        if (!it) return null;
+        return {
+          code,
+          name: it.f14 || fallbackName,
+          price: it.f2,
+          changePercent: it.f3,
+          change: it.f4,
+          open: it.f17,
+          high: it.f15,
+          low: it.f16,
+          prevClose: it.f18,
+        };
+      })
+      .filter(Boolean);
+  },
+});

package/clis/eastmoney/kline.js

@@ -0,0 +1,87 @@
+// eastmoney kline — historical OHLCV for one stock, any timeframe.
+//
+// Data source: push2his.eastmoney.com (Tier 1 public JSON).
+//   opencli eastmoney kline 600519 --period day --limit 30
+//   opencli eastmoney kline sh600519 --period week --adjust forward
+
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
+import { resolveSecid } from './_secid.js';
+
+const PERIOD_MAP = {
+  '1m': 1, '5m': 5, '15m': 15, '30m': 30, '60m': 60,
+  minute: 1, hour: 60,
+  day: 101, daily: 101,
+  week: 102, weekly: 102,
+  month: 103, monthly: 103,
+};
+
+const ADJUST_MAP = {
+  none: 0, no: 0, off: 0,
+  forward: 1, front: 1, 'pre': 1,
+  backward: 2, back: 2, 'post': 2,
+};
+
+cli({
+  site: 'eastmoney',
+  name: 'kline',
+  description: 'K线历史数据（分/日/周/月/前复权/后复权）',
+  domain: 'push2his.eastmoney.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'symbol', required: true, positional: true, help: '股票代码（A/HK/US 均可）' },
+    { name: 'period', type: 'string', default: 'day', help: '周期：1m/5m/15m/30m/60m/day/week/month' },
+    { name: 'adjust', type: 'string', default: 'forward', help: '复权：none / forward / backward' },
+    { name: 'limit',  type: 'int',    default: 30,        help: '返回最近 N 根（末尾）' },
+  ],
+  columns: ['date', 'open', 'close', 'high', 'low', 'volume', 'turnover', 'amplitude', 'changePercent', 'change', 'turnoverRate'],
+  func: async (_page, args) => {
+    const secid = resolveSecid(args.symbol);
+    const periodKey = String(args.period ?? 'day').toLowerCase();
+    const klt = PERIOD_MAP[periodKey];
+    if (klt == null) {
+      throw new CliError('INVALID_ARGUMENT', `Unknown period "${periodKey}". Valid: ${Object.keys(PERIOD_MAP).join(', ')}`);
+    }
+    const adjustKey = String(args.adjust ?? 'forward').toLowerCase();
+    const fqt = ADJUST_MAP[adjustKey];
+    if (fqt == null) {
+      throw new CliError('INVALID_ARGUMENT', `Unknown adjust "${adjustKey}". Valid: none / forward / backward`);
+    }
+    const limit = Math.max(1, Math.min(Number(args.limit) || 30, 1000));
+
+    const url = new URL('https://push2his.eastmoney.com/api/qt/stock/kline/get');
+    url.searchParams.set('secid', secid);
+    url.searchParams.set('klt', String(klt));
+    url.searchParams.set('fqt', String(fqt));
+    url.searchParams.set('beg', '0');
+    url.searchParams.set('end', '20500101');
+    url.searchParams.set('fields1', 'f1,f2,f3,f4,f5,f6');
+    url.searchParams.set('fields2', 'f51,f52,f53,f54,f55,f56,f57,f58,f59,f60,f61');
+    url.searchParams.set('ut', 'b2884a393a59ad64002292a3e90d46a5');
+
+    const resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0' } });
+    if (!resp.ok) throw new CliError('HTTP_ERROR', `eastmoney kline failed: HTTP ${resp.status}`);
+    const data = await resp.json();
+    /** @type {string[]} */
+    const raw = Array.isArray(data?.data?.klines) ? data.data.klines : [];
+    if (raw.length === 0) throw new CliError('NO_DATA', `No kline data for ${args.symbol}`);
+
+    return raw.slice(-limit).map((line) => {
+      const [date, open, close, high, low, volume, turnover, amplitude, changePercent, change, turnoverRate] = line.split(',');
+      return {
+        date,
+        open: Number(open),
+        close: Number(close),
+        high: Number(high),
+        low: Number(low),
+        volume: Number(volume),
+        turnover: Number(turnover),
+        amplitude: Number(amplitude),
+        changePercent: Number(changePercent),
+        change: Number(change),
+        turnoverRate: Number(turnoverRate),
+      };
+    });
+  },
+});

package/clis/eastmoney/kuaixun.js

@@ -0,0 +1,54 @@
+// eastmoney kuaixun — 7x24 real-time market news feed.
+//
+//   opencli eastmoney kuaixun
+//   opencli eastmoney kuaixun --column 102 --limit 30
+
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
+
+// Known columns on eastmoney 7x24:
+//   102 = 重要 (default)
+//   101 = 全部
+//   104 = 公司
+//   105 = 市场
+//   106 = 机构
+//   107 = 宏观
+
+cli({
+  site: 'eastmoney',
+  name: 'kuaixun',
+  description: '东方财富 7x24 财经快讯',
+  domain: 'np-listapi.eastmoney.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'column', type: 'string', default: '102', help: '频道：102 (重要) / 101 (全部) / 104 / 105 / 106 / 107' },
+    { name: 'limit',  type: 'int',    default: 20,    help: '返回数量 (max 100)' },
+  ],
+  columns: ['time', 'title', 'summary', 'stocks'],
+  func: async (_page, args) => {
+    const column = String(args.column ?? '102').trim();
+    const limit = Math.max(1, Math.min(Number(args.limit) || 20, 100));
+
+    const url = new URL('https://np-listapi.eastmoney.com/comm/web/getFastNewsList');
+    url.searchParams.set('client', 'web');
+    url.searchParams.set('biz', 'web_724');
+    url.searchParams.set('fastColumn', column);
+    url.searchParams.set('sortEnd', '');
+    url.searchParams.set('pageSize', String(limit));
+    url.searchParams.set('req_trace', '1');
+
+    const resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0', Accept: 'application/json' } });
+    if (!resp.ok) throw new CliError('HTTP_ERROR', `kuaixun failed: HTTP ${resp.status}`);
+    const data = await resp.json();
+    const list = Array.isArray(data?.data?.fastNewsList) ? data.data.fastNewsList : [];
+    if (list.length === 0) throw new CliError('NO_DATA', 'eastmoney returned no kuaixun data');
+
+    return list.slice(0, limit).map((it) => ({
+      time: it.showTime,
+      title: it.title,
+      summary: (it.summary || '').replace(/\s+/g, ' ').slice(0, 400),
+      stocks: Array.isArray(it.stockList) ? it.stockList.join(', ') : '',
+    }));
+  },
+});

package/clis/eastmoney/longhu.js

@@ -0,0 +1,67 @@
+// eastmoney longhu — dragon & tiger list (龙虎榜).
+//
+//   opencli eastmoney longhu
+//   opencli eastmoney longhu --date 2025-12-10 --limit 20
+
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
+
+function defaultTradeDate() {
+  // Default window = 30 days back; results sorted DESC so latest comes first.
+  // This avoids missing data on weekends/holidays when "yesterday" had no trading.
+  const d = new Date(Date.now() + 8 * 3600 * 1000);
+  d.setUTCDate(d.getUTCDate() - 30);
+  return d.toISOString().slice(0, 10);
+}
+
+cli({
+  site: 'eastmoney',
+  name: 'longhu',
+  description: '龙虎榜明细（A股交易所公开披露榜单）',
+  domain: 'datacenter-web.eastmoney.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'date',  type: 'string', default: '',  help: '开始交易日 YYYY-MM-DD (默认昨天)' },
+    { name: 'limit', type: 'int',    default: 20,  help: '返回数量 (max 100)' },
+  ],
+  columns: ['tradeDate', 'code', 'name', 'closePrice', 'changeRate', 'boardAmt', 'buyAmt', 'sellAmt', 'netAmt', 'turnover', 'dealRatio', 'market', 'reason'],
+  func: async (_page, args) => {
+    const sinceDate = String(args.date || '').trim() || defaultTradeDate();
+    const limit = Math.max(1, Math.min(Number(args.limit) || 20, 100));
+
+    const url = new URL('https://datacenter-web.eastmoney.com/api/data/v1/get');
+    url.searchParams.set('sortColumns', 'TRADE_DATE,SECURITY_CODE');
+    url.searchParams.set('sortTypes', '-1,1');
+    url.searchParams.set('pageSize', String(limit));
+    url.searchParams.set('pageNumber', '1');
+    url.searchParams.set('reportName', 'RPT_DAILYBILLBOARD_DETAILS');
+    url.searchParams.set('columns', 'ALL');
+    url.searchParams.set('source', 'WEB');
+    url.searchParams.set('client', 'WEB');
+    url.searchParams.set('filter', `(TRADE_DATE>='${sinceDate}')`);
+
+    const resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0' } });
+    if (!resp.ok) throw new CliError('HTTP_ERROR', `longhu failed: HTTP ${resp.status}`);
+    const data = await resp.json();
+    /** @type {any[]} */
+    const rows = Array.isArray(data?.result?.data) ? data.result.data : [];
+    if (rows.length === 0) throw new CliError('NO_DATA', `No longhu data since ${sinceDate}`);
+
+    return rows.slice(0, limit).map((it) => ({
+      tradeDate: String(it.TRADE_DATE || '').slice(0, 10),
+      code: it.SECURITY_CODE,
+      name: it.SECURITY_NAME_ABBR,
+      closePrice: it.CLOSE_PRICE,
+      changeRate: it.CHANGE_RATE,
+      boardAmt: it.BILLBOARD_DEAL_AMT,
+      buyAmt: it.BILLBOARD_BUY_AMT,
+      sellAmt: it.BILLBOARD_SELL_AMT,
+      netAmt: it.BILLBOARD_NET_AMT,
+      turnover: it.ACCUM_AMOUNT,
+      dealRatio: it.DEAL_AMOUNT_RATIO,
+      market: it.TRADE_MARKET,
+      reason: it.EXPLANATION,
+    }));
+  },
+});

package/clis/eastmoney/money-flow.js

@@ -0,0 +1,78 @@
+// eastmoney money-flow — main-force net inflow ranking (沪深A今日/5日/10日).
+//
+//   opencli eastmoney money-flow
+//   opencli eastmoney money-flow --range 5d --limit 30
+
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
+
+const A_MARKET = 'm:0+t:6,m:0+t:80,m:1+t:2,m:1+t:23,m:0+t:81+s:2048';
+
+// (main, super, big, medium, small) net inflow amount fields
+const RANGES = {
+  today: { fid: 'f62', fields: { net: 'f62', netPct: 'f184', super: 'f66', big: 'f72', medium: 'f78', small: 'f84' } },
+  '5d':  { fid: 'f164', fields: { net: 'f164', netPct: 'f165', super: 'f166', big: 'f169', medium: 'f172', small: 'f175' } },
+  '10d': { fid: 'f174', fields: { net: 'f174', netPct: 'f175', super: 'f176', big: 'f179', medium: 'f182', small: 'f185' } },
+};
+
+cli({
+  site: 'eastmoney',
+  name: 'money-flow',
+  description: '主力资金净流入排行（今日/5日/10日）',
+  domain: 'push2.eastmoney.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'range', type: 'string', default: 'today', help: '周期：today / 5d / 10d' },
+    { name: 'order', type: 'string', default: 'desc', help: '排序：desc (净流入排行) / asc (净流出)' },
+    { name: 'limit', type: 'int', default: 20, help: '返回数量 (max 100)' },
+  ],
+  columns: ['rank', 'code', 'name', 'price', 'changePercent', 'mainNet', 'mainNetRatio', 'superNet', 'bigNet', 'mediumNet', 'smallNet'],
+  func: async (_page, args) => {
+    const rangeKey = String(args.range ?? 'today').toLowerCase();
+    const range = RANGES[rangeKey];
+    if (!range) {
+      throw new CliError('INVALID_ARGUMENT', `Unknown range "${rangeKey}". Valid: ${Object.keys(RANGES).join(', ')}`);
+    }
+    const po = String(args.order ?? 'desc').toLowerCase() === 'asc' ? '0' : '1';
+    const limit = Math.max(1, Math.min(Number(args.limit) || 20, 100));
+
+    const fieldList = [
+      'f12', 'f14', 'f2', 'f3',
+      range.fields.net, range.fields.netPct,
+      range.fields.super, range.fields.big, range.fields.medium, range.fields.small,
+    ];
+
+    const url = new URL('https://push2.eastmoney.com/api/qt/clist/get');
+    url.searchParams.set('pn', '1');
+    url.searchParams.set('pz', String(limit));
+    url.searchParams.set('po', po);
+    url.searchParams.set('np', '1');
+    url.searchParams.set('fltt', '2');
+    url.searchParams.set('invt', '2');
+    url.searchParams.set('fid', range.fid);
+    url.searchParams.set('fs', A_MARKET);
+    url.searchParams.set('fields', fieldList.join(','));
+    url.searchParams.set('ut', 'b2884a393a59ad64002292a3e90d46a5');
+
+    const resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0' } });
+    if (!resp.ok) throw new CliError('HTTP_ERROR', `money-flow failed: HTTP ${resp.status}`);
+    const data = await resp.json();
+    const diff = Array.isArray(data?.data?.diff) ? data.data.diff : [];
+    if (diff.length === 0) throw new CliError('NO_DATA', 'eastmoney returned no money-flow data');
+
+    return diff.slice(0, limit).map((it, i) => ({
+      rank: i + 1,
+      code: it.f12,
+      name: it.f14,
+      price: it.f2,
+      changePercent: it.f3,
+      mainNet: it[range.fields.net],
+      mainNetRatio: it[range.fields.netPct],
+      superNet: it[range.fields.super],
+      bigNet: it[range.fields.big],
+      mediumNet: it[range.fields.medium],
+      smallNet: it[range.fields.small],
+    }));
+  },
+});

package/clis/eastmoney/northbound.js

@@ -0,0 +1,57 @@
+// eastmoney northbound — live realtime cross-border capital flow (北向/南向).
+//
+// Returns the latest non-empty minute snapshot of cumulative net flow in 万元.
+//   opencli eastmoney northbound
+//   opencli eastmoney northbound --direction south
+
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
+
+cli({
+  site: 'eastmoney',
+  name: 'northbound',
+  description: '沪深港通北向/南向资金当日分时净流入（万元）',
+  domain: 'push2.eastmoney.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'direction', type: 'string', default: 'north', help: '方向：north (北向，即外资买A) / south (南向，即内地买港)' },
+    { name: 'limit',     type: 'int',    default: 10,      help: '返回最近 N 分钟' },
+  ],
+  columns: ['time', 'cumulativeNetYi', 'minuteNetYi', 'totalNetYi'],
+  func: async (_page, args) => {
+    const dir = String(args.direction ?? 'north').toLowerCase();
+    if (!['north', 'south', 'n', 's'].includes(dir)) {
+      throw new CliError('INVALID_ARGUMENT', `Unknown direction "${dir}". Valid: north / south`);
+    }
+    const limit = Math.max(1, Math.min(Number(args.limit) || 10, 240));
+
+    const url = new URL('https://push2.eastmoney.com/api/qt/kamtbs.rtmin/get');
+    url.searchParams.set('fields1', 'f1,f2,f3,f4');
+    url.searchParams.set('fields2', 'f51,f52,f54,f56');
+    url.searchParams.set('ut', 'b2884a393a59ad64002292a3e90d46a5');
+
+    const resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0' } });
+    if (!resp.ok) throw new CliError('HTTP_ERROR', `northbound failed: HTTP ${resp.status}`);
+    const data = await resp.json();
+    const key = (dir === 'south' || dir === 's') ? 's2n' : 'n2s';
+    /** @type {string[]} */
+    const rows = Array.isArray(data?.data?.[key]) ? data.data[key] : [];
+    if (rows.length === 0) throw new CliError('NO_DATA', `No ${key} data returned`);
+
+    // CSV fields per entry: "HH:MM,cumulative_net(万), minute_net(万), total_net(万)"
+    // Drop rows with '-' (after market close or before open). Convert 万元 → 亿元 for readability.
+    const valid = rows
+      .map((r) => r.split(','))
+      .filter((c) => c.length >= 4 && c[1] !== '-');
+    if (valid.length === 0) {
+      throw new CliError('NO_DATA', `${key} has no valid minute data yet (markets may not be open)`);
+    }
+    return valid.slice(-limit).map(([time, cum, min, total]) => ({
+      time,
+      cumulativeNetYi: +(Number(cum) / 10000).toFixed(4),
+      minuteNetYi: +(Number(min) / 10000).toFixed(4),
+      totalNetYi: +(Number(total) / 10000).toFixed(4),
+    }));
+  },
+});

package/clis/eastmoney/quote.js

@@ -0,0 +1,107 @@
+// eastmoney quote — live quote for one or more stocks (A/HK/US).
+//
+// Data source: push2.eastmoney.com (Tier 1 public JSON, no auth).
+// Supported inputs (comma / space separated):
+//   600000, sh600000, 000001, sz000001, 00700.HK, hk00700, AAPL, us.AAPL
+//
+//   opencli eastmoney quote 600000 --fields all
+//   opencli eastmoney quote "sh600000,sz000001,00700.HK"
+
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { CliError } from '@jackwener/opencli/errors';
+import { resolveSecid, splitSymbols } from './_secid.js';
+
+const FIELDS = [
+  'f12', // code
+  'f13', // market
+  'f14', // name
+  'f2',  // price
+  'f3',  // changePercent
+  'f4',  // change
+  'f5',  // volume (手)
+  'f6',  // turnover (CNY)
+  'f7',  // amplitude %
+  'f8',  // turnoverRate %
+  'f9',  // peDynamic
+  'f10', // volumeRatio
+  'f15', // high
+  'f16', // low
+  'f17', // open
+  'f18', // prevClose
+  'f20', // marketCap
+  'f21', // floatMarketCap
+  'f23', // priceBook
+].join(',');
+
+function marketLabel(f13) {
+  if (f13 === 1) return 'SH';
+  if (f13 === 0) return 'SZ/BJ';
+  if (f13 === 116) return 'HK';
+  if (f13 === 105 || f13 === 106 || f13 === 107) return 'US';
+  return String(f13 ?? '');
+}
+
+cli({
+  site: 'eastmoney',
+  name: 'quote',
+  description: '个股实时行情（A股 / 港股 / 美股）— 来自 push2.eastmoney.com',
+  domain: 'push2.eastmoney.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'symbols', required: true, positional: true, help: '股票代码（可用逗号/空格分隔多个）' },
+  ],
+  columns: [
+    'code', 'name', 'market', 'price', 'changePercent', 'change',
+    'open', 'high', 'low', 'prevClose', 'volume', 'turnover',
+    'turnoverRate', 'amplitude', 'peDynamic', 'priceBook',
+    'marketCap', 'floatMarketCap',
+  ],
+  func: async (_page, args) => {
+    const raw = splitSymbols(args.symbols);
+    if (raw.length === 0) {
+      throw new CliError('INVALID_ARGUMENT', 'At least one symbol is required');
+    }
+
+    /** @type {string[]} */
+    const secids = [];
+    for (const s of raw) {
+      try { secids.push(resolveSecid(s)); }
+      catch (err) { throw new CliError('INVALID_ARGUMENT', `Unrecognized symbol "${s}"`); }
+    }
+
+    // Multi-stock in one call via ulist.np
+    const url = new URL('https://push2.eastmoney.com/api/qt/ulist.np/get');
+    url.searchParams.set('secids', secids.join(','));
+    url.searchParams.set('fltt', '2');
+    url.searchParams.set('fields', FIELDS);
+    url.searchParams.set('ut', 'bd1d9ddb04089700cf9c27f6f7426281');
+
+    const resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0', Accept: 'application/json' } });
+    if (!resp.ok) throw new CliError('HTTP_ERROR', `eastmoney quote failed: HTTP ${resp.status}`);
+    const data = await resp.json();
+    const diff = Array.isArray(data?.data?.diff) ? data.data.diff : [];
+    if (diff.length === 0) throw new CliError('NO_DATA', 'eastmoney returned no quotes', `Check symbols: ${raw.join(', ')}`);
+
+    return diff.map((it) => ({
+      code: it.f12,
+      name: it.f14,
+      market: marketLabel(it.f13),
+      price: it.f2,
+      changePercent: it.f3,
+      change: it.f4,
+      open: it.f17,
+      high: it.f15,
+      low: it.f16,
+      prevClose: it.f18,
+      volume: it.f5,
+      turnover: it.f6,
+      turnoverRate: it.f8,
+      amplitude: it.f7,
+      peDynamic: it.f9,
+      priceBook: it.f23,
+      marketCap: it.f20,
+      floatMarketCap: it.f21,
+    }));
+  },
+});