@jackwener/opencli 1.7.1 → 1.7.3

package/clis/barchart/flow.js

@@ -26,7 +26,7 @@ cli({
         const data = await page.evaluate(`
       (async () => {
         const limit = ${limit};
-        const typeFilter = '${optionType}'.toLowerCase();
+        const typeFilter = ${JSON.stringify(optionType)}.toLowerCase();
 
         // Wait for CSRF token to appear (Angular may inject it after initial render)
         let csrf = '';

package/clis/barchart/greeks.js

@@ -27,8 +27,8 @@ cli({
         await page.wait(4);
         const data = await page.evaluate(`
       (async () => {
-        const sym = '${symbol}';
-        const expDate = '${expiration}';
+        const sym = ${JSON.stringify(symbol)};
+        const expDate = ${JSON.stringify(expiration)};
         const limit = ${limit};
         const csrf = document.querySelector('meta[name="csrf-token"]')?.content || '';
         const headers = { 'X-CSRF-TOKEN': csrf };

package/clis/barchart/options.js

@@ -26,8 +26,8 @@ cli({
         await page.wait(4);
         const data = await page.evaluate(`
       (async () => {
-        const sym = '${symbol}';
-        const type = '${optType}';
+        const sym = ${JSON.stringify(symbol)};
+        const type = ${JSON.stringify(optType)};
         const limit = ${limit};
         const csrf = document.querySelector('meta[name="csrf-token"]')?.content || '';
         const headers = { 'X-CSRF-TOKEN': csrf };

package/clis/barchart/quote.js

@@ -24,7 +24,7 @@ cli({
         await page.wait(4);
         const data = await page.evaluate(`
       (async () => {
-        const sym = '${symbol}';
+        const sym = ${JSON.stringify(symbol)};
         const csrf = document.querySelector('meta[name="csrf-token"]')?.content || '';
 
         // Strategy 1: internal proxy API with CSRF token

package/clis/bilibili/feed.js

@@ -1,64 +1,218 @@
 import { cli, Strategy } from '@jackwener/opencli/registry';
-import { apiGet, payloadData, stripHtml } from './utils.js';
+import { apiGet, payloadData, resolveUid, stripHtml } from './utils.js';
+
+/** Map bilibili dynamic type to readable short name */
+const TYPE_MAP = {
+    DYNAMIC_TYPE_AV: 'video',
+    DYNAMIC_TYPE_DRAW: 'draw',
+    DYNAMIC_TYPE_ARTICLE: 'article',
+    DYNAMIC_TYPE_FORWARD: 'forward',
+    DYNAMIC_TYPE_WORD: 'text',
+    DYNAMIC_TYPE_LIVE_RCMD: 'live',
+    DYNAMIC_TYPE_PGC: 'bangumi',
+};
+
+function parseItem(item) {
+    const modules = item.modules ?? {};
+    const authorModule = modules.module_author ?? {};
+    const dynamicModule = modules.module_dynamic ?? {};
+    const major = dynamicModule.major ?? {};
+    const stat = modules.module_stat ?? {};
+
+    let title = '';
+    let url = item.id_str ? `https://t.bilibili.com/${item.id_str}` : '';
+    const itemType = TYPE_MAP[item.type] ?? item.type ?? '';
+
+    // video
+    if (major.archive) {
+        title = major.archive.title ?? '';
+        url = major.archive.jump_url ? `https:${major.archive.jump_url}` : url;
+    }
+    // article
+    if (!title && major.article) {
+        title = major.article.title ?? '';
+        url = major.article.jump_url ? `https:${major.article.jump_url}` : url;
+    }
+    // text content in desc
+    if (!title && dynamicModule.desc?.text) {
+        title = stripHtml(dynamicModule.desc.text).slice(0, 60);
+    }
+    // draw (图文) — use opus or draw items count as hint
+    if (!title && major.draw) {
+        const imgCount = major.draw.items?.length ?? 0;
+        title = imgCount > 0 ? `[图片x${imgCount}]` : '[图文动态]';
+    }
+    // VIP only content
+    if (!title && item.basic?.is_only_fans) {
+        title = '[充电专属]';
+    }
+    // forward
+    if (!title && item.type === 'DYNAMIC_TYPE_FORWARD') {
+        title = '[转发动态]';
+    }
+    // final fallback
+    if (!title) {
+        title = `[${itemType || '动态'}]`;
+    }
+
+    const time = authorModule.pub_time ?? '';
+    const likes = stat.like?.count ?? 0;
+    const comments = stat.comment?.count ?? 0;
+
+    return { title, url, itemType, author: authorModule.name ?? '', time, likes, comments };
+}
+
 cli({
     site: 'bilibili',
     name: 'feed',
-    description: '关注的人的动态时间线',
+    description: '动态时间线（不传 uid 查关注时间线，传 uid 查指定用户动态）',
     domain: 'www.bilibili.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Number of results' },
-        { name: 'type', default: 'all', help: 'Filter: all, video, article' },
+        { name: 'uid', positional: true, required: false, help: '用户 UID 或用户名（不传则显示关注时间线）' },
+        { name: 'limit', type: 'int', default: 20, help: 'Max results to return' },
+        { name: 'type', default: 'all', help: 'Filter: all, video, article, draw, text' },
+        { name: 'pages', type: 'int', default: 1, help: 'Number of pages to fetch (each ~20 items)' },
     ],
-    columns: ['rank', 'author', 'title', 'type', 'url'],
+    columns: ['rank', 'time', 'author', 'title', 'type', 'likes', 'url'],
     func: async (page, kwargs) => {
-        const { limit = 20, type = 'all' } = kwargs;
-        const typeMap = { all: 'all', video: 'video', article: 'article' };
-        const updateBaseline = '';
-        const payload = await apiGet(page, '/x/polymer/web-dynamic/v1/feed/all', {
-            params: {
-                timezone_offset: -480,
-                type: typeMap[type] ?? 'all',
-                page: 1,
-                ...(updateBaseline ? { update_baseline: updateBaseline } : {}),
-            },
-        });
-        const items = payloadData(payload)?.items ?? [];
+        const maxResults = Number(kwargs.limit) || 20;
+        const maxPages = Number(kwargs.pages) || 1;
+        const filterType = kwargs.type === 'all' ? '' : (kwargs.type ?? '');
+
+        const isUserFeed = !!kwargs.uid;
+        const uid = isUserFeed ? await resolveUid(page, String(kwargs.uid)) : null;
+
         const rows = [];
-        for (let i = 0; i < Math.min(items.length, Number(limit)); i++) {
-            const item = items[i];
-            const modules = item.modules ?? {};
-            const authorModule = modules.module_author ?? {};
-            const dynamicModule = modules.module_dynamic ?? {};
-            const major = dynamicModule.major ?? {};
-            let title = '';
-            let url = '';
-            let itemType = item.type ?? '';
-            if (major.archive) {
-                title = major.archive.title ?? '';
-                url = major.archive.jump_url ? `https:${major.archive.jump_url}` : '';
-                itemType = 'video';
-            }
-            else if (major.article) {
-                title = major.article.title ?? '';
-                url = major.article.jump_url ? `https:${major.article.jump_url}` : '';
-                itemType = 'article';
+        let offset = '';
+
+        for (let p = 0; p < maxPages; p++) {
+            if (rows.length >= maxResults) break;
+
+            let payload;
+            if (isUserFeed) {
+                const params = { host_mid: uid, timezone_offset: -480 };
+                if (offset) params.offset = offset;
+                payload = await apiGet(page, '/x/polymer/web-dynamic/v1/feed/space', { params });
+            } else {
+                const params = {
+                    timezone_offset: -480,
+                    type: filterType || 'all',
+                    page: p + 1,
+                };
+                if (offset) params.offset = offset;
+                payload = await apiGet(page, '/x/polymer/web-dynamic/v1/feed/all', { params });
             }
-            else if (dynamicModule.desc) {
-                title = stripHtml(dynamicModule.desc.text ?? '').slice(0, 60);
-                url = item.id_str ? `https://t.bilibili.com/${item.id_str}` : '';
-                itemType = 'dynamic';
+
+            const data = payloadData(payload) ?? {};
+            const items = data.items ?? [];
+            if (items.length === 0) break;
+
+            for (const item of items) {
+                if (rows.length >= maxResults) break;
+                const parsed = parseItem(item);
+                if (filterType && parsed.itemType !== filterType) continue;
+                rows.push({
+                    rank: rows.length + 1,
+                    time: parsed.time,
+                    author: parsed.author,
+                    title: parsed.title,
+                    type: parsed.itemType,
+                    likes: parsed.likes,
+                    url: parsed.url,
+                });
             }
-            if (!title)
-                continue;
-            rows.push({
-                rank: rows.length + 1,
-                author: authorModule.name ?? '',
-                title,
-                type: itemType,
-                url,
-            });
+
+            offset = data.offset ?? items[items.length - 1]?.id_str ?? '';
+            if (!offset || !data.has_more) break;
+        }
+
+        return rows;
+    },
+});
+
+cli({
+    site: 'bilibili',
+    name: 'feed-detail',
+    description: '查看 Bilibili 动态详情（支持充电专属内容）',
+    domain: 'www.bilibili.com',
+    strategy: Strategy.COOKIE,
+    args: [
+        { name: 'id', positional: true, required: true, help: '动态 ID（从 feed 命令的 url 中获取）' },
+    ],
+    columns: ['field', 'value'],
+    func: async (page, kwargs) => {
+        const id = String(kwargs.id);
+        const payload = await apiGet(page, '/x/polymer/web-dynamic/v1/detail', {
+            params: { id, timezone_offset: -480 },
+        });
+
+        const rows = [];
+        const data = payloadData(payload);
+        const item = data?.item;
+        if (!item) {
+            rows.push({ field: 'error', value: '动态不存在或无权查看'});
+            return rows;
+        }
+
+        const modules = item.modules ?? {};
+        const author = modules.module_author ?? {};
+        const dynamicModule = modules.module_dynamic ?? {};
+        const major = dynamicModule.major ?? {};
+        const stat = modules.module_stat ?? {};
+
+        rows.push({ field: 'id', value: item.id_str ?? id });
+        rows.push({ field: 'author', value: author.name ?? '' });
+        rows.push({ field: 'time', value: author.pub_time ?? '' });
+        rows.push({ field: 'type', value: TYPE_MAP[item.type] ?? item.type ?? '' });
+
+        // text content
+        if (dynamicModule.desc?.text) {
+            rows.push({ field: 'text', value: stripHtml(dynamicModule.desc.text) });
+        }
+
+        // video
+        if (major.archive) {
+            rows.push({ field: 'video_title', value: major.archive.title ?? '' });
+            rows.push({ field: 'video_desc', value: major.archive.desc ?? '' });
+            rows.push({ field: 'video_url', value: major.archive.jump_url ? `https:${major.archive.jump_url}` : '' });
+            rows.push({ field: 'play', value: String(major.archive.stat?.play ?? '') });
+            rows.push({ field: 'danmaku', value: String(major.archive.stat?.danmaku ?? '') });
+        }
+
+        // article
+        if (major.article) {
+            rows.push({ field: 'article_title', value: major.article.title ?? '' });
+            rows.push({ field: 'article_url', value: major.article.jump_url ? `https:${major.article.jump_url}` : '' });
+        }
+
+        // draw (images)
+        if (major.draw?.items?.length) {
+            rows.push({ field: 'images', value: major.draw.items.map((img) => img.src).join('\n') });
+        }
+
+        // opus (rich text, some dynamics use this)
+        if (major.opus?.summary?.text) {
+            rows.push({ field: 'opus_text', value: stripHtml(major.opus.summary.text) });
+        }
+        if (major.opus?.title) {
+            rows.push({ field: 'opus_title', value: major.opus.title });
+        }
+
+        // forward - show original dynamic info
+        if (item.orig) {
+            const origAuthor = item.orig.modules?.module_author?.name ?? '';
+            const origDesc = item.orig.modules?.module_dynamic?.desc?.text ?? '';
+            rows.push({ field: 'forward_from', value: origAuthor });
+            if (origDesc) rows.push({ field: 'forward_text', value: stripHtml(origDesc).slice(0, 200) });
         }
+
+        // stats
+        rows.push({ field: 'likes', value: String(stat.like?.count ?? 0) });
+        rows.push({ field: 'comments', value: String(stat.comment?.count ?? 0) });
+        rows.push({ field: 'forwards', value: String(stat.forward?.count ?? 0) });
+        rows.push({ field: 'url', value: `https://t.bilibili.com/${item.id_str ?? id}` });
+
         return rows;
     },
 });

package/clis/binance/asks.js

@@ -0,0 +1,21 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+
+cli({
+  site: 'binance',
+  name: 'asks',
+  description: 'Order book ask prices for a trading pair',
+  domain: 'data-api.binance.vision',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'symbol', type: 'str', required: true, positional: true, help: 'Trading pair symbol (e.g. BTCUSDT, ETHUSDT)' },
+    { name: 'limit', type: 'int', default: 10, help: 'Number of price levels (5, 10, 20, 50, 100)' },
+  ],
+  columns: ['rank', 'ask_price', 'ask_qty'],
+  pipeline: [
+    { fetch: { url: 'https://data-api.binance.vision/api/v3/depth?symbol=${{ args.symbol }}&limit=${{ args.limit }}' } },
+    { select: 'asks' },
+    { map: { rank: '${{ index + 1 }}', ask_price: '${{ item.0 }}', ask_qty: '${{ item.1 }}' } },
+    { limit: '${{ args.limit }}' },
+  ],
+});

package/clis/binance/commands.test.js

@@ -0,0 +1,70 @@
+import { getRegistry } from '@jackwener/opencli/registry';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { executePipeline } from '@jackwener/opencli/pipeline';
+
+// Import all binance adapters to register them
+import './top.js';
+import './gainers.js';
+import './pairs.js';
+
+function loadPipeline(name) {
+  const cmd = getRegistry().get(`binance/${name}`);
+  if (!cmd?.pipeline) throw new Error(`Command binance/${name} not found or has no pipeline`);
+  return cmd.pipeline;
+}
+
+function mockJsonOnce(payload) {
+  vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+    ok: true,
+    status: 200,
+    statusText: 'OK',
+    json: vi.fn().mockResolvedValue(payload),
+  }));
+}
+
+afterEach(() => {
+  vi.unstubAllGlobals();
+  vi.restoreAllMocks();
+});
+
+describe('binance adapters', () => {
+  it('sorts top pairs by numeric quote volume', async () => {
+    mockJsonOnce([
+      { symbol: 'SMALL', lastPrice: '1', priceChangePercent: '1.2', highPrice: '1', lowPrice: '1', quoteVolume: '9.9' },
+      { symbol: 'LARGE', lastPrice: '2', priceChangePercent: '2.3', highPrice: '2', lowPrice: '2', quoteVolume: '100.0' },
+      { symbol: 'MID', lastPrice: '3', priceChangePercent: '3.4', highPrice: '3', lowPrice: '3', quoteVolume: '11.0' },
+    ]);
+
+    const result = await executePipeline(null, loadPipeline('top'), { args: { limit: 3 } });
+
+    expect(result.map((item) => item.symbol)).toEqual(['LARGE', 'MID', 'SMALL']);
+    expect(result.map((item) => item.rank)).toEqual([1, 2, 3]);
+  });
+
+  it('sorts gainers by numeric percent change', async () => {
+    mockJsonOnce([
+      { symbol: 'TEN', lastPrice: '1', priceChangePercent: '10.0', quoteVolume: '100' },
+      { symbol: 'NINE', lastPrice: '1', priceChangePercent: '9.5', quoteVolume: '100' },
+      { symbol: 'HUNDRED', lastPrice: '1', priceChangePercent: '100.0', quoteVolume: '100' },
+    ]);
+
+    const result = await executePipeline(null, loadPipeline('gainers'), { args: { limit: 3 } });
+
+    expect(result.map((item) => item.symbol)).toEqual(['HUNDRED', 'TEN', 'NINE']);
+  });
+
+  it('keeps only TRADING pairs', async () => {
+    mockJsonOnce({
+      symbols: [
+        { symbol: 'BTCUSDT', baseAsset: 'BTC', quoteAsset: 'USDT', status: 'TRADING' },
+        { symbol: 'OLDPAIR', baseAsset: 'OLD', quoteAsset: 'USDT', status: 'BREAK' },
+      ],
+    });
+
+    const result = await executePipeline(null, loadPipeline('pairs'), { args: { limit: 10 } });
+
+    expect(result).toEqual([
+      { symbol: 'BTCUSDT', base: 'BTC', quote: 'USDT', status: 'TRADING' },
+    ]);
+  });
+});

package/clis/binance/depth.js

@@ -0,0 +1,21 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+
+cli({
+  site: 'binance',
+  name: 'depth',
+  description: 'Order book bid prices for a trading pair',
+  domain: 'data-api.binance.vision',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'symbol', type: 'str', required: true, positional: true, help: 'Trading pair symbol (e.g. BTCUSDT, ETHUSDT)' },
+    { name: 'limit', type: 'int', default: 10, help: 'Number of price levels (5, 10, 20, 50, 100)' },
+  ],
+  columns: ['rank', 'bid_price', 'bid_qty'],
+  pipeline: [
+    { fetch: { url: 'https://data-api.binance.vision/api/v3/depth?symbol=${{ args.symbol }}&limit=${{ args.limit }}' } },
+    { select: 'bids' },
+    { map: { rank: '${{ index + 1 }}', bid_price: '${{ item.0 }}', bid_qty: '${{ item.1 }}' } },
+    { limit: '${{ args.limit }}' },
+  ],
+});

package/clis/binance/gainers.js

@@ -0,0 +1,22 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+
+cli({
+  site: 'binance',
+  name: 'gainers',
+  description: 'Top gaining trading pairs by 24h price change',
+  domain: 'data-api.binance.vision',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'limit', type: 'int', default: 10, help: 'Number of trading pairs' },
+  ],
+  columns: ['rank', 'symbol', 'price', 'change_24h', 'volume'],
+  pipeline: [
+    { fetch: { url: 'https://data-api.binance.vision/api/v3/ticker/24hr' } },
+    { filter: 'item.priceChangePercent' },
+    { map: { symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_24h: '${{ item.priceChangePercent }}', volume: '${{ item.quoteVolume }}', sort_change: '${{ Number(item.priceChangePercent) }}' } },
+    { sort: { by: 'sort_change', order: 'desc' } },
+    { map: { rank: '${{ index + 1 }}', symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_24h: '${{ item.priceChangePercent }}', volume: '${{ item.quoteVolume }}' } },
+    { limit: '${{ args.limit }}' },
+  ],
+});

package/clis/binance/klines.js

@@ -0,0 +1,21 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+
+cli({
+  site: 'binance',
+  name: 'klines',
+  description: 'Candlestick/kline data for a trading pair',
+  domain: 'data-api.binance.vision',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'symbol', type: 'str', required: true, positional: true, help: 'Trading pair symbol (e.g. BTCUSDT, ETHUSDT)' },
+    { name: 'interval', type: 'str', default: '1d', help: 'Kline interval (1m, 5m, 15m, 1h, 4h, 1d, 1w, 1M)' },
+    { name: 'limit', type: 'int', default: 10, help: 'Number of klines (max 1000)' },
+  ],
+  columns: ['open', 'high', 'low', 'close', 'volume'],
+  pipeline: [
+    { fetch: { url: 'https://data-api.binance.vision/api/v3/klines?symbol=${{ args.symbol }}&interval=${{ args.interval }}&limit=${{ args.limit }}' } },
+    { map: { open: '${{ item.1 }}', high: '${{ item.2 }}', low: '${{ item.3 }}', close: '${{ item.4 }}', volume: '${{ item.5 }}' } },
+    { limit: '${{ args.limit }}' },
+  ],
+});

package/clis/binance/losers.js

@@ -0,0 +1,22 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+
+cli({
+  site: 'binance',
+  name: 'losers',
+  description: 'Top losing trading pairs by 24h price change',
+  domain: 'data-api.binance.vision',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'limit', type: 'int', default: 10, help: 'Number of trading pairs' },
+  ],
+  columns: ['rank', 'symbol', 'price', 'change_24h', 'volume'],
+  pipeline: [
+    { fetch: { url: 'https://data-api.binance.vision/api/v3/ticker/24hr' } },
+    { filter: 'item.priceChangePercent' },
+    { map: { symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_24h: '${{ item.priceChangePercent }}', volume: '${{ item.quoteVolume }}', sort_change: '${{ Number(item.priceChangePercent) }}' } },
+    { sort: { by: 'sort_change' } },
+    { map: { rank: '${{ index + 1 }}', symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_24h: '${{ item.priceChangePercent }}', volume: '${{ item.quoteVolume }}' } },
+    { limit: '${{ args.limit }}' },
+  ],
+});

package/clis/binance/pairs.js

@@ -0,0 +1,21 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+
+cli({
+  site: 'binance',
+  name: 'pairs',
+  description: 'List active trading pairs on Binance',
+  domain: 'data-api.binance.vision',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: 'Number of trading pairs' },
+  ],
+  columns: ['symbol', 'base', 'quote', 'status'],
+  pipeline: [
+    { fetch: { url: 'https://data-api.binance.vision/api/v3/exchangeInfo' } },
+    { select: 'symbols' },
+    { filter: 'item.status === \'TRADING\'' },
+    { map: { symbol: '${{ item.symbol }}', base: '${{ item.baseAsset }}', quote: '${{ item.quoteAsset }}', status: '${{ item.status }}' } },
+    { limit: '${{ args.limit }}' },
+  ],
+});

package/clis/binance/price.js

@@ -0,0 +1,18 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+
+cli({
+  site: 'binance',
+  name: 'price',
+  description: 'Quick price check for a trading pair',
+  domain: 'data-api.binance.vision',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'symbol', type: 'str', required: true, positional: true, help: 'Trading pair symbol (e.g. BTCUSDT, ETHUSDT)' },
+  ],
+  columns: ['symbol', 'price', 'change', 'change_pct', 'high', 'low', 'volume', 'quote_volume', 'trades'],
+  pipeline: [
+    { fetch: { url: 'https://data-api.binance.vision/api/v3/ticker/24hr?symbol=${{ args.symbol }}' } },
+    { map: { symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change: '${{ item.priceChange }}', change_pct: '${{ item.priceChangePercent }}', high: '${{ item.highPrice }}', low: '${{ item.lowPrice }}', volume: '${{ item.volume }}', quote_volume: '${{ item.quoteVolume }}', trades: '${{ item.count }}' } },
+  ],
+});

package/clis/binance/prices.js

@@ -0,0 +1,19 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+
+cli({
+  site: 'binance',
+  name: 'prices',
+  description: 'Latest prices for all trading pairs',
+  domain: 'data-api.binance.vision',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: 'Number of prices' },
+  ],
+  columns: ['rank', 'symbol', 'price'],
+  pipeline: [
+    { fetch: { url: 'https://data-api.binance.vision/api/v3/ticker/price' } },
+    { map: { rank: '${{ index + 1 }}', symbol: '${{ item.symbol }}', price: '${{ item.price }}' } },
+    { limit: '${{ args.limit }}' },
+  ],
+});

package/clis/binance/ticker.js

@@ -0,0 +1,21 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+
+cli({
+  site: 'binance',
+  name: 'ticker',
+  description: '24h ticker statistics for top trading pairs by volume',
+  domain: 'data-api.binance.vision',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: 'Number of tickers' },
+  ],
+  columns: ['symbol', 'price', 'change_pct', 'high', 'low', 'volume', 'quote_vol', 'trades'],
+  pipeline: [
+    { fetch: { url: 'https://data-api.binance.vision/api/v3/ticker/24hr' } },
+    { map: { symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_pct: '${{ item.priceChangePercent }}', high: '${{ item.highPrice }}', low: '${{ item.lowPrice }}', volume: '${{ item.volume }}', quote_vol: '${{ item.quoteVolume }}', trades: '${{ item.count }}', sort_volume: '${{ Number(item.quoteVolume) }}' } },
+    { sort: { by: 'sort_volume', order: 'desc' } },
+    { map: { symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_pct: '${{ item.priceChangePercent }}', high: '${{ item.highPrice }}', low: '${{ item.lowPrice }}', volume: '${{ item.volume }}', quote_vol: '${{ item.quoteVolume }}', trades: '${{ item.count }}' } },
+    { limit: '${{ args.limit }}' },
+  ],
+});

package/clis/binance/top.js

@@ -0,0 +1,21 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+
+cli({
+  site: 'binance',
+  name: 'top',
+  description: 'Top trading pairs by 24h volume on Binance',
+  domain: 'data-api.binance.vision',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: 'Number of trading pairs' },
+  ],
+  columns: ['rank', 'symbol', 'price', 'change_24h', 'high', 'low', 'volume'],
+  pipeline: [
+    { fetch: { url: 'https://data-api.binance.vision/api/v3/ticker/24hr' } },
+    { map: { symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_24h: '${{ item.priceChangePercent }}', high: '${{ item.highPrice }}', low: '${{ item.lowPrice }}', volume: '${{ item.quoteVolume }}', sort_volume: '${{ Number(item.quoteVolume) }}' } },
+    { sort: { by: 'sort_volume', order: 'desc' } },
+    { map: { rank: '${{ index + 1 }}', symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_24h: '${{ item.priceChangePercent }}', high: '${{ item.highPrice }}', low: '${{ item.lowPrice }}', volume: '${{ item.quoteVolume }}' } },
+    { limit: '${{ args.limit }}' },
+  ],
+});

package/clis/binance/trades.js

@@ -0,0 +1,20 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+
+cli({
+  site: 'binance',
+  name: 'trades',
+  description: 'Recent trades for a trading pair',
+  domain: 'data-api.binance.vision',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'symbol', type: 'str', required: true, positional: true, help: 'Trading pair symbol (e.g. BTCUSDT, ETHUSDT)' },
+    { name: 'limit', type: 'int', default: 20, help: 'Number of trades (max 1000)' },
+  ],
+  columns: ['id', 'price', 'qty', 'quote_qty', 'buyer_maker'],
+  pipeline: [
+    { fetch: { url: 'https://data-api.binance.vision/api/v3/trades?symbol=${{ args.symbol }}&limit=${{ args.limit }}' } },
+    { map: { id: '${{ item.id }}', price: '${{ item.price }}', qty: '${{ item.qty }}', quote_qty: '${{ item.quoteQty }}', buyer_maker: '${{ item.isBuyerMaker }}' } },
+    { limit: '${{ args.limit }}' },
+  ],
+});

package/clis/boss/utils.js

@@ -214,7 +214,8 @@ export async function typeAndSendMessage(page, text) {
     return true;
 }
 /**
- * Verbose log helper — prints when OPENCLI_VERBOSE or DEBUG=opencli is set.
+ * Verbose log helper — prints when OPENCLI_VERBOSE is set, with DEBUG=opencli
+ * kept as a compatibility fallback.
  */
 export function verbose(msg) {
     if (process.env.OPENCLI_VERBOSE || process.env.DEBUG?.includes('opencli')) {