@jackwener/opencli 1.0.5 → 1.1.0

package/dist/clis/xiaohongshu/creator-note-detail.js

@@ -1,88 +1,277 @@
 /**
- * Xiaohongshu Creator Note Detail — per-note analytics breakdown.
+ * Xiaohongshu Creator Note Detail — per-note analytics from the creator detail page.
  *
- * Uses the creator.xiaohongshu.com internal API (cookie auth).
- * Returns total reads, engagement, likes, collects, comments, shares
- * for a specific note, split by channel (organic vs promoted vs video).
+ * The current creator center no longer serves stable single-note metrics from the legacy
+ * `/api/galaxy/creator/data/note_detail` endpoint. The real note detail page loads data
+ * through the newer `datacenter/note/*` API family, so this command navigates to the
+ * detail page and parses the rendered metrics that are backed by those APIs.
  *
  * Requires: logged into creator.xiaohongshu.com in Chrome.
  */
 import { cli, Strategy } from '../../registry.js';
+const NOTE_DETAIL_DATETIME_RE = /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/;
+const NOTE_DETAIL_METRICS = [
+    { label: '曝光数', section: '基础数据' },
+    { label: '观看数', section: '基础数据' },
+    { label: '封面点击率', section: '基础数据' },
+    { label: '平均观看时长', section: '基础数据' },
+    { label: '涨粉数', section: '基础数据' },
+    { label: '点赞数', section: '互动数据' },
+    { label: '评论数', section: '互动数据' },
+    { label: '收藏数', section: '互动数据' },
+    { label: '分享数', section: '互动数据' },
+];
+const NOTE_DETAIL_METRIC_LABELS = new Set(NOTE_DETAIL_METRICS.map((metric) => metric.label));
+const NOTE_DETAIL_NOISE_LINES = new Set([
+    '切换笔记',
+    '笔记诊断',
+    '核心数据',
+    '观看来源',
+    '观众画像',
+    '提升建议',
+    '基础数据',
+    '互动数据',
+    '导出数据',
+    '实时',
+    '按小时',
+    '按天',
+]);
+function findNoteTitle(lines) {
+    const detailIndex = lines.indexOf('笔记数据详情');
+    if (detailIndex < 0)
+        return '';
+    for (let i = detailIndex + 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (!line || line.startsWith('#') || NOTE_DETAIL_DATETIME_RE.test(line))
+            continue;
+        if (NOTE_DETAIL_NOISE_LINES.has(line))
+            continue;
+        return line;
+    }
+    return '';
+}
+function findMetricValue(lines, startIndex) {
+    let value = '';
+    let extra = '';
+    for (let i = startIndex + 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (!line)
+            continue;
+        if (NOTE_DETAIL_METRIC_LABELS.has(line))
+            break;
+        if (NOTE_DETAIL_NOISE_LINES.has(line) || line.startsWith('数据更新至') || line.startsWith('部分数据统计中'))
+            continue;
+        if (!value) {
+            value = line;
+            continue;
+        }
+        if (!extra && line.startsWith('粉丝')) {
+            extra = line;
+            break;
+        }
+        if (line === '0' || /^\d/.test(line) || line.endsWith('%') || line.endsWith('秒')) {
+            break;
+        }
+    }
+    return { value, extra };
+}
+export function parseCreatorNoteDetailText(bodyText, noteId) {
+    const lines = bodyText
+        .split('\n')
+        .map((line) => line.trim())
+        .filter(Boolean);
+    const title = findNoteTitle(lines);
+    const publishedAt = lines.find((line) => NOTE_DETAIL_DATETIME_RE.test(line)) ?? '';
+    const rows = [
+        { section: '笔记信息', metric: 'note_id', value: noteId, extra: '' },
+        { section: '笔记信息', metric: 'title', value: title, extra: '' },
+        { section: '笔记信息', metric: 'published_at', value: publishedAt, extra: '' },
+    ];
+    for (const metric of NOTE_DETAIL_METRICS) {
+        const index = lines.indexOf(metric.label);
+        if (index < 0)
+            continue;
+        const { value, extra } = findMetricValue(lines, index);
+        rows.push({
+            section: metric.section,
+            metric: metric.label,
+            value,
+            extra,
+        });
+    }
+    return rows;
+}
+function toPercentString(value) {
+    return value == null ? '' : `${value}%`;
+}
+function appendAudienceSourceRows(rows, payload) {
+    const sourceItems = payload?.audienceSource?.source ?? [];
+    for (const item of sourceItems) {
+        if (!item.title)
+            continue;
+        const extras = [];
+        if (item.info?.imp_count != null)
+            extras.push(`曝光 ${item.info.imp_count}`);
+        if (item.info?.view_count != null)
+            extras.push(`观看 ${item.info.view_count}`);
+        if (item.info?.interaction_count != null)
+            extras.push(`互动 ${item.info.interaction_count}`);
+        rows.push({
+            section: '观看来源',
+            metric: item.title,
+            value: toPercentString(item.value_with_double),
+            extra: extras.join(' · '),
+        });
+    }
+    return rows;
+}
+function appendAudiencePortraitGroup(rows, groupLabel, items) {
+    for (const item of items ?? []) {
+        if (!item.title)
+            continue;
+        rows.push({
+            section: '观众画像',
+            metric: `${groupLabel}/${item.title}`,
+            value: toPercentString(item.value),
+            extra: '',
+        });
+    }
+    return rows;
+}
+export function appendAudienceRows(rows, payload) {
+    appendAudienceSourceRows(rows, payload);
+    appendAudiencePortraitGroup(rows, '性别', payload?.audienceSourceDetail?.gender);
+    appendAudiencePortraitGroup(rows, '年龄', payload?.audienceSourceDetail?.age);
+    appendAudiencePortraitGroup(rows, '城市', payload?.audienceSourceDetail?.city);
+    appendAudiencePortraitGroup(rows, '兴趣', payload?.audienceSourceDetail?.interest);
+    return rows;
+}
+function formatTrendTimestamp(ts, granularity) {
+    if (!ts)
+        return '';
+    // Use fixed UTC+8 offset to ensure consistent output regardless of CI server timezone.
+    const CST_OFFSET_MS = 8 * 60 * 60 * 1000;
+    const cstDate = new Date(ts + CST_OFFSET_MS);
+    const pad = (value) => String(value).padStart(2, '0');
+    if (granularity === 'hour') {
+        return `${pad(cstDate.getUTCMonth() + 1)}-${pad(cstDate.getUTCDate())} ${pad(cstDate.getUTCHours())}:00`;
+    }
+    return `${cstDate.getUTCFullYear()}-${pad(cstDate.getUTCMonth() + 1)}-${pad(cstDate.getUTCDate())}`;
+}
+function formatTrendSeries(points, granularity) {
+    if (!points?.length)
+        return '';
+    return points
+        .map((point) => {
+        const label = formatTrendTimestamp(point.date, granularity);
+        const value = point.count_with_double ?? point.count;
+        return label && value != null ? `${label}=${value}` : '';
+    })
+        .filter(Boolean)
+        .join(' | ');
+}
+const TREND_SERIES_CONFIG = [
+    { key: 'imp_list', label: '曝光数' },
+    { key: 'view_list', label: '观看数' },
+    { key: 'view_time_list', label: '平均观看时长' },
+    { key: 'like_list', label: '点赞数' },
+    { key: 'comment_list', label: '评论数' },
+    { key: 'collect_list', label: '收藏数' },
+    { key: 'share_list', label: '分享数' },
+    { key: 'rise_fans_list', label: '涨粉数' },
+];
+export function appendTrendRows(rows, payload) {
+    if (payload?.audienceTrend?.no_data_tip_msg) {
+        rows.push({
+            section: '趋势说明',
+            metric: '观众趋势',
+            value: payload.audienceTrend.no_data ? '暂不可用' : '可用',
+            extra: payload.audienceTrend.no_data_tip_msg,
+        });
+    }
+    const buckets = [
+        { label: '按小时', granularity: 'hour', data: payload?.noteBase?.hour },
+        { label: '按天', granularity: 'day', data: payload?.noteBase?.day },
+    ];
+    for (const bucket of buckets) {
+        for (const series of TREND_SERIES_CONFIG) {
+            const points = bucket.data?.[series.key];
+            const formatted = formatTrendSeries(points, bucket.granularity);
+            if (!formatted)
+                continue;
+            rows.push({
+                section: '趋势数据',
+                metric: `${bucket.label}/${series.label}`,
+                value: `${points.length} points`,
+                extra: formatted,
+            });
+        }
+    }
+    return rows;
+}
+const DETAIL_API_ENDPOINTS = [
+    { suffix: '/api/galaxy/creator/datacenter/note/base', key: 'noteBase' },
+    { suffix: '/api/galaxy/creator/datacenter/note/analyze/audience/trend', key: 'audienceTrend' },
+    { suffix: '/api/galaxy/creator/datacenter/note/audience/source/detail', key: 'audienceSourceDetail' },
+    { suffix: '/api/galaxy/creator/datacenter/note/audience', key: 'audienceSource' },
+];
+async function captureNoteDetailPayload(page, noteId) {
+    const payload = {};
+    let captured = 0;
+    // Try to fetch each API endpoint through the page context (uses the browser's cookies)
+    for (const { suffix, key } of DETAIL_API_ENDPOINTS) {
+        const apiUrl = `${suffix}?note_id=${noteId}`;
+        try {
+            const data = await page.evaluate(`
+        async () => {
+          try {
+            const resp = await fetch(${JSON.stringify(apiUrl)}, { credentials: 'include' });
+            if (!resp.ok) return null;
+            const json = await resp.json();
+            return JSON.stringify(json.data ?? {});
+          } catch { return null; }
+        }
+      `);
+            if (data && typeof data === 'string') {
+                try {
+                    payload[key] = JSON.parse(data);
+                    captured++;
+                }
+                catch { }
+            }
+        }
+        catch { }
+    }
+    return captured > 0 ? payload : null;
+}
+export async function fetchCreatorNoteDetailRows(page, noteId) {
+    await page.goto(`https://creator.xiaohongshu.com/statistics/note-detail?noteId=${encodeURIComponent(noteId)}`);
+    await page.wait(4);
+    const bodyText = await page.evaluate('() => document.body.innerText');
+    const rows = parseCreatorNoteDetailText(typeof bodyText === 'string' ? bodyText : '', noteId);
+    const apiPayload = await captureNoteDetailPayload(page, noteId).catch(() => null);
+    appendTrendRows(rows, apiPayload ?? undefined);
+    appendAudienceRows(rows, apiPayload ?? undefined);
+    return rows;
+}
 cli({
     site: 'xiaohongshu',
     name: 'creator-note-detail',
-    description: '小红书单篇笔记详细数据 (阅读/互动/点赞/收藏/评论/分享，区分自然流量/推广/视频)',
+    description: '小红书单篇笔记详情页数据 (笔记信息 + 核心/互动数据 + 观看来源 + 观众画像 + 趋势数据)',
     domain: 'creator.xiaohongshu.com',
     strategy: Strategy.COOKIE,
     browser: true,
     args: [
-        { name: 'note_id', type: 'string', required: true, help: 'Note ID (from note URL or creator-notes command)' },
+        { name: 'note_id', type: 'string', required: true, help: 'Note ID (from creator-notes or note-detail page URL)' },
     ],
-    columns: ['channel', 'reads', 'engagement', 'likes', 'collects', 'comments', 'shares'],
+    columns: ['section', 'metric', 'value', 'extra'],
     func: async (page, kwargs) => {
         const noteId = kwargs.note_id;
-        const encodedNoteId = encodeURIComponent(noteId);
-        // Navigate for cookie context
-        await page.goto('https://creator.xiaohongshu.com/new/home');
-        await page.wait(2);
-        const data = await page.evaluate(`
-      async () => {
-        try {
-          const resp = await fetch(
-            '/api/galaxy/creator/data/note_detail?note_id=${encodedNoteId}',
-            { 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 + '. Check note_id and login status.');
-        }
-        if (!data?.data) {
-            throw new Error('Unexpected response structure');
+        const rows = await fetchCreatorNoteDetailRows(page, noteId);
+        const hasCoreMetric = rows.some((row) => row.section !== '笔记信息' && row.value);
+        if (!hasCoreMetric) {
+            throw new Error('No note detail data found. Check note_id and login status for creator.xiaohongshu.com.');
         }
-        const d = data.data;
-        return [
-            {
-                channel: 'Total',
-                reads: d.total_read ?? 0,
-                engagement: d.total_engage ?? 0,
-                likes: d.total_like ?? 0,
-                collects: d.total_fav ?? 0,
-                comments: d.total_cmt ?? 0,
-                shares: d.total_share ?? 0,
-            },
-            {
-                channel: 'Organic',
-                reads: d.normal_read ?? 0,
-                engagement: d.normal_engage ?? 0,
-                likes: d.normal_like ?? 0,
-                collects: d.normal_fav ?? 0,
-                comments: d.normal_cmt ?? 0,
-                shares: d.normal_share ?? 0,
-            },
-            {
-                channel: 'Promoted',
-                reads: d.total_promo_read ?? 0,
-                engagement: 0,
-                likes: 0,
-                collects: 0,
-                comments: 0,
-                shares: 0,
-            },
-            {
-                channel: 'Video',
-                reads: d.video_read ?? 0,
-                engagement: d.video_engage ?? 0,
-                likes: d.video_like ?? 0,
-                collects: d.video_fav ?? 0,
-                comments: d.video_cmt ?? 0,
-                shares: d.video_share ?? 0,
-            },
-        ];
+        return rows;
     },
 });

package/dist/clis/xiaohongshu/creator-note-detail.test.d.ts

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

package/dist/clis/xiaohongshu/creator-note-detail.test.js

@@ -0,0 +1,211 @@
+import { describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import { appendAudienceRows, appendTrendRows, parseCreatorNoteDetailText } from './creator-note-detail.js';
+import './creator-note-detail.js';
+function createPageMock(evaluateResult) {
+    return {
+        goto: vi.fn().mockResolvedValue(undefined),
+        evaluate: vi.fn().mockResolvedValue(evaluateResult),
+        snapshot: vi.fn().mockResolvedValue(undefined),
+        click: vi.fn().mockResolvedValue(undefined),
+        typeText: vi.fn().mockResolvedValue(undefined),
+        pressKey: vi.fn().mockResolvedValue(undefined),
+        wait: vi.fn().mockResolvedValue(undefined),
+        tabs: vi.fn().mockResolvedValue([]),
+        closeTab: vi.fn().mockResolvedValue(undefined),
+        newTab: vi.fn().mockResolvedValue(undefined),
+        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: vi.fn().mockResolvedValue([]),
+        getCookies: vi.fn().mockResolvedValue([]),
+        screenshot: vi.fn().mockResolvedValue(''),
+    };
+}
+describe('xiaohongshu creator-note-detail', () => {
+    it('parses note detail page text into info and metric rows', () => {
+        const bodyText = `笔记数据详情
+一张图讲清 诡秘之主·耕种者途径
+#诡秘之主
+#耕种者序列
+2026-03-18 20:01
+切换笔记
+笔记诊断
+核心数据
+观看来源
+观众画像
+核心数据
+基础数据
+部分数据统计中，次日可查看
+导出数据
+曝光数
+1733
+粉丝占比 6.6%
+实时
+观看数
+544
+粉丝占比 7.2%
+封面点击率
+18.6%
+粉丝 19.1%
+平均观看时长
+51.5秒
+粉丝 55.8秒
+涨粉数
+3
+按小时
+按天
+互动数据
+数据实时更新
+导出数据
+点赞数
+19
+粉丝占比 60%
+评论数
+7
+粉丝占比 33.3%
+收藏数
+10
+粉丝占比 33.3%
+分享数
+6
+粉丝占比 0%`;
+        expect(parseCreatorNoteDetailText(bodyText, '69ba940500000000200384db')).toEqual([
+            { section: '笔记信息', metric: 'note_id', value: '69ba940500000000200384db', extra: '' },
+            { section: '笔记信息', metric: 'title', value: '一张图讲清 诡秘之主·耕种者途径', extra: '' },
+            { section: '笔记信息', metric: 'published_at', value: '2026-03-18 20:01', extra: '' },
+            { section: '基础数据', metric: '曝光数', value: '1733', extra: '粉丝占比 6.6%' },
+            { section: '基础数据', metric: '观看数', value: '544', extra: '粉丝占比 7.2%' },
+            { section: '基础数据', metric: '封面点击率', value: '18.6%', extra: '粉丝 19.1%' },
+            { section: '基础数据', metric: '平均观看时长', value: '51.5秒', extra: '粉丝 55.8秒' },
+            { section: '基础数据', metric: '涨粉数', value: '3', extra: '' },
+            { section: '互动数据', metric: '点赞数', value: '19', extra: '粉丝占比 60%' },
+            { section: '互动数据', metric: '评论数', value: '7', extra: '粉丝占比 33.3%' },
+            { section: '互动数据', metric: '收藏数', value: '10', extra: '粉丝占比 33.3%' },
+            { section: '互动数据', metric: '分享数', value: '6', extra: '粉丝占比 0%' },
+        ]);
+    });
+    it('appends audience source and portrait rows from API payloads', () => {
+        const rows = appendAudienceRows([], {
+            audienceSource: {
+                source: [
+                    {
+                        title: '首页推荐',
+                        value_with_double: 89.9,
+                        info: {
+                            imp_count: 1469,
+                            view_count: 276,
+                            interaction_count: 15,
+                        },
+                    },
+                ],
+            },
+            audienceSourceDetail: {
+                gender: [
+                    { title: '男性', value: 82 },
+                    { title: '女性', value: 18 },
+                ],
+                age: [
+                    { title: '25-34', value: 55 },
+                ],
+                city: [
+                    { title: '上海', value: 8 },
+                ],
+                interest: [
+                    { title: '二次元', value: 13 },
+                ],
+            },
+        });
+        expect(rows).toEqual([
+            { section: '观看来源', metric: '首页推荐', value: '89.9%', extra: '曝光 1469 · 观看 276 · 互动 15' },
+            { section: '观众画像', metric: '性别/男性', value: '82%', extra: '' },
+            { section: '观众画像', metric: '性别/女性', value: '18%', extra: '' },
+            { section: '观众画像', metric: '年龄/25-34', value: '55%', extra: '' },
+            { section: '观众画像', metric: '城市/上海', value: '8%', extra: '' },
+            { section: '观众画像', metric: '兴趣/二次元', value: '13%', extra: '' },
+        ]);
+    });
+    it('appends trend summary rows from hour/day series payloads', () => {
+        const rows = appendTrendRows([], {
+            audienceTrend: {
+                no_data: true,
+                no_data_tip_msg: '数据统计中，请稍后查看',
+            },
+            noteBase: {
+                hour: {
+                    view_list: [
+                        { date: new Date('2026-03-18T21:00:00+08:00').getTime(), count: 54 },
+                        { date: new Date('2026-03-18T22:00:00+08:00').getTime(), count: 51 },
+                    ],
+                    like_list: [
+                        { date: new Date('2026-03-18T21:00:00+08:00').getTime(), count: 2 },
+                    ],
+                },
+                day: {
+                    view_list: [
+                        { date: new Date('2026-03-18T00:00:00+08:00').getTime(), count: 307 },
+                    ],
+                },
+            },
+        });
+        expect(rows).toEqual([
+            { section: '趋势说明', metric: '观众趋势', value: '暂不可用', extra: '数据统计中，请稍后查看' },
+            { section: '趋势数据', metric: '按小时/观看数', value: '2 points', extra: '03-18 21:00=54 | 03-18 22:00=51' },
+            { section: '趋势数据', metric: '按小时/点赞数', value: '1 points', extra: '03-18 21:00=2' },
+            { section: '趋势数据', metric: '按天/观看数', value: '1 points', extra: '2026-03-18=307' },
+        ]);
+    });
+    it('navigates to the note detail page and returns parsed rows', async () => {
+        const cmd = getRegistry().get('xiaohongshu/creator-note-detail');
+        expect(cmd?.func).toBeTypeOf('function');
+        const page = createPageMock(`笔记数据详情
+示例笔记
+2026-03-19 12:00
+曝光数
+100
+粉丝占比 10%
+观看数
+50
+粉丝占比 20%
+封面点击率
+12%
+粉丝 11%
+平均观看时长
+30秒
+粉丝 31秒
+涨粉数
+2
+点赞数
+8
+粉丝占比 25%
+评论数
+1
+粉丝占比 0%
+收藏数
+3
+粉丝占比 50%
+分享数
+0
+粉丝占比 0%`);
+        const result = await cmd.func(page, { note_id: 'demo-note-id' });
+        expect(page.goto.mock.calls[0][0]).toBe('https://creator.xiaohongshu.com/statistics/note-detail?noteId=demo-note-id');
+        expect(page.evaluate.mock.calls[0][0]).toBe('() => document.body.innerText');
+        expect(result).toEqual([
+            { section: '笔记信息', metric: 'note_id', value: 'demo-note-id', extra: '' },
+            { section: '笔记信息', metric: 'title', value: '示例笔记', extra: '' },
+            { section: '笔记信息', metric: 'published_at', value: '2026-03-19 12:00', extra: '' },
+            { section: '基础数据', metric: '曝光数', value: '100', extra: '粉丝占比 10%' },
+            { section: '基础数据', metric: '观看数', value: '50', extra: '粉丝占比 20%' },
+            { section: '基础数据', metric: '封面点击率', value: '12%', extra: '粉丝 11%' },
+            { section: '基础数据', metric: '平均观看时长', value: '30秒', extra: '粉丝 31秒' },
+            { section: '基础数据', metric: '涨粉数', value: '2', extra: '' },
+            { section: '互动数据', metric: '点赞数', value: '8', extra: '粉丝占比 25%' },
+            { section: '互动数据', metric: '评论数', value: '1', extra: '粉丝占比 0%' },
+            { section: '互动数据', metric: '收藏数', value: '3', extra: '粉丝占比 50%' },
+            { section: '互动数据', metric: '分享数', value: '0', extra: '粉丝占比 0%' },
+        ]);
+    });
+});

package/dist/clis/xiaohongshu/creator-notes-summary.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Xiaohongshu Creator Notes Summary — batch summary for recent notes.
+ *
+ * Combines creator-notes and creator-note-detail into a single command that
+ * returns one summary row per note, suitable for quick review or downstream JSON use.
+ */
+import { type CreatorNoteRow } from './creator-notes.js';
+import { type CreatorNoteDetailRow } from './creator-note-detail.js';
+type CreatorNoteSummaryRow = {
+    rank: number;
+    id: string;
+    title: string;
+    published_at: string;
+    views: string;
+    likes: string;
+    collects: string;
+    comments: string;
+    shares: string;
+    avg_view_time: string;
+    rise_fans: string;
+    top_source: string;
+    top_source_pct: string;
+    top_interest: string;
+    top_interest_pct: string;
+    url: string;
+};
+export declare function summarizeCreatorNote(note: CreatorNoteRow, rows: CreatorNoteDetailRow[], rank: number): CreatorNoteSummaryRow;
+export {};

package/dist/clis/xiaohongshu/creator-notes-summary.js

@@ -0,0 +1,92 @@
+/**
+ * Xiaohongshu Creator Notes Summary — batch summary for recent notes.
+ *
+ * Combines creator-notes and creator-note-detail into a single command that
+ * returns one summary row per note, suitable for quick review or downstream JSON use.
+ */
+import { cli, Strategy } from '../../registry.js';
+import { fetchCreatorNotes } from './creator-notes.js';
+import { fetchCreatorNoteDetailRows } from './creator-note-detail.js';
+function findDetailValue(rows, metric) {
+    return rows.find((row) => row.metric === metric)?.value ?? '';
+}
+function findTopBySectionPrefix(rows, section, prefix) {
+    const matches = rows.filter((row) => row.section === section && row.metric.startsWith(prefix) && row.value);
+    if (matches.length === 0)
+        return { label: '', value: '' };
+    const sorted = [...matches].sort((a, b) => parseFloat(b.value) - parseFloat(a.value));
+    const top = sorted[0];
+    return {
+        label: top.metric.slice(prefix.length),
+        value: top.value,
+    };
+}
+export function summarizeCreatorNote(note, rows, rank) {
+    const topSource = findTopBySectionPrefix(rows, '观看来源', '');
+    const topInterest = findTopBySectionPrefix(rows, '观众画像', '兴趣/');
+    return {
+        rank,
+        id: note.id,
+        title: note.title,
+        published_at: findDetailValue(rows, 'published_at') || note.date,
+        views: findDetailValue(rows, '观看数') || String(note.views),
+        likes: findDetailValue(rows, '点赞数') || String(note.likes),
+        collects: findDetailValue(rows, '收藏数') || String(note.collects),
+        comments: findDetailValue(rows, '评论数') || String(note.comments),
+        shares: findDetailValue(rows, '分享数'),
+        avg_view_time: findDetailValue(rows, '平均观看时长'),
+        rise_fans: findDetailValue(rows, '涨粉数'),
+        top_source: topSource.label,
+        top_source_pct: topSource.value,
+        top_interest: topInterest.label,
+        top_interest_pct: topInterest.value,
+        url: note.url,
+    };
+}
+cli({
+    site: 'xiaohongshu',
+    name: 'creator-notes-summary',
+    description: '小红书最近笔记批量摘要 (列表 + 单篇关键数据汇总)',
+    domain: 'creator.xiaohongshu.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: 'limit', type: 'int', default: 3, help: 'Number of recent notes to summarize' },
+    ],
+    columns: ['rank', 'id', 'title', 'views', 'likes', 'collects', 'comments', 'shares', 'avg_view_time', 'rise_fans', 'top_source', 'top_interest', 'url'],
+    timeoutSeconds: 180,
+    func: async (page, kwargs) => {
+        const limit = kwargs.limit || 3;
+        const notes = await fetchCreatorNotes(page, limit);
+        if (!notes.length) {
+            throw new Error('No notes found. Are you logged into creator.xiaohongshu.com?');
+        }
+        const results = [];
+        for (const [index, note] of notes.entries()) {
+            if (!note.id) {
+                results.push({
+                    rank: index + 1,
+                    id: note.id,
+                    title: note.title,
+                    published_at: note.date,
+                    views: String(note.views),
+                    likes: String(note.likes),
+                    collects: String(note.collects),
+                    comments: String(note.comments),
+                    shares: '',
+                    avg_view_time: '',
+                    rise_fans: '',
+                    top_source: '',
+                    top_source_pct: '',
+                    top_interest: '',
+                    top_interest_pct: '',
+                    url: note.url,
+                });
+                continue;
+            }
+            const detailRows = await fetchCreatorNoteDetailRows(page, note.id);
+            results.push(summarizeCreatorNote(note, detailRows, index + 1));
+        }
+        return results;
+    },
+});

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

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