@huyuan-ai/cli 1.0.0 → 1.0.2

package/vendor/opencli/dist/clis/xiaohongshu/creator-notes.js

@@ -0,0 +1,227 @@
+/**
+ * Xiaohongshu Creator Note List — per-note metrics from the creator backend.
+ *
+ * In CDP mode we capture the real creator analytics API response so the list
+ * includes stable note ids and detail-page URLs. If that capture is unavailable,
+ * we fall back to the older interceptor and DOM parsing paths.
+ *
+ * Requires: logged into creator.xiaohongshu.com in Chrome.
+ */
+import { cli, Strategy } from '../../registry.js';
+const DATE_LINE_RE = /^发布于 (\d{4}年\d{2}月\d{2}日 \d{2}:\d{2})$/;
+const METRIC_LINE_RE = /^\d+$/;
+const VISIBILITY_LINE_RE = /可见$/;
+const NOTE_ANALYZE_API_PATH = '/api/galaxy/creator/datacenter/note/analyze/list';
+const NOTE_DETAIL_PAGE_URL = 'https://creator.xiaohongshu.com/statistics/note-detail';
+const NOTE_ID_HTML_RE = /"noteId":"([0-9a-f]{24})"/g;
+function buildNoteDetailUrl(noteId) {
+    return noteId ? `${NOTE_DETAIL_PAGE_URL}?noteId=${encodeURIComponent(noteId)}` : '';
+}
+function formatPostTime(ts) {
+    if (!ts)
+        return '';
+    // XHS API timestamps are Beijing time (UTC+8)
+    const date = new Date(ts + 8 * 3600_000);
+    const pad = (value) => String(value).padStart(2, '0');
+    return `${date.getUTCFullYear()}年${pad(date.getUTCMonth() + 1)}月${pad(date.getUTCDate())}日 ${pad(date.getUTCHours())}:${pad(date.getUTCMinutes())}`;
+}
+export function parseCreatorNotesText(bodyText) {
+    const lines = bodyText
+        .split('\n')
+        .map((line) => line.trim())
+        .filter(Boolean);
+    const results = [];
+    const seen = new Set();
+    for (let i = 0; i < lines.length; i++) {
+        const dateMatch = lines[i].match(DATE_LINE_RE);
+        if (!dateMatch)
+            continue;
+        let titleIndex = i - 1;
+        while (titleIndex >= 0 && VISIBILITY_LINE_RE.test(lines[titleIndex]))
+            titleIndex--;
+        if (titleIndex < 0)
+            continue;
+        const title = lines[titleIndex];
+        const metrics = [];
+        let cursor = i + 1;
+        while (cursor < lines.length && METRIC_LINE_RE.test(lines[cursor]) && metrics.length < 5) {
+            metrics.push(parseInt(lines[cursor], 10));
+            cursor++;
+        }
+        if (metrics.length < 4)
+            continue;
+        const key = `${title}@@${dateMatch[1]}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        results.push({
+            id: '',
+            title,
+            date: dateMatch[1],
+            views: metrics[0] ?? 0,
+            likes: metrics[2] ?? 0,
+            collects: metrics[3] ?? 0,
+            comments: metrics[1] ?? 0,
+            url: '',
+        });
+        i = cursor - 1;
+    }
+    return results;
+}
+export function parseCreatorNoteIdsFromHtml(bodyHtml) {
+    const ids = [];
+    const seen = new Set();
+    for (const match of bodyHtml.matchAll(NOTE_ID_HTML_RE)) {
+        const id = match[1];
+        if (!id || seen.has(id))
+            continue;
+        seen.add(id);
+        ids.push(id);
+    }
+    return ids;
+}
+function mapDomCards(cards) {
+    return cards.map((card) => ({
+        id: card.id,
+        title: card.title,
+        date: card.date,
+        views: card.metrics[0] ?? 0,
+        likes: card.metrics[2] ?? 0,
+        collects: card.metrics[3] ?? 0,
+        comments: card.metrics[1] ?? 0,
+        url: buildNoteDetailUrl(card.id),
+    }));
+}
+function mapAnalyzeItems(items) {
+    return (items ?? []).map((item) => ({
+        id: item.id ?? '',
+        title: item.title ?? '',
+        date: formatPostTime(item.post_time),
+        views: item.read_count ?? 0,
+        likes: item.like_count ?? 0,
+        collects: item.fav_count ?? 0,
+        comments: item.comment_count ?? 0,
+        url: buildNoteDetailUrl(item.id),
+    }));
+}
+async function fetchCreatorNotesByApi(page, limit) {
+    const pageSize = Math.min(Math.max(limit, 10), 20);
+    const maxPages = Math.max(1, Math.ceil(limit / pageSize));
+    const notes = [];
+    await page.goto(`https://creator.xiaohongshu.com/statistics/data-analysis?type=0&page_size=${pageSize}&page_num=1`);
+    for (let pageNum = 1; pageNum <= maxPages && notes.length < limit; pageNum++) {
+        const apiPath = `${NOTE_ANALYZE_API_PATH}?type=0&page_size=${pageSize}&page_num=${pageNum}`;
+        const fetched = await page.evaluate(`
+      async () => {
+        try {
+          const resp = await fetch(${JSON.stringify(apiPath)}, { credentials: 'include' });
+          if (!resp.ok) return { error: 'HTTP ' + resp.status };
+          return await resp.json();
+        } catch (e) {
+          return { error: e?.message ?? String(e) };
+        }
+      }
+    `);
+        let items = fetched?.data?.note_infos ?? [];
+        if (!items.length) {
+            await page.installInterceptor(NOTE_ANALYZE_API_PATH);
+            await page.evaluate(`
+        async () => {
+          try {
+            await fetch(${JSON.stringify(apiPath)}, { credentials: 'include' });
+          } catch {}
+          return true;
+        }
+      `);
+            await page.wait(1);
+            const intercepted = await page.getInterceptedRequests();
+            const data = intercepted.find((entry) => Array.isArray(entry?.data?.note_infos));
+            items = data?.data?.note_infos ?? [];
+        }
+        if (!items.length)
+            break;
+        notes.push(...mapAnalyzeItems(items));
+        if (items.length < pageSize)
+            break;
+    }
+    return notes.slice(0, limit);
+}
+export async function fetchCreatorNotes(page, limit) {
+    let notes = await fetchCreatorNotesByApi(page, limit);
+    if (notes.length === 0) {
+        await page.goto('https://creator.xiaohongshu.com/new/note-manager');
+        const maxPageDowns = Math.max(0, Math.ceil(limit / 10) + 1);
+        for (let i = 0; i <= maxPageDowns; i++) {
+            const domCards = await page.evaluate(`() => {
+        const noteIdRe = /"noteId":"([0-9a-f]{24})"/;
+        return Array.from(document.querySelectorAll('div.note[data-impression], div.note')).map((card) => {
+          const impression = card.getAttribute('data-impression') || '';
+          const id = impression.match(noteIdRe)?.[1] || '';
+          const title = (card.querySelector('.title, .raw')?.innerText || '').trim();
+          const dateText = (card.querySelector('.time_status, .time')?.innerText || '').trim();
+          const date = dateText.replace(/^发布于\\s*/, '');
+          const metrics = Array.from(card.querySelectorAll('.icon_list .icon'))
+            .map((el) => parseInt((el.innerText || '').trim(), 10))
+            .filter((value) => Number.isFinite(value));
+          return { id, title, date, metrics };
+        });
+      }`);
+            const parsedDomNotes = mapDomCards(Array.isArray(domCards) ? domCards : []).filter((note) => note.title && note.date);
+            if (parsedDomNotes.length > 0) {
+                notes = parsedDomNotes;
+            }
+            if (notes.length >= limit || (notes.length > 0 && i === 0))
+                break;
+            const body = await page.evaluate('() => ({ text: document.body.innerText, html: document.body.innerHTML })');
+            const bodyText = typeof body?.text === 'string' ? body.text : '';
+            const bodyHtml = typeof body?.html === 'string' ? body.html : '';
+            const parsedNotes = parseCreatorNotesText(bodyText);
+            const noteIds = parseCreatorNoteIdsFromHtml(bodyHtml);
+            notes = parsedNotes.map((note, index) => {
+                const id = noteIds[index] ?? '';
+                return {
+                    ...note,
+                    id,
+                    url: buildNoteDetailUrl(id),
+                };
+            });
+            if (notes.length >= limit || i === maxPageDowns)
+                break;
+            await page.pressKey('PageDown');
+            await page.wait(1);
+        }
+    }
+    return notes.slice(0, limit);
+}
+cli({
+    site: 'xiaohongshu',
+    name: 'creator-notes',
+    description: '小红书创作者笔记列表 + 每篇数据 (标题/日期/观看/点赞/收藏/评论)',
+    domain: 'creator.xiaohongshu.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: 'limit', type: 'int', default: 20, help: 'Number of notes to return' },
+    ],
+    columns: ['rank', 'id', 'title', 'date', 'views', 'likes', 'collects', 'comments', 'url'],
+    func: async (page, kwargs) => {
+        const limit = kwargs.limit || 20;
+        const notes = await fetchCreatorNotes(page, limit);
+        if (!Array.isArray(notes) || notes.length === 0) {
+            throw new Error('No notes found. Are you logged into creator.xiaohongshu.com?');
+        }
+        return notes
+            .slice(0, limit)
+            .map((n, i) => ({
+            rank: i + 1,
+            id: n.id,
+            title: n.title,
+            date: n.date,
+            views: n.views,
+            likes: n.likes,
+            collects: n.collects,
+            comments: n.comments,
+            url: n.url,
+        }));
+    },
+});

package/vendor/opencli/dist/clis/xiaohongshu/creator-notes.test.d.ts

@@ -0,0 +1 @@
+import './creator-notes.js';

package/vendor/opencli/dist/clis/xiaohongshu/creator-notes.test.js

@@ -0,0 +1,192 @@
+import { describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import { parseCreatorNoteIdsFromHtml, parseCreatorNotesText } from './creator-notes.js';
+import './creator-notes.js';
+function createPageMock(evaluateResult, interceptedRequests = []) {
+    const evaluate = Array.isArray(evaluateResult)
+        ? vi.fn()
+            .mockResolvedValueOnce(evaluateResult[0])
+            .mockResolvedValue(evaluateResult[evaluateResult.length - 1])
+        : vi.fn().mockResolvedValue(evaluateResult);
+    const getInterceptedRequests = Array.isArray(interceptedRequests)
+        ? vi.fn().mockResolvedValue(interceptedRequests)
+        : vi.fn().mockResolvedValue([]);
+    return {
+        goto: vi.fn().mockResolvedValue(undefined),
+        evaluate,
+        snapshot: vi.fn().mockResolvedValue(undefined),
+        click: vi.fn().mockResolvedValue(undefined),
+        typeText: vi.fn().mockResolvedValue(undefined),
+        pressKey: vi.fn().mockResolvedValue(undefined),
+        scrollTo: vi.fn().mockResolvedValue(undefined),
+        getFormState: vi.fn().mockResolvedValue({ forms: [], orphanFields: [] }),
+        wait: vi.fn().mockResolvedValue(undefined),
+        tabs: vi.fn().mockResolvedValue([]),
+        selectTab: vi.fn().mockResolvedValue(undefined),
+        networkRequests: vi.fn().mockResolvedValue([]),
+        consoleMessages: vi.fn().mockResolvedValue([]),
+        scroll: vi.fn().mockResolvedValue(undefined),
+        autoScroll: vi.fn().mockResolvedValue(undefined),
+        installInterceptor: vi.fn().mockResolvedValue(undefined),
+        getInterceptedRequests,
+        getCookies: vi.fn().mockResolvedValue([]),
+        screenshot: vi.fn().mockResolvedValue(''),
+        waitForCapture: vi.fn().mockResolvedValue(undefined),
+    };
+}
+describe('xiaohongshu creator-notes', () => {
+    it('parses creator note text blocks into rows', () => {
+        const bodyText = `笔记管理
+全部笔记(366)
+已发布
+测试笔记一
+发布于 2025年12月04日 19:45
+148208
+324
+2279
+465
+32
+权限设置
+取消置顶
+编辑
+删除
+仅自己可见
+测试笔记二
+发布于 2026年03月18日 12:39
+10
+0
+0
+0
+0
+权限设置`;
+        expect(parseCreatorNotesText(bodyText)).toEqual([
+            {
+                id: '',
+                title: '测试笔记一',
+                date: '2025年12月04日 19:45',
+                views: 148208,
+                likes: 2279,
+                collects: 465,
+                comments: 324,
+                url: '',
+            },
+            {
+                id: '',
+                title: '测试笔记二',
+                date: '2026年03月18日 12:39',
+                views: 10,
+                likes: 0,
+                collects: 0,
+                comments: 0,
+                url: '',
+            },
+        ]);
+    });
+    it('reads body text and returns ranked rows', async () => {
+        const cmd = getRegistry().get('xiaohongshu/creator-notes');
+        expect(cmd?.func).toBeTypeOf('function');
+        const page = createPageMock([
+            undefined,
+            {
+                text: `示例笔记
+发布于 2026年03月19日 12:00
+10
+2
+3
+4
+5
+权限设置`,
+                html: '"noteId":"aaaaaaaaaaaaaaaaaaaaaaaa"',
+            },
+        ]);
+        const result = await cmd.func(page, { limit: 1 });
+        expect(page.evaluate.mock.calls.at(-1)?.[0]).toBe('() => ({ text: document.body.innerText, html: document.body.innerHTML })');
+        expect(result).toEqual([
+            {
+                rank: 1,
+                id: 'aaaaaaaaaaaaaaaaaaaaaaaa',
+                title: '示例笔记',
+                date: '2026年03月19日 12:00',
+                views: 10,
+                likes: 3,
+                collects: 4,
+                comments: 2,
+                url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=aaaaaaaaaaaaaaaaaaaaaaaa',
+            },
+        ]);
+    });
+    it('prefers note card dom data when the analyze api is unavailable', async () => {
+        const cmd = getRegistry().get('xiaohongshu/creator-notes');
+        expect(cmd?.func).toBeTypeOf('function');
+        const page = createPageMock([
+            undefined,
+            [
+                {
+                    id: 'bbbbbbbbbbbbbbbbbbbbbbbb',
+                    title: '测试笔记一',
+                    date: '2025年12月04日 19:45',
+                    metrics: [148284, 319, 2280, 466, 33],
+                },
+            ],
+        ]);
+        const result = await cmd.func(page, { limit: 1 });
+        expect(result).toEqual([
+            {
+                rank: 1,
+                id: 'bbbbbbbbbbbbbbbbbbbbbbbb',
+                title: '测试笔记一',
+                date: '2025年12月04日 19:45',
+                views: 148284,
+                likes: 2280,
+                collects: 466,
+                comments: 319,
+                url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=bbbbbbbbbbbbbbbbbbbbbbbb',
+            },
+        ]);
+    });
+    it('prefers the creator analyze API and preserves note ids', async () => {
+        const cmd = getRegistry().get('xiaohongshu/creator-notes');
+        expect(cmd?.func).toBeTypeOf('function');
+        const page = createPageMock(undefined, [{
+                data: {
+                    note_infos: [
+                        {
+                            id: 'cccccccccccccccccccccccc',
+                            title: '示例内容复盘',
+                            post_time: new Date('2026-03-18T20:01:00+08:00').getTime(),
+                            read_count: 521,
+                            like_count: 18,
+                            fav_count: 10,
+                            comment_count: 7,
+                        },
+                    ],
+                },
+            }]);
+        const result = await cmd.func(page, { limit: 1 });
+        expect(page.installInterceptor.mock.calls[0][0]).toContain('/api/galaxy/creator/datacenter/note/analyze/list');
+        expect(result).toEqual([
+            {
+                rank: 1,
+                id: 'cccccccccccccccccccccccc',
+                title: '示例内容复盘',
+                date: '2026年03月18日 20:01',
+                views: 521,
+                likes: 18,
+                collects: 10,
+                comments: 7,
+                url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=cccccccccccccccccccccccc',
+            },
+        ]);
+    });
+    it('extracts note ids from creator note-manager html', () => {
+        const html = `
+      <div>&quot;noteId&quot;:&quot;aaaaaaaaaaaaaaaaaaaaaaaa&quot;</div>
+      <div>&quot;noteId&quot;:&quot;dddddddddddddddddddddddd&quot;</div>
+      <div>&quot;noteId&quot;:&quot;aaaaaaaaaaaaaaaaaaaaaaaa&quot;</div>
+    `;
+        expect(parseCreatorNoteIdsFromHtml(html)).toEqual([
+            'aaaaaaaaaaaaaaaaaaaaaaaa',
+            'dddddddddddddddddddddddd',
+        ]);
+    });
+});

package/vendor/opencli/dist/clis/xiaohongshu/creator-profile.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Xiaohongshu Creator Profile — creator account info and growth status.
+ *
+ * Uses the creator.xiaohongshu.com internal API (cookie auth).
+ * Returns follower/following counts, total likes+collects, and
+ * creator level growth info.
+ *
+ * Requires: logged into creator.xiaohongshu.com in Chrome.
+ */
+export {};

package/vendor/opencli/dist/clis/xiaohongshu/creator-profile.js

@@ -0,0 +1,53 @@
+/**
+ * Xiaohongshu Creator Profile — creator account info and growth status.
+ *
+ * Uses the creator.xiaohongshu.com internal API (cookie auth).
+ * Returns follower/following counts, total likes+collects, and
+ * creator level growth info.
+ *
+ * Requires: logged into creator.xiaohongshu.com in Chrome.
+ */
+import { cli, Strategy } from '../../registry.js';
+cli({
+    site: 'xiaohongshu',
+    name: 'creator-profile',
+    description: '小红书创作者账号信息 (粉丝/关注/获赞/成长等级)',
+    domain: 'creator.xiaohongshu.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [],
+    columns: ['field', 'value'],
+    func: async (page, _kwargs) => {
+        await page.goto('https://creator.xiaohongshu.com/new/home');
+        const data = await page.evaluate(`
+      async () => {
+        try {
+          const resp = await fetch('/api/galaxy/creator/home/personal_info', {
+            credentials: 'include',
+          });
+          if (!resp.ok) return { error: 'HTTP ' + resp.status };
+          return await resp.json();
+        } catch (e) {
+          return { error: e.message };
+        }
+      }
+    `);
+        if (data?.error) {
+            throw new Error(data.error + '. Are you logged into creator.xiaohongshu.com?');
+        }
+        if (!data?.data) {
+            throw new Error('Unexpected response structure');
+        }
+        const d = data.data;
+        const grow = d.grow_info || {};
+        return [
+            { field: 'Name', value: d.name ?? '' },
+            { field: 'Followers', value: d.fans_count ?? 0 },
+            { field: 'Following', value: d.follow_count ?? 0 },
+            { field: 'Likes & Collects', value: d.faved_count ?? 0 },
+            { field: 'Creator Level', value: grow.level ?? 0 },
+            { field: 'Level Progress', value: `${grow.fans_count ?? 0}/${grow.max_fans_count ?? 0} fans` },
+            { field: 'Bio', value: (d.personal_desc ?? '').replace(/\\n/g, ' | ') },
+        ];
+    },
+});

package/vendor/opencli/dist/clis/xiaohongshu/creator-stats.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Xiaohongshu Creator Analytics — account-level metrics overview.
+ *
+ * Uses the creator.xiaohongshu.com internal API (cookie auth).
+ * Returns 7-day and 30-day aggregate stats: views, likes, collects,
+ * comments, shares, new followers, and daily trend data.
+ *
+ * Requires: logged into creator.xiaohongshu.com in Chrome.
+ */
+export {};

package/vendor/opencli/dist/clis/xiaohongshu/creator-stats.js

@@ -0,0 +1,73 @@
+/**
+ * Xiaohongshu Creator Analytics — account-level metrics overview.
+ *
+ * Uses the creator.xiaohongshu.com internal API (cookie auth).
+ * Returns 7-day and 30-day aggregate stats: views, likes, collects,
+ * comments, shares, new followers, and daily trend data.
+ *
+ * Requires: logged into creator.xiaohongshu.com in Chrome.
+ */
+import { cli, Strategy } from '../../registry.js';
+cli({
+    site: 'xiaohongshu',
+    name: 'creator-stats',
+    description: '小红书创作者数据总览 (观看/点赞/收藏/评论/分享/涨粉，含每日趋势)',
+    domain: 'creator.xiaohongshu.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        {
+            name: 'period',
+            type: 'string',
+            default: 'seven',
+            help: 'Stats period: seven or thirty',
+            choices: ['seven', 'thirty'],
+        },
+    ],
+    columns: ['metric', 'total', 'trend'],
+    func: async (page, kwargs) => {
+        const period = kwargs.period || 'seven';
+        // Navigate to creator center for cookie context
+        await page.goto('https://creator.xiaohongshu.com/new/home');
+        const data = await page.evaluate(`
+      async () => {
+        try {
+          const resp = await fetch('/api/galaxy/creator/data/note_detail_new', {
+            credentials: 'include',
+          });
+          if (!resp.ok) return { error: 'HTTP ' + resp.status };
+          return await resp.json();
+        } catch (e) {
+          return { error: e.message };
+        }
+      }
+    `);
+        if (data?.error) {
+            throw new Error(data.error + '. Are you logged into creator.xiaohongshu.com?');
+        }
+        if (!data?.data) {
+            throw new Error('Unexpected response structure');
+        }
+        const stats = data.data[period];
+        if (!stats) {
+            throw new Error(`No data for period "${period}". Available: ${Object.keys(data.data).join(', ')}`);
+        }
+        // Format daily trend as sparkline-like summary
+        const formatTrend = (list) => {
+            if (!list || !list.length)
+                return '-';
+            return list.map((d) => d.count).join(' → ');
+        };
+        return [
+            { metric: '观看数 (views)', total: stats.view_count ?? 0, trend: formatTrend(stats.view_list) },
+            { metric: '平均观看时长 (avg view time ms)', total: stats.view_time_avg ?? 0, trend: formatTrend(stats.view_time_list) },
+            { metric: '主页访问 (home views)', total: stats.home_view_count ?? 0, trend: formatTrend(stats.home_view_list) },
+            { metric: '点赞数 (likes)', total: stats.like_count ?? 0, trend: formatTrend(stats.like_list) },
+            { metric: '收藏数 (collects)', total: stats.collect_count ?? 0, trend: formatTrend(stats.collect_list) },
+            { metric: '评论数 (comments)', total: stats.comment_count ?? 0, trend: formatTrend(stats.comment_list) },
+            { metric: '弹幕数 (danmaku)', total: stats.danmaku_count ?? 0, trend: '-' },
+            { metric: '分享数 (shares)', total: stats.share_count ?? 0, trend: formatTrend(stats.share_list) },
+            { metric: '涨粉数 (new followers)', total: stats.rise_fans_count ?? 0, trend: formatTrend(stats.rise_fans_list) },
+        ];
+    },
+});

package/vendor/opencli/dist/clis/xiaohongshu/download.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Xiaohongshu download — download images and videos from a note.
+ *
+ * Usage:
+ *   opencli xiaohongshu download <note-id-or-url> --output ./xhs
+ *
+ * Accepts a bare note ID, a full xiaohongshu.com URL (with xsec_token),
+ * or a short link (http://xhslink.com/...).
+ */
+export {};