@jackwener/opencli 1.7.1 → 1.7.2

package/README.md

@@ -198,7 +198,7 @@ To load the source Browser Bridge extension:
 | **bilibili** | `hot` `search` `history` `feed` `ranking` `download` `comments` `dynamic` `favorite` `following` `me` `subtitle` `user-videos` |
 | **tieba** | `hot` `posts` `search` `read` |
 | **hupu** | `hot` `search` `detail` `mentions` `reply` `like` `unlike` |
-| **twitter** | `trending` `search` `timeline` `bookmarks` `post` `download` `profile` `article` `like` `likes` `notifications` `reply` `reply-dm` `thread` `follow` `unfollow` `followers` `following` `block` `unblock` `bookmark` `unbookmark` `delete` `hide-reply` `accept` |
+| **twitter** | `trending` `search` `timeline` `lists` `bookmarks` `post` `download` `profile` `article` `like` `likes` `notifications` `reply` `reply-dm` `thread` `follow` `unfollow` `followers` `following` `block` `unblock` `bookmark` `unbookmark` `delete` `hide-reply` `accept` |
 | **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `upvoted` `save` `saved` `comment` `subscribe` |
 | **zhihu** | `hot` `search` `question` `download` `follow` `like` `favorite` `comment` `answer` |
 | **amazon** | `bestsellers` `search` `product` `offer` `discussion` `movers-shakers` `new-releases` |

package/README.zh-CN.md

@@ -184,7 +184,7 @@ npm link
 
 | 站点 | 命令 | 模式 |
 |------|------|------|
-| **twitter** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `article` `follow` `unfollow` `bookmark` `unbookmark` `download` `accept` `reply-dm` `block` `unblock` `hide-reply` | 浏览器 |
+| **twitter** | `trending` `search` `timeline` `lists` `bookmarks` `profile` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `article` `follow` `unfollow` `bookmark` `unbookmark` `download` `accept` `reply-dm` `block` `unblock` `hide-reply` | 浏览器 |
 | **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | 浏览器 |
 | **tieba** | `hot` `posts` `search` `read` | 浏览器 |
 | **hupu** | `hot` `search` `detail` `mentions` `reply` `like` `unlike` | 浏览器 |

package/cli-manifest.json

@@ -1632,6 +1632,340 @@
     "sourceFile": "bilibili/user-videos.js",
     "navigateBefore": "https://www.bilibili.com"
   },
+  {
+    "site": "binance",
+    "name": "asks",
+    "description": "Order book ask prices for a trading pair",
+    "domain": "data-api.binance.vision",
+    "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,
+        "required": false,
+        "help": "Number of price levels (5, 10, 20, 50, 100)"
+      }
+    ],
+    "columns": [
+      "rank",
+      "ask_price",
+      "ask_qty"
+    ],
+    "type": "js",
+    "modulePath": "binance/asks.js",
+    "sourceFile": "binance/asks.js"
+  },
+  {
+    "site": "binance",
+    "name": "depth",
+    "description": "Order book bid prices for a trading pair",
+    "domain": "data-api.binance.vision",
+    "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,
+        "required": false,
+        "help": "Number of price levels (5, 10, 20, 50, 100)"
+      }
+    ],
+    "columns": [
+      "rank",
+      "bid_price",
+      "bid_qty"
+    ],
+    "type": "js",
+    "modulePath": "binance/depth.js",
+    "sourceFile": "binance/depth.js"
+  },
+  {
+    "site": "binance",
+    "name": "gainers",
+    "description": "Top gaining trading pairs by 24h price change",
+    "domain": "data-api.binance.vision",
+    "strategy": "public",
+    "browser": false,
+    "args": [
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 10,
+        "required": false,
+        "help": "Number of trading pairs"
+      }
+    ],
+    "columns": [
+      "rank",
+      "symbol",
+      "price",
+      "change_24h",
+      "volume"
+    ],
+    "type": "js",
+    "modulePath": "binance/gainers.js",
+    "sourceFile": "binance/gainers.js"
+  },
+  {
+    "site": "binance",
+    "name": "klines",
+    "description": "Candlestick/kline data for a trading pair",
+    "domain": "data-api.binance.vision",
+    "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",
+        "required": false,
+        "help": "Kline interval (1m, 5m, 15m, 1h, 4h, 1d, 1w, 1M)"
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 10,
+        "required": false,
+        "help": "Number of klines (max 1000)"
+      }
+    ],
+    "columns": [
+      "open",
+      "high",
+      "low",
+      "close",
+      "volume"
+    ],
+    "type": "js",
+    "modulePath": "binance/klines.js",
+    "sourceFile": "binance/klines.js"
+  },
+  {
+    "site": "binance",
+    "name": "losers",
+    "description": "Top losing trading pairs by 24h price change",
+    "domain": "data-api.binance.vision",
+    "strategy": "public",
+    "browser": false,
+    "args": [
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 10,
+        "required": false,
+        "help": "Number of trading pairs"
+      }
+    ],
+    "columns": [
+      "rank",
+      "symbol",
+      "price",
+      "change_24h",
+      "volume"
+    ],
+    "type": "js",
+    "modulePath": "binance/losers.js",
+    "sourceFile": "binance/losers.js"
+  },
+  {
+    "site": "binance",
+    "name": "pairs",
+    "description": "List active trading pairs on Binance",
+    "domain": "data-api.binance.vision",
+    "strategy": "public",
+    "browser": false,
+    "args": [
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "help": "Number of trading pairs"
+      }
+    ],
+    "columns": [
+      "symbol",
+      "base",
+      "quote",
+      "status"
+    ],
+    "type": "js",
+    "modulePath": "binance/pairs.js",
+    "sourceFile": "binance/pairs.js"
+  },
+  {
+    "site": "binance",
+    "name": "price",
+    "description": "Quick price check for a trading pair",
+    "domain": "data-api.binance.vision",
+    "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"
+    ],
+    "type": "js",
+    "modulePath": "binance/price.js",
+    "sourceFile": "binance/price.js"
+  },
+  {
+    "site": "binance",
+    "name": "prices",
+    "description": "Latest prices for all trading pairs",
+    "domain": "data-api.binance.vision",
+    "strategy": "public",
+    "browser": false,
+    "args": [
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "help": "Number of prices"
+      }
+    ],
+    "columns": [
+      "rank",
+      "symbol",
+      "price"
+    ],
+    "type": "js",
+    "modulePath": "binance/prices.js",
+    "sourceFile": "binance/prices.js"
+  },
+  {
+    "site": "binance",
+    "name": "ticker",
+    "description": "24h ticker statistics for top trading pairs by volume",
+    "domain": "data-api.binance.vision",
+    "strategy": "public",
+    "browser": false,
+    "args": [
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "help": "Number of tickers"
+      }
+    ],
+    "columns": [
+      "symbol",
+      "price",
+      "change_pct",
+      "high",
+      "low",
+      "volume",
+      "quote_vol",
+      "trades"
+    ],
+    "type": "js",
+    "modulePath": "binance/ticker.js",
+    "sourceFile": "binance/ticker.js"
+  },
+  {
+    "site": "binance",
+    "name": "top",
+    "description": "Top trading pairs by 24h volume on Binance",
+    "domain": "data-api.binance.vision",
+    "strategy": "public",
+    "browser": false,
+    "args": [
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "help": "Number of trading pairs"
+      }
+    ],
+    "columns": [
+      "rank",
+      "symbol",
+      "price",
+      "change_24h",
+      "high",
+      "low",
+      "volume"
+    ],
+    "type": "js",
+    "modulePath": "binance/top.js",
+    "sourceFile": "binance/top.js"
+  },
+  {
+    "site": "binance",
+    "name": "trades",
+    "description": "Recent trades for a trading pair",
+    "domain": "data-api.binance.vision",
+    "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,
+        "required": false,
+        "help": "Number of trades (max 1000)"
+      }
+    ],
+    "columns": [
+      "id",
+      "price",
+      "qty",
+      "quote_qty",
+      "buyer_maker"
+    ],
+    "type": "js",
+    "modulePath": "binance/trades.js",
+    "sourceFile": "binance/trades.js"
+  },
   {
     "site": "bloomberg",
     "name": "businessweek",
@@ -13249,6 +13583,40 @@
     "sourceFile": "twitter/likes.js",
     "navigateBefore": "https://x.com"
   },
+  {
+    "site": "twitter",
+    "name": "lists",
+    "description": "Get Twitter/X lists for a user",
+    "domain": "x.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "user",
+        "type": "string",
+        "required": false,
+        "positional": true,
+        "help": ""
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 50,
+        "required": false,
+        "help": ""
+      }
+    ],
+    "columns": [
+      "name",
+      "members",
+      "followers",
+      "mode"
+    ],
+    "type": "js",
+    "modulePath": "twitter/lists.js",
+    "sourceFile": "twitter/lists.js",
+    "navigateBefore": "https://x.com"
+  },
   {
     "site": "twitter",
     "name": "notifications",
@@ -14048,11 +14416,22 @@
   {
     "site": "weibo",
     "name": "feed",
-    "description": "Weibo home timeline (posts from followed users)",
+    "description": "Fetch Weibo timeline (for-you or following)",
     "domain": "weibo.com",
     "strategy": "cookie",
     "browser": true,
     "args": [
+      {
+        "name": "type",
+        "type": "str",
+        "default": "for-you",
+        "required": false,
+        "help": "Timeline type: for-you (algorithmic) or following (chronological)",
+        "choices": [
+          "for-you",
+          "following"
+        ]
+      },
       {
         "name": "limit",
         "type": "int",
@@ -17088,6 +17467,12 @@
         "positional": true,
         "help": "Topic ID"
       },
+      {
+        "name": "group_id",
+        "type": "str",
+        "required": false,
+        "help": "Group ID (optional; defaults to active group in Chrome)"
+      },
       {
         "name": "comment_limit",
         "type": "int",

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 }}' } },
+  ],
+});