@jackwener/opencli 1.1.0 → 1.2.0

package/dist/clis/weread/notes.js

@@ -7,7 +7,7 @@ cli({
     domain: 'weread.qq.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'bookId', positional: true, required: true, help: 'Book ID (from shelf or search results)' },
+        { name: 'book-id', positional: true, required: true, help: 'Book ID (from shelf or search results)' },
         { name: 'limit', type: 'int', default: 20, help: 'Max results' },
     ],
     columns: ['chapter', 'text', 'review', 'createTime'],

package/dist/clis/weread/search.js

@@ -8,7 +8,7 @@ cli({
     strategy: Strategy.PUBLIC,
     browser: false,
     args: [
-        { name: 'keyword', positional: true, required: true, help: 'Search keyword' },
+        { name: 'query', positional: true, required: true, help: 'Search keyword' },
         { name: 'limit', type: 'int', default: 10, help: 'Max results' },
     ],
     columns: ['rank', 'title', 'author', 'bookId'],

package/dist/clis/wikipedia/random.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/wikipedia/random.js

@@ -0,0 +1,19 @@
+import { CliError } from '../../errors.js';
+import { cli, Strategy } from '../../registry.js';
+import { formatSummaryRow, wikiFetch } from './utils.js';
+cli({
+    site: 'wikipedia',
+    name: 'random',
+    description: 'Get a random Wikipedia article',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [{ name: 'lang', default: 'en', help: 'Language code (e.g. en, zh, ja)' }],
+    columns: ['title', 'description', 'extract', 'url'],
+    func: async (_page, args) => {
+        const lang = args.lang || 'en';
+        const data = (await wikiFetch(lang, '/api/rest_v1/page/random/summary'));
+        if (!data?.title)
+            throw new CliError('NOT_FOUND', 'No random article returned', 'Try again');
+        return [formatSummaryRow(data, lang)];
+    },
+});

package/dist/clis/wikipedia/search.js

@@ -1,5 +1,5 @@
-import { cli, Strategy } from '../../registry.js';
 import { CliError } from '../../errors.js';
+import { cli, Strategy } from '../../registry.js';
 import { wikiFetch } from './utils.js';
 cli({
     site: 'wikipedia',
@@ -8,7 +8,7 @@ cli({
     strategy: Strategy.PUBLIC,
     browser: false,
     args: [
-        { name: 'keyword', positional: true, required: true, help: 'Search keyword' },
+        { name: 'query', positional: true, required: true, help: 'Search keyword' },
         { name: 'limit', type: 'int', default: 10, help: 'Max results' },
         { name: 'lang', default: 'en', help: 'Language code (e.g. en, zh, ja)' },
     ],
@@ -16,8 +16,8 @@ cli({
     func: async (_page, args) => {
         const limit = Math.max(1, Math.min(Number(args.limit), 50));
         const lang = args.lang || 'en';
-        const q = encodeURIComponent(args.keyword);
-        const data = await wikiFetch(lang, `/w/api.php?action=query&list=search&srsearch=${q}&srlimit=${limit}&format=json&utf8=1`);
+        const q = encodeURIComponent(args.query);
+        const data = (await wikiFetch(lang, `/w/api.php?action=query&list=search&srsearch=${q}&srlimit=${limit}&format=json&utf8=1`));
         const results = data?.query?.search;
         if (!results?.length)
             throw new CliError('NOT_FOUND', 'No articles found', 'Try a different keyword');

package/dist/clis/wikipedia/summary.js

@@ -1,6 +1,6 @@
-import { cli, Strategy } from '../../registry.js';
 import { CliError } from '../../errors.js';
-import { wikiFetch } from './utils.js';
+import { cli, Strategy } from '../../registry.js';
+import { formatSummaryRow, wikiFetch } from './utils.js';
 cli({
     site: 'wikipedia',
     name: 'summary',
@@ -15,14 +15,9 @@ cli({
     func: async (_page, args) => {
         const lang = args.lang || 'en';
         const title = encodeURIComponent(args.title.replace(/ /g, '_'));
-        const data = await wikiFetch(lang, `/api/rest_v1/page/summary/${title}`);
+        const data = (await wikiFetch(lang, `/api/rest_v1/page/summary/${title}`));
         if (!data?.title)
             throw new CliError('NOT_FOUND', `Article "${args.title}" not found`, 'Try searching first: opencli wikipedia search <keyword>');
-        return [{
-                title: data.title,
-                description: data.description ?? '-',
-                extract: (data.extract ?? '').slice(0, 300),
-                url: data.content_urls?.desktop?.page ?? `https://${lang}.wikipedia.org/wiki/${title}`,
-            }];
+        return [formatSummaryRow(data, lang)];
     },
 });

package/dist/clis/wikipedia/trending.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/wikipedia/trending.js

@@ -0,0 +1,35 @@
+import { CliError } from '../../errors.js';
+import { cli, Strategy } from '../../registry.js';
+import { DESC_MAX_LEN, wikiFetch } from './utils.js';
+cli({
+    site: 'wikipedia',
+    name: 'trending',
+    description: 'Most-read Wikipedia articles (yesterday)',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'limit', type: 'int', default: 10, help: 'Max results' },
+        { name: 'lang', default: 'en', help: 'Language code (e.g. en, zh, ja)' },
+    ],
+    columns: ['rank', 'title', 'description', 'views'],
+    func: async (_page, args) => {
+        const lang = args.lang || 'en';
+        const limit = Math.max(1, Math.min(Number(args.limit), 50));
+        // Use yesterday's UTC date — Wikipedia API expects UTC and yesterday
+        // guarantees data availability (today's aggregation may be incomplete).
+        const d = new Date(Date.now() - 86_400_000);
+        const yyyy = d.getUTCFullYear();
+        const mm = String(d.getUTCMonth() + 1).padStart(2, '0');
+        const dd = String(d.getUTCDate()).padStart(2, '0');
+        const data = (await wikiFetch(lang, `/api/rest_v1/feed/featured/${yyyy}/${mm}/${dd}`));
+        const articles = data?.mostread?.articles;
+        if (!articles?.length)
+            throw new CliError('NOT_FOUND', 'No trending articles available', 'Try a different language with --lang');
+        return articles.slice(0, limit).map((a, i) => ({
+            rank: i + 1,
+            title: a.title ?? '-',
+            description: (a.description ?? '-').slice(0, DESC_MAX_LEN),
+            views: a.views ?? 0,
+        }));
+    },
+});

package/dist/clis/wikipedia/utils.d.ts

@@ -5,4 +5,32 @@
  * REST API: https://en.wikipedia.org/api/rest_v1/
  * Action API: https://en.wikipedia.org/w/api.php
  */
+/** Maximum character length for article extract fields. */
+export declare const EXTRACT_MAX_LEN = 300;
+/** Maximum character length for short description fields. */
+export declare const DESC_MAX_LEN = 80;
+/** Response shape shared by /page/summary and /page/random/summary endpoints. */
+export interface WikiSummary {
+    title?: string;
+    description?: string;
+    extract?: string;
+    content_urls?: {
+        desktop?: {
+            page?: string;
+        };
+    };
+}
+/** Article entry returned by the /feed/featured most-read endpoint. */
+export interface WikiMostReadArticle {
+    title?: string;
+    description?: string;
+    views?: number;
+}
 export declare function wikiFetch(lang: string, path: string): Promise<unknown>;
+/** Map a WikiSummary API response to the standard output row. */
+export declare function formatSummaryRow(data: WikiSummary, lang: string): {
+    title: string;
+    description: string;
+    extract: string;
+    url: string;
+};

package/dist/clis/wikipedia/utils.js

@@ -6,6 +6,10 @@
  * Action API: https://en.wikipedia.org/w/api.php
  */
 import { CliError } from '../../errors.js';
+/** Maximum character length for article extract fields. */
+export const EXTRACT_MAX_LEN = 300;
+/** Maximum character length for short description fields. */
+export const DESC_MAX_LEN = 80;
 export async function wikiFetch(lang, path) {
     const url = `https://${lang}.wikipedia.org${path}`;
     const resp = await fetch(url, {
@@ -16,3 +20,12 @@ export async function wikiFetch(lang, path) {
     }
     return resp.json();
 }
+/** Map a WikiSummary API response to the standard output row. */
+export function formatSummaryRow(data, lang) {
+    return {
+        title: data.title,
+        description: data.description ?? '-',
+        extract: (data.extract ?? '').slice(0, EXTRACT_MAX_LEN),
+        url: data.content_urls?.desktop?.page ?? `https://${lang}.wikipedia.org`,
+    };
+}

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

@@ -16,6 +16,20 @@ type CreatorNoteDetailRow = {
     extra: string;
 };
 export type { CreatorNoteDetailRow };
+type CreatorNoteDetailDomMetric = {
+    label: string;
+    value: string;
+    extra: string;
+};
+type CreatorNoteDetailDomSection = {
+    title: string;
+    metrics: CreatorNoteDetailDomMetric[];
+};
+type CreatorNoteDetailDomData = {
+    title: string;
+    infoText: string;
+    sections: CreatorNoteDetailDomSection[];
+};
 type AudienceSourceItem = {
     title?: string;
     value_with_double?: number;
@@ -64,6 +78,7 @@ type NoteDetailApiPayload = {
     };
 };
 export declare function parseCreatorNoteDetailText(bodyText: string, noteId: string): CreatorNoteDetailRow[];
+export declare function parseCreatorNoteDetailDomData(dom: CreatorNoteDetailDomData | null | undefined, noteId: string): CreatorNoteDetailRow[];
 export declare function appendAudienceRows(rows: CreatorNoteDetailRow[], payload?: NoteDetailApiPayload): CreatorNoteDetailRow[];
 export declare function appendTrendRows(rows: CreatorNoteDetailRow[], payload?: NoteDetailApiPayload): CreatorNoteDetailRow[];
 export declare function fetchCreatorNoteDetailRows(page: IPage, noteId: string): Promise<CreatorNoteDetailRow[]>;

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

@@ -22,6 +22,7 @@ const NOTE_DETAIL_METRICS = [
     { label: '分享数', section: '互动数据' },
 ];
 const NOTE_DETAIL_METRIC_LABELS = new Set(NOTE_DETAIL_METRICS.map((metric) => metric.label));
+const NOTE_DETAIL_SECTIONS = new Set(NOTE_DETAIL_METRICS.map((metric) => metric.section));
 const NOTE_DETAIL_NOISE_LINES = new Set([
     '切换笔记',
     '笔记诊断',
@@ -75,6 +76,10 @@ function findMetricValue(lines, startIndex) {
     }
     return { value, extra };
 }
+function findPublishedAt(text) {
+    const match = text.match(/\b\d{4}-\d{2}-\d{2} \d{2}:\d{2}\b/);
+    return match?.[0] ?? '';
+}
 export function parseCreatorNoteDetailText(bodyText, noteId) {
     const lines = bodyText
         .split('\n')
@@ -101,6 +106,34 @@ export function parseCreatorNoteDetailText(bodyText, noteId) {
     }
     return rows;
 }
+export function parseCreatorNoteDetailDomData(dom, noteId) {
+    if (!dom)
+        return [];
+    const title = typeof dom.title === 'string' ? dom.title.trim() : '';
+    const infoText = typeof dom.infoText === 'string' ? dom.infoText : '';
+    const sections = Array.isArray(dom.sections) ? dom.sections : [];
+    const rows = [
+        { section: '笔记信息', metric: 'note_id', value: noteId, extra: '' },
+        { section: '笔记信息', metric: 'title', value: title, extra: '' },
+        { section: '笔记信息', metric: 'published_at', value: findPublishedAt(infoText), extra: '' },
+    ];
+    for (const section of sections) {
+        if (!NOTE_DETAIL_SECTIONS.has(section.title))
+            continue;
+        for (const metric of section.metrics) {
+            if (!NOTE_DETAIL_METRIC_LABELS.has(metric.label))
+                continue;
+            rows.push({
+                section: section.title,
+                metric: metric.label,
+                value: metric.value,
+                extra: metric.extra,
+            });
+        }
+    }
+    const hasMetric = rows.some((row) => row.section !== '笔记信息' && row.value);
+    return hasMetric ? rows : [];
+}
 function toPercentString(value) {
     return value == null ? '' : `${value}%`;
 }
@@ -244,11 +277,42 @@ async function captureNoteDetailPayload(page, noteId) {
     }
     return captured > 0 ? payload : null;
 }
+async function captureNoteDetailDomData(page) {
+    const result = await page.evaluate(`() => {
+    const norm = (value) => (value || '').trim();
+    const sections = Array.from(document.querySelectorAll('.shell-container')).map((container) => {
+      const containerText = norm(container.innerText);
+      const title = containerText.startsWith('互动数据')
+        ? '互动数据'
+        : containerText.includes('基础数据')
+          ? '基础数据'
+          : '';
+      const metrics = Array.from(container.querySelectorAll('.block-container.block')).map((block) => ({
+        label: norm(block.querySelector('.des')?.innerText),
+        value: norm(block.querySelector('.content')?.innerText),
+        extra: norm(block.querySelector('.text-with-fans')?.innerText),
+      })).filter((metric) => metric.label && metric.value);
+      return { title, metrics };
+    }).filter((section) => section.title && section.metrics.length > 0);
+
+    return {
+      title: norm(document.querySelector('.note-title')?.innerText),
+      infoText: norm(document.querySelector('.note-info-content')?.innerText),
+      sections,
+    };
+  }`);
+    if (!result || typeof result !== 'object')
+        return null;
+    return result;
+}
 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 domData = await captureNoteDetailDomData(page).catch(() => null);
+    let rows = parseCreatorNoteDetailDomData(domData, noteId);
+    if (rows.length === 0) {
+        const bodyText = await page.evaluate('() => document.body.innerText');
+        rows = parseCreatorNoteDetailText(typeof bodyText === 'string' ? bodyText : '', noteId);
+    }
     const apiPayload = await captureNoteDetailPayload(page, noteId).catch(() => null);
     appendTrendRows(rows, apiPayload ?? undefined);
     appendAudienceRows(rows, apiPayload ?? undefined);
@@ -262,11 +326,11 @@ cli({
     strategy: Strategy.COOKIE,
     browser: true,
     args: [
-        { name: 'note_id', type: 'string', required: true, help: 'Note ID (from creator-notes or note-detail page URL)' },
+        { name: 'note-id', positional: true, type: 'string', required: true, help: 'Note ID (from creator-notes or note-detail page URL)' },
     ],
     columns: ['section', 'metric', 'value', 'extra'],
     func: async (page, kwargs) => {
-        const noteId = kwargs.note_id;
+        const noteId = kwargs['note-id'];
         const rows = await fetchCreatorNoteDetailRows(page, noteId);
         const hasCoreMetric = rows.some((row) => row.section !== '笔记信息' && row.value);
         if (!hasCoreMetric) {

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

@@ -1,15 +1,22 @@
 import { describe, expect, it, vi } from 'vitest';
 import { getRegistry } from '../../registry.js';
-import { appendAudienceRows, appendTrendRows, parseCreatorNoteDetailText } from './creator-note-detail.js';
+import { appendAudienceRows, appendTrendRows, parseCreatorNoteDetailDomData, parseCreatorNoteDetailText } from './creator-note-detail.js';
 import './creator-note-detail.js';
 function createPageMock(evaluateResult) {
+    const evaluate = Array.isArray(evaluateResult)
+        ? vi.fn()
+            .mockResolvedValueOnce(evaluateResult[0])
+            .mockResolvedValue(evaluateResult[evaluateResult.length - 1])
+        : vi.fn().mockResolvedValue(evaluateResult);
     return {
         goto: vi.fn().mockResolvedValue(undefined),
-        evaluate: vi.fn().mockResolvedValue(evaluateResult),
+        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([]),
         closeTab: vi.fn().mockResolvedValue(undefined),
@@ -88,6 +95,46 @@ describe('xiaohongshu creator-note-detail', () => {
             { section: '互动数据', metric: '分享数', value: '6', extra: '粉丝占比 0%' },
         ]);
     });
+    it('parses structured note detail dom data into rows', () => {
+        expect(parseCreatorNoteDetailDomData({
+            title: '神雕侠侣战力金字塔',
+            infoText: '神雕侠侣战力金字塔\n#武侠\n2025-12-04 19:45\n切换笔记',
+            sections: [
+                {
+                    title: '基础数据',
+                    metrics: [
+                        { label: '曝光数', value: '898204', extra: '粉丝占比 0.5%' },
+                        { label: '观看数', value: '148284', extra: '粉丝占比 0.6%' },
+                        { label: '封面点击率', value: '17.1%', extra: '粉丝 19.1%' },
+                        { label: '平均观看时长', value: '30.1秒', extra: '粉丝 17.7秒' },
+                        { label: '涨粉数', value: '101', extra: '' },
+                    ],
+                },
+                {
+                    title: '互动数据',
+                    metrics: [
+                        { label: '点赞数', value: '2280', extra: '粉丝占比 3.6%' },
+                        { label: '评论数', value: '319', extra: '粉丝占比 9.4%' },
+                        { label: '收藏数', value: '466', extra: '粉丝占比 9.4%' },
+                        { label: '分享数', value: '33', extra: '粉丝占比 17.7%' },
+                    ],
+                },
+            ],
+        }, '693155fc000000000d03b42c')).toEqual([
+            { section: '笔记信息', metric: 'note_id', value: '693155fc000000000d03b42c', extra: '' },
+            { section: '笔记信息', metric: 'title', value: '神雕侠侣战力金字塔', extra: '' },
+            { section: '笔记信息', metric: 'published_at', value: '2025-12-04 19:45', extra: '' },
+            { section: '基础数据', metric: '曝光数', value: '898204', extra: '粉丝占比 0.5%' },
+            { section: '基础数据', metric: '观看数', value: '148284', extra: '粉丝占比 0.6%' },
+            { section: '基础数据', metric: '封面点击率', value: '17.1%', extra: '粉丝 19.1%' },
+            { section: '基础数据', metric: '平均观看时长', value: '30.1秒', extra: '粉丝 17.7秒' },
+            { section: '基础数据', metric: '涨粉数', value: '101', extra: '' },
+            { section: '互动数据', metric: '点赞数', value: '2280', extra: '粉丝占比 3.6%' },
+            { section: '互动数据', metric: '评论数', value: '319', extra: '粉丝占比 9.4%' },
+            { section: '互动数据', metric: '收藏数', value: '466', extra: '粉丝占比 9.4%' },
+            { section: '互动数据', metric: '分享数', value: '33', extra: '粉丝占比 17.7%' },
+        ]);
+    });
     it('appends audience source and portrait rows from API payloads', () => {
         const rows = appendAudienceRows([], {
             audienceSource: {
@@ -161,38 +208,40 @@ describe('xiaohongshu creator-note-detail', () => {
     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' });
+        const page = createPageMock([
+            {
+                title: '示例笔记',
+                infoText: '示例笔记\n2026-03-19 12:00\n切换笔记',
+                sections: [
+                    {
+                        title: '基础数据',
+                        metrics: [
+                            { label: '曝光数', value: '100', extra: '粉丝占比 10%' },
+                            { label: '观看数', value: '50', extra: '粉丝占比 20%' },
+                            { label: '封面点击率', value: '12%', extra: '粉丝 11%' },
+                            { label: '平均观看时长', value: '30秒', extra: '粉丝 31秒' },
+                            { label: '涨粉数', value: '2', extra: '' },
+                        ],
+                    },
+                    {
+                        title: '互动数据',
+                        metrics: [
+                            { label: '点赞数', value: '8', extra: '粉丝占比 25%' },
+                            { label: '评论数', value: '1', extra: '粉丝占比 0%' },
+                            { label: '收藏数', value: '3', extra: '粉丝占比 50%' },
+                            { label: '分享数', value: '0', extra: '粉丝占比 0%' },
+                        ],
+                    },
+                ],
+            },
+            null,
+            null,
+            null,
+            null,
+        ]);
+        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(page.evaluate.mock.calls[0][0]).toContain("document.querySelector('.note-title')");
         expect(result).toEqual([
             { section: '笔记信息', metric: 'note_id', value: 'demo-note-id', extra: '' },
             { section: '笔记信息', metric: 'title', value: '示例笔记', extra: '' },

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

@@ -59,9 +59,9 @@ export function parseCreatorNotesText(bodyText) {
             title,
             date: dateMatch[1],
             views: metrics[0] ?? 0,
-            likes: metrics[1] ?? 0,
-            collects: metrics[2] ?? 0,
-            comments: metrics[3] ?? 0,
+            likes: metrics[2] ?? 0,
+            collects: metrics[3] ?? 0,
+            comments: metrics[1] ?? 0,
             url: '',
         });
         i = cursor - 1;
@@ -80,6 +80,18 @@ export function parseCreatorNoteIdsFromHtml(bodyHtml) {
     }
     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 ?? '',
@@ -97,7 +109,6 @@ async function fetchCreatorNotesByApi(page, limit) {
     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`);
-    await page.wait(4);
     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(`
@@ -139,9 +150,28 @@ 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');
-        await page.wait(4);
         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 : '';

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

@@ -18,6 +18,8 @@ function createPageMock(evaluateResult, interceptedRequests = []) {
         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([]),
         closeTab: vi.fn().mockResolvedValue(undefined),
@@ -64,9 +66,9 @@ describe('xiaohongshu creator-notes', () => {
                 title: '神雕侠侣战力金字塔',
                 date: '2025年12月04日 19:45',
                 views: 148208,
-                likes: 324,
-                collects: 2279,
-                comments: 465,
+                likes: 2279,
+                collects: 465,
+                comments: 324,
                 url: '',
             },
             {
@@ -107,13 +109,42 @@ describe('xiaohongshu creator-notes', () => {
                 title: '示例笔记',
                 date: '2026年03月19日 12:00',
                 views: 10,
-                likes: 2,
-                collects: 3,
-                comments: 4,
+                likes: 3,
+                collects: 4,
+                comments: 2,
                 url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=69ba940500000000200384db',
             },
         ]);
     });
+    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: '693155fc000000000d03b42c',
+                    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: '693155fc000000000d03b42c',
+                title: '神雕侠侣战力金字塔',
+                date: '2025年12月04日 19:45',
+                views: 148284,
+                likes: 2280,
+                collects: 466,
+                comments: 319,
+                url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=693155fc000000000d03b42c',
+            },
+        ]);
+    });
     it('prefers the creator analyze API and preserves note ids', async () => {
         const cmd = getRegistry().get('xiaohongshu/creator-notes');
         expect(cmd?.func).toBeTypeOf('function');

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

@@ -19,7 +19,6 @@ cli({
     columns: ['field', 'value'],
     func: async (page, _kwargs) => {
         await page.goto('https://creator.xiaohongshu.com/new/home');
-        await page.wait(3);
         const data = await page.evaluate(`
       async () => {
         try {

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

@@ -29,7 +29,6 @@ cli({
         const period = kwargs.period || 'seven';
         // Navigate to creator center for cookie context
         await page.goto('https://creator.xiaohongshu.com/new/home');
-        await page.wait(3);
         const data = await page.evaluate(`
       async () => {
         try {