@jackwener/opencli 1.7.0 → 1.7.2

package/clis/slock/_utils.js

@@ -0,0 +1,12 @@
+// Shared helper: returns { token, serverId } for the given server slug
+// Usage: await page.evaluate(`(${slockContext})(${JSON.stringify(slug)})`)
+export const slockContext = `async (slug) => {
+  const token = localStorage.getItem('slock_access_token');
+  const lastSlug = slug || localStorage.getItem('slock_last_server_slug');
+  const r = await fetch('https://api.slock.ai/api/servers', {
+    headers: { 'Authorization': 'Bearer ' + token }
+  });
+  const servers = await r.json();
+  const server = servers.find(s => s.slug === lastSlug) || servers[0];
+  return { token, serverId: server?.id, slug: server?.slug };
+}`;

package/clis/twitter/lists-parser.js

@@ -0,0 +1,77 @@
+const MEMBER_PATTERNS = [
+    /([\d.,]+(?:\s?[KMB千萬万亿])?)\s*members?/i,
+    /([\d.,]+(?:\s?[KMB千萬万亿])?)\s*位成员/,
+];
+const FOLLOWER_PATTERNS = [
+    /([\d.,]+(?:\s?[KMB千萬万亿])?)\s*followers?/i,
+    /([\d.,]+(?:\s?[KMB千萬万亿])?)\s*位关注者/,
+];
+const PRIVATE_PATTERNS = [/\bprivate\b/i, /锁定列表/];
+const EMPTY_STATE_PATTERNS = [
+    /hasn't created any lists/i,
+    /has not created any lists/i,
+    /no lists yet/i,
+    /没有创建任何列表/,
+    /还没有创建任何列表/,
+];
+function normalizeText(text) {
+    return String(text || '').replace(/\s+/g, ' ').trim();
+}
+function matchMetric(text, patterns) {
+    for (const pattern of patterns) {
+        const match = text.match(pattern);
+        if (match)
+            return normalizeText(match[1]);
+    }
+    return '0';
+}
+function looksLikeMetadata(line) {
+    const text = normalizeText(line);
+    if (!text)
+        return true;
+    if (text.startsWith('@'))
+        return true;
+    if (MEMBER_PATTERNS.some((pattern) => pattern.test(text)))
+        return true;
+    if (FOLLOWER_PATTERNS.some((pattern) => pattern.test(text)))
+        return true;
+    if (PRIVATE_PATTERNS.some((pattern) => pattern.test(text)))
+        return true;
+    if (/^(public|pinned)$/i.test(text))
+        return true;
+    if (/^(lists?|你的列表)$/i.test(text))
+        return true;
+    return false;
+}
+export function parseListCards(cards) {
+    const seen = new Set();
+    const results = [];
+    for (const card of cards || []) {
+        const href = normalizeText(card?.href);
+        const rawText = String(card?.text || '');
+        if (!href || seen.has(href))
+            continue;
+        seen.add(href);
+        const text = normalizeText(rawText);
+        if (!text)
+            continue;
+        const lines = rawText
+            .split('\n')
+            .map((line) => normalizeText(line))
+            .filter(Boolean);
+        const name = lines.find((line) => !looksLikeMetadata(line));
+        if (!name)
+            continue;
+        results.push({
+            name,
+            members: matchMetric(text, MEMBER_PATTERNS),
+            followers: matchMetric(text, FOLLOWER_PATTERNS),
+            mode: PRIVATE_PATTERNS.some((pattern) => pattern.test(text)) ? 'private' : 'public',
+        });
+    }
+    return results;
+}
+export function isEmptyListsState(text) {
+    const normalized = normalizeText(text);
+    return EMPTY_STATE_PATTERNS.some((pattern) => pattern.test(normalized));
+}

package/clis/twitter/lists.d.ts

@@ -0,0 +1,5 @@
+import { Argument, Column } from '@jackwener/opencli/types';
+declare const args: Argument[];
+declare const columns: Column[];
+export { args, columns };
+export default {};

package/clis/twitter/lists.js

@@ -0,0 +1,62 @@
+import { AuthRequiredError, SelectorError } from '@jackwener/opencli/errors';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { isEmptyListsState, parseListCards } from './lists-parser.js';
+
+cli({
+    site: 'twitter',
+    name: 'lists',
+    description: 'Get Twitter/X lists for a user',
+    domain: 'x.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: 'user', positional: true, type: 'string', required: false },
+        { name: 'limit', type: 'int', default: 50 },
+    ],
+    columns: ['name', 'members', 'followers', 'mode'],
+    func: async (page, kwargs) => {
+        let targetUser = kwargs.user;
+        if (!targetUser) {
+            await page.goto('https://x.com/home');
+            await page.wait({ selector: '[data-testid="primaryColumn"]' });
+            const href = await page.evaluate(`() => {
+            const link = document.querySelector('a[data-testid="AppTabBar_Profile_Link"]');
+            return link ? link.getAttribute('href') : null;
+        }`);
+            if (!href) {
+                throw new AuthRequiredError('x.com', 'Could not find logged-in user profile link. Are you logged in?');
+            }
+            targetUser = href.replace('/', '');
+        }
+        await page.goto(`https://x.com/${targetUser}/lists`);
+        await page.wait(3);
+        const pageData = await page.evaluate(`() => {
+            const cards = [];
+            const seen = new Set();
+            for (const anchor of Array.from(document.querySelectorAll('a[href*="/i/lists/"]'))) {
+                const href = anchor.getAttribute('href') || '';
+                if (!/\\/i\\/lists\\/\\d+/.test(href) || seen.has(href)) continue;
+                seen.add(href);
+                const container = anchor.closest('[data-testid="cellInnerDiv"]') || anchor;
+                const text = (container.innerText || anchor.innerText || '').trim();
+                if (!text) continue;
+                cards.push({ href, text });
+            }
+            return {
+                cards,
+                pageText: document.body.innerText || '',
+            };
+        }`);
+        if (!pageData?.pageText) {
+            throw new SelectorError('Twitter lists', 'Empty page text');
+        }
+        const results = parseListCards(pageData.cards);
+        if (results.length === 0) {
+            if (isEmptyListsState(pageData.pageText)) {
+                return [];
+            }
+            throw new SelectorError('Twitter lists', `Could not parse list data`);
+        }
+        return results.slice(0, kwargs.limit);
+    }
+});

package/clis/twitter/lists.test.js

@@ -0,0 +1,50 @@
+import { describe, expect, it } from 'vitest';
+import { isEmptyListsState, parseListCards } from './lists-parser.js';
+
+describe('twitter lists parser', () => {
+    it('parses english list cards without relying on page locale', () => {
+        const result = parseListCards([
+            {
+                href: '/i/lists/123',
+                text: `AI Researchers
+@jack
+124 Members 3.4K Followers
+Private`,
+            },
+        ]);
+        expect(result).toEqual([
+            {
+                name: 'AI Researchers',
+                members: '124',
+                followers: '3.4K',
+                mode: 'private',
+            },
+        ]);
+    });
+
+    it('parses chinese list cards without scanning document.body.innerText', () => {
+        const result = parseListCards([
+            {
+                href: '/i/lists/456',
+                text: `AI观察
+@jack
+321 位成员 8.8K 位关注者
+锁定列表`,
+            },
+        ]);
+        expect(result).toEqual([
+            {
+                name: 'AI观察',
+                members: '321',
+                followers: '8.8K',
+                mode: 'private',
+            },
+        ]);
+    });
+
+    it('detects empty state text in english and chinese', () => {
+        expect(isEmptyListsState(`@jack hasn't created any Lists yet`)).toBe(true);
+        expect(isEmptyListsState('这个账号还没有创建任何列表')).toBe(true);
+        expect(isEmptyListsState('AI Researchers 124 Members')).toBe(false);
+    });
+});

package/{dist/clis → clis}/weibo/feed.js

@@ -1,20 +1,32 @@
 /**
- * Weibo feed — home timeline from followed users.
+ * Weibo feed — for-you or following timeline.
  */
 import { cli, Strategy } from '@jackwener/opencli/registry';
 import { getSelfUid } from './utils.js';
+const TIMELINE_ENDPOINTS = {
+    'for-you': 'unreadfriendstimeline',
+    following: 'friendstimeline',
+};
 cli({
     site: 'weibo',
     name: 'feed',
-    description: 'Weibo home timeline (posts from followed users)',
+    description: 'Fetch Weibo timeline (for-you or following)',
     domain: 'weibo.com',
     strategy: Strategy.COOKIE,
     args: [
+        {
+            name: 'type',
+            default: 'for-you',
+            choices: ['for-you', 'following'],
+            help: 'Timeline type: for-you (algorithmic) or following (chronological)',
+        },
         { name: 'limit', type: 'int', default: 15, help: 'Number of posts (max 50)' },
     ],
     columns: ['author', 'text', 'reposts', 'comments', 'likes', 'time', 'url'],
     func: async (page, kwargs) => {
         const count = Math.min(kwargs.limit || 15, 50);
+        const timelineType = kwargs.type === 'following' ? 'following' : 'for-you';
+        const endpoint = TIMELINE_ENDPOINTS[timelineType];
         await page.goto('https://weibo.com');
         await page.wait(2);
         const uid = await getSelfUid(page);
@@ -22,13 +34,14 @@ cli({
       (async () => {
         const uid = ${JSON.stringify(uid)};
         const count = ${count};
+        const endpoint = ${JSON.stringify(endpoint)};
         const listId = '10001' + uid;
         const strip = (html) => (html || '').replace(/<[^>]+>/g, '').replace(/&nbsp;/g, ' ').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&amp;/g, '&').trim();
 
-        const resp = await fetch('/ajax/feed/unreadfriendstimeline?list_id=' + listId + '&refresh=4&since_id=0&count=' + count, {credentials: 'include'});
-        if (!resp.ok) return {error: 'HTTP ' + resp.status};
+        const resp = await fetch('/ajax/feed/' + endpoint + '?list_id=' + listId + '&refresh=4&since_id=0&count=' + count, { credentials: 'include' });
+        if (!resp.ok) return { error: 'HTTP ' + resp.status };
         const data = await resp.json();
-        if (!data.ok) return {error: 'API error: ' + (data.msg || 'unknown')};
+        if (!data.ok) return { error: 'API error: ' + (data.msg || 'unknown') };
 
         return (data.statuses || []).slice(0, count).map(s => {
           const u = s.user || {};

package/clis/xueqiu/earnings-date.js

@@ -0,0 +1,44 @@
+import { cli } from '@jackwener/opencli/registry';
+import { EmptyResultError } from '@jackwener/opencli/errors';
+import { fetchXueqiuJson } from './utils.js';
+cli({
+    site: 'xueqiu',
+    name: 'earnings-date',
+    description: '获取股票预计财报发布日期（公司大事）',
+    domain: 'xueqiu.com',
+    browser: true,
+    args: [
+        {
+            name: 'symbol',
+            required: true,
+            positional: true,
+            help: '股票代码，如 SH600519、SZ000858、00700',
+        },
+        { name: 'next', type: 'bool', default: false, help: '仅返回最近一次未发布的财报日期' },
+        { name: 'limit', type: 'int', default: 10, help: '返回数量，默认 10' },
+    ],
+    columns: ['date', 'report', 'status'],
+    func: async (page, kwargs) => {
+        await page.goto('https://xueqiu.com');
+        const symbol = String(kwargs.symbol).toUpperCase();
+        const url = `https://stock.xueqiu.com/v5/stock/screener/event/list.json?symbol=${encodeURIComponent(symbol)}&page=1&size=100`;
+        const d = await fetchXueqiuJson(page, url);
+        if (!d.data?.items)
+            throw new EmptyResultError('xueqiu/earnings-date', '请确认股票代码是否正确: ' + symbol);
+        // subtype 2 = 预计财报发布
+        const now = Date.now();
+        let results = d.data.items
+            .filter((item) => item.subtype === 2)
+            .map((item) => {
+            const ts = item.timestamp;
+            const dateStr = ts ? new Date(ts).toISOString().split('T')[0] : null;
+            const isFuture = ts && ts > now;
+            return { date: dateStr, report: item.message, status: isFuture ? '⏳ 未发布' : '✅ 已发布', _ts: ts, _future: isFuture };
+        });
+        if (kwargs.next) {
+            const future = results.filter((r) => r._future).sort((a, b) => a._ts - b._ts);
+            results = future.length ? [future[0]] : [];
+        }
+        return results.slice(0, kwargs.limit).map(({ date, report, status }) => ({ date, report, status }));
+    },
+});

package/clis/xueqiu/feed.js

@@ -0,0 +1,38 @@
+import { cli } from '@jackwener/opencli/registry';
+import { fetchXueqiuJson } from './utils.js';
+function strip(html) {
+    return (html || '')
+        .replace(/<[^>]+>/g, '')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .trim();
+}
+cli({
+    site: 'xueqiu',
+    name: 'feed',
+    description: '获取雪球首页时间线（关注用户的动态）',
+    domain: 'xueqiu.com',
+    browser: true,
+    args: [
+        { name: 'page', type: 'int', default: 1, help: '页码，默认 1' },
+        { name: 'limit', type: 'int', default: 20, help: '每页数量，默认 20' },
+    ],
+    columns: ['author', 'text', 'likes', 'replies', 'url'],
+    func: async (page, kwargs) => {
+        await page.goto('https://xueqiu.com');
+        const url = `https://xueqiu.com/v4/statuses/home_timeline.json?page=${kwargs.page}&count=${kwargs.limit}`;
+        const d = await fetchXueqiuJson(page, url);
+        return (d.home_timeline || d.list || []).slice(0, kwargs.limit).map((item) => {
+            const user = item.user || {};
+            return {
+                author: user.screen_name,
+                text: strip(item.description).substring(0, 200),
+                likes: item.fav_count,
+                replies: item.reply_count,
+                url: 'https://xueqiu.com/' + user.id + '/' + item.id,
+            };
+        });
+    },
+});

package/clis/xueqiu/groups.js

@@ -0,0 +1,22 @@
+import { cli } from '@jackwener/opencli/registry';
+import { AuthRequiredError } from '@jackwener/opencli/errors';
+import { fetchXueqiuJson } from './utils.js';
+cli({
+    site: 'xueqiu',
+    name: 'groups',
+    description: '获取雪球自选股分组列表（含模拟组合）',
+    domain: 'xueqiu.com',
+    browser: true,
+    columns: ['pid', 'name', 'count'],
+    func: async (page, _kwargs) => {
+        await page.goto('https://xueqiu.com');
+        const d = await fetchXueqiuJson(page, 'https://stock.xueqiu.com/v5/stock/portfolio/list.json?category=1&size=20');
+        if (!d.data?.stocks)
+            throw new AuthRequiredError('xueqiu.com');
+        return (d.data.stocks || []).map((g) => ({
+            pid: String(g.id),
+            name: g.name,
+            count: g.symbol_count || 0,
+        }));
+    },
+});

package/clis/xueqiu/hot-stock.js

@@ -0,0 +1,31 @@
+import { cli } from '@jackwener/opencli/registry';
+import { AuthRequiredError } from '@jackwener/opencli/errors';
+import { fetchXueqiuJson } from './utils.js';
+cli({
+    site: 'xueqiu',
+    name: 'hot-stock',
+    description: '获取雪球热门股票榜',
+    domain: 'xueqiu.com',
+    browser: true,
+    args: [
+        { name: 'limit', type: 'int', default: 20, help: '返回数量，默认 20，最大 50' },
+        { name: 'type', default: '10', help: '榜单类型 10=人气榜(默认) 12=关注榜' },
+    ],
+    columns: ['rank', 'symbol', 'name', 'price', 'changePercent', 'heat'],
+    func: async (page, kwargs) => {
+        await page.goto('https://xueqiu.com');
+        const url = `https://stock.xueqiu.com/v5/stock/hot_stock/list.json?size=${kwargs.limit}&type=${kwargs.type}`;
+        const d = await fetchXueqiuJson(page, url);
+        if (!d.data?.items)
+            throw new AuthRequiredError('xueqiu.com');
+        return (d.data.items || []).map((s, i) => ({
+            rank: i + 1,
+            symbol: s.symbol,
+            name: s.name,
+            price: s.current,
+            changePercent: s.percent != null ? s.percent.toFixed(2) + '%' : null,
+            heat: s.value,
+            url: 'https://xueqiu.com/S/' + s.symbol,
+        }));
+    },
+});

package/clis/xueqiu/hot.js

@@ -0,0 +1,36 @@
+import { cli } from '@jackwener/opencli/registry';
+import { fetchXueqiuJson } from './utils.js';
+function strip(html) {
+    return (html || '')
+        .replace(/<[^>]+>/g, '')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .trim();
+}
+cli({
+    site: 'xueqiu',
+    name: 'hot',
+    description: '获取雪球热门动态',
+    domain: 'xueqiu.com',
+    browser: true,
+    args: [
+        { name: 'limit', type: 'int', default: 20, help: '返回数量，默认 20，最大 50' },
+    ],
+    columns: ['rank', 'author', 'text', 'likes', 'url'],
+    func: async (page, kwargs) => {
+        await page.goto('https://xueqiu.com');
+        const d = await fetchXueqiuJson(page, 'https://xueqiu.com/statuses/hot/listV3.json?source=hot&page=1');
+        return (d.list || []).slice(0, kwargs.limit).map((item, i) => {
+            const user = item.user || {};
+            return {
+                rank: i + 1,
+                author: user.screen_name,
+                text: strip(item.description).substring(0, 200),
+                likes: item.fav_count,
+                url: 'https://xueqiu.com/' + user.id + '/' + item.id,
+            };
+        });
+    },
+});

package/clis/xueqiu/kline.js

@@ -0,0 +1,43 @@
+import { cli } from '@jackwener/opencli/registry';
+import { EmptyResultError } from '@jackwener/opencli/errors';
+import { fetchXueqiuJson } from './utils.js';
+cli({
+    site: 'xueqiu',
+    name: 'kline',
+    description: '获取雪球股票K线（历史行情）数据',
+    domain: 'xueqiu.com',
+    browser: true,
+    args: [
+        {
+            name: 'symbol',
+            required: true,
+            positional: true,
+            help: '股票代码，如 SH600519、SZ000858、AAPL',
+        },
+        { name: 'days', type: 'int', default: 14, help: '回溯天数（默认14天）' },
+    ],
+    columns: ['date', 'open', 'high', 'low', 'close', 'volume'],
+    func: async (page, kwargs) => {
+        await page.goto('https://xueqiu.com');
+        const symbol = String(kwargs.symbol).toUpperCase();
+        const days = kwargs.days;
+        const beginTs = Date.now();
+        const url = `https://stock.xueqiu.com/v5/stock/chart/kline.json?symbol=${encodeURIComponent(symbol)}&begin=${beginTs}&period=day&type=before&count=-${days}`;
+        const d = await fetchXueqiuJson(page, url);
+        if (!d.data?.item?.length)
+            throw new EmptyResultError('xueqiu/kline', '请确认股票代码是否正确: ' + symbol);
+        const columns = d.data.column || [];
+        const colIdx = {};
+        columns.forEach((name, i) => { colIdx[name] = i; });
+        return d.data.item.map(row => ({
+            date: colIdx.timestamp != null ? new Date(row[colIdx.timestamp]).toISOString().split('T')[0] : null,
+            open: row[colIdx.open] ?? null,
+            high: row[colIdx.high] ?? null,
+            low: row[colIdx.low] ?? null,
+            close: row[colIdx.close] ?? null,
+            volume: row[colIdx.volume] ?? null,
+            percent: row[colIdx.percent] ?? null,
+            symbol,
+        }));
+    },
+});

package/clis/xueqiu/search.js

@@ -0,0 +1,36 @@
+import { cli } from '@jackwener/opencli/registry';
+import { fetchXueqiuJson } from './utils.js';
+cli({
+    site: 'xueqiu',
+    name: 'search',
+    description: '搜索雪球股票（代码或名称）',
+    domain: 'xueqiu.com',
+    browser: true,
+    args: [
+        { name: 'query', required: true, positional: true, help: '搜索关键词，如 茅台、AAPL、腾讯' },
+        { name: 'limit', type: 'int', default: 10, help: '返回数量，默认 10' },
+    ],
+    columns: ['symbol', 'name', 'exchange', 'price', 'changePercent', 'url'],
+    func: async (page, kwargs) => {
+        await page.goto('https://xueqiu.com');
+        const url = `https://xueqiu.com/stock/search.json?code=${encodeURIComponent(String(kwargs.query))}&size=${kwargs.limit}`;
+        const d = await fetchXueqiuJson(page, url);
+        return (d.stocks || []).slice(0, kwargs.limit).map((s) => {
+            let symbol = '';
+            if (s.exchange === 'SH' || s.exchange === 'SZ' || s.exchange === 'BJ') {
+                symbol = s.code.startsWith(s.exchange) ? s.code : s.exchange + s.code;
+            }
+            else {
+                symbol = s.code;
+            }
+            return {
+                symbol,
+                name: s.name,
+                exchange: s.exchange,
+                price: s.current,
+                changePercent: s.percentage != null ? s.percentage.toFixed(2) + '%' : null,
+                url: 'https://xueqiu.com/S/' + symbol,
+            };
+        });
+    },
+});

package/clis/xueqiu/stock.js

@@ -0,0 +1,64 @@
+import { cli } from '@jackwener/opencli/registry';
+import { EmptyResultError } from '@jackwener/opencli/errors';
+import { fetchXueqiuJson } from './utils.js';
+function fmtAmount(v) {
+    if (v == null)
+        return null;
+    if (Math.abs(v) >= 1e12)
+        return (v / 1e12).toFixed(2) + '万亿';
+    if (Math.abs(v) >= 1e8)
+        return (v / 1e8).toFixed(2) + '亿';
+    if (Math.abs(v) >= 1e4)
+        return (v / 1e4).toFixed(2) + '万';
+    return String(v);
+}
+cli({
+    site: 'xueqiu',
+    name: 'stock',
+    description: '获取雪球股票实时行情',
+    domain: 'xueqiu.com',
+    browser: true,
+    args: [
+        {
+            name: 'symbol',
+            required: true,
+            positional: true,
+            help: '股票代码，如 SH600519、SZ000858、AAPL、00700',
+        },
+    ],
+    columns: ['name', 'symbol', 'price', 'changePercent', 'marketCap'],
+    func: async (page, kwargs) => {
+        await page.goto('https://xueqiu.com');
+        const symbol = String(kwargs.symbol).toUpperCase();
+        const url = `https://stock.xueqiu.com/v5/stock/batch/quote.json?symbol=${encodeURIComponent(symbol)}`;
+        const d = await fetchXueqiuJson(page, url);
+        if (!d.data?.items?.length)
+            throw new EmptyResultError('xueqiu/stock', '请确认股票代码是否正确: ' + symbol);
+        const item = d.data.items[0];
+        const q = item.quote || {};
+        const m = item.market || {};
+        return [{
+                name: q.name,
+                symbol: q.symbol,
+                exchange: q.exchange,
+                currency: q.currency,
+                price: q.current,
+                change: q.chg,
+                changePercent: q.percent != null ? q.percent.toFixed(2) + '%' : null,
+                open: q.open,
+                high: q.high,
+                low: q.low,
+                prevClose: q.last_close,
+                amplitude: q.amplitude != null ? q.amplitude.toFixed(2) + '%' : null,
+                volume: q.volume,
+                amount: fmtAmount(q.amount),
+                turnover_rate: q.turnover_rate != null ? q.turnover_rate.toFixed(2) + '%' : null,
+                marketCap: fmtAmount(q.market_capital),
+                floatMarketCap: fmtAmount(q.float_market_capital),
+                ytdPercent: q.current_year_percent != null ? q.current_year_percent.toFixed(2) + '%' : null,
+                market_status: m.status || null,
+                time: q.timestamp ? new Date(q.timestamp).toISOString() : null,
+                url: 'https://xueqiu.com/S/' + q.symbol,
+            }];
+    },
+});

package/clis/xueqiu/utils.js

@@ -0,0 +1,29 @@
+import { AuthRequiredError, CommandExecutionError } from '@jackwener/opencli/errors';
+/**
+ * Fetch a xueqiu JSON API from inside the browser context (credentials included).
+ * Page must already be navigated to xueqiu.com before calling this function.
+ * Throws CliError on HTTP errors; otherwise returns the parsed JSON.
+ */
+export async function fetchXueqiuJson(page, url) {
+    const result = await page.evaluate(`(async () => {
+    const res = await fetch(${JSON.stringify(url)}, { credentials: 'include' });
+    if (!res.ok) return { __xqErr: res.status };
+    try {
+      return await res.json();
+    } catch {
+      return { __xqErr: 'parse' };
+    }
+  })()`);
+    const r = result;
+    if (r?.__xqErr !== undefined) {
+        const code = r.__xqErr;
+        if (code === 401 || code === 403) {
+            throw new AuthRequiredError('xueqiu.com', '未登录或登录已过期');
+        }
+        if (code === 'parse') {
+            throw new CommandExecutionError('响应不是有效 JSON', '可能触发了风控，请检查登录状态或稍后重试');
+        }
+        throw new CommandExecutionError(`HTTP ${code}`, '请检查网络连接或登录状态');
+    }
+    return result;
+}

package/clis/xueqiu/watchlist.js

@@ -0,0 +1,36 @@
+import { cli } from '@jackwener/opencli/registry';
+import { AuthRequiredError } from '@jackwener/opencli/errors';
+import { fetchXueqiuJson } from './utils.js';
+cli({
+    site: 'xueqiu',
+    name: 'watchlist',
+    description: '获取雪球自选股/模拟组合股票列表',
+    domain: 'xueqiu.com',
+    browser: true,
+    args: [
+        {
+            name: 'pid',
+            default: '-1',
+            help: '分组ID：-1=全部(默认) -4=模拟 -5=沪深 -6=美股 -7=港股 -10=实盘 0=持仓（通过 xueqiu groups 获取）',
+        },
+        { name: 'limit', type: 'int', default: 100, help: '默认 100' },
+    ],
+    columns: ['symbol', 'name', 'price', 'changePercent'],
+    func: async (page, kwargs) => {
+        await page.goto('https://xueqiu.com');
+        const pid = String(kwargs.pid || '-1');
+        const url = `https://stock.xueqiu.com/v5/stock/portfolio/stock/list.json?size=100&category=1&pid=${encodeURIComponent(pid)}`;
+        const d = await fetchXueqiuJson(page, url);
+        if (!d.data?.stocks)
+            throw new AuthRequiredError('xueqiu.com');
+        return (d.data.stocks || []).slice(0, kwargs.limit).map((s) => ({
+            symbol: s.symbol,
+            name: s.name,
+            price: s.current,
+            change: s.chg,
+            changePercent: s.percent != null ? s.percent.toFixed(2) + '%' : null,
+            volume: s.volume,
+            url: 'https://xueqiu.com/S/' + s.symbol,
+        }));
+    },
+});