jackwener--opencli/clis/xiaohongshu/creator-notes-summary.js

/**
 * 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 '@jackwener/opencli/registry';
import { EmptyResultError } from '@jackwener/opencli/errors';
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',
    access: 'read',
    description: '小红书最近笔记批量摘要 (列表 + 单篇关键数据汇总)',
    domain: 'creator.xiaohongshu.com',
    strategy: Strategy.COOKIE,
    browser: true,
    navigateBefore: false,
    args: [
        { name: 'limit', type: 'int', default: 3, help: 'Number of recent notes to summarize' },
        { name: 'timeout', type: 'int', required: false, default: 180, help: 'Max seconds for the overall command (default: 180)' },
    ],
    columns: ['rank', 'id', 'title', 'views', 'likes', 'collects', 'comments', 'shares', 'avg_view_time', 'rise_fans', 'top_source', 'top_interest', 'url'],
    func: async (page, kwargs) => {
        const limit = kwargs.limit || 3;
        const notes = await fetchCreatorNotes(page, limit);
        if (!notes.length) {
            throw new EmptyResultError('xiaohongshu creator-notes-summary', 'No notes found. Ensure you are logged into creator.xiaohongshu.com and the account has published notes.');
        }
        const results = [];
        for (const [index, note] of notes.entries()) {
            if (index > 0) {
                await page.wait({ time: 1 + Math.random() * 2 });
            }
            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;
    },
});