@agentrhq/webcmd 0.1.2 → 0.2.0

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

@@ -1,281 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import { __test__, 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',
-        ]);
-    });
-    it('harvests captured analyze pages in page order and dedupes note ids', () => {
-        const captureMap = {
-            '/api/galaxy/creator/datacenter/note/analyze/list?type=0&page_size=10&page_num=2': {
-                ok: true,
-                body: JSON.stringify({
-                    data: {
-                        total: 3,
-                        note_infos: [
-                            { id: 'bbbbbbbbbbbbbbbbbbbbbbbb', title: 'page 2' },
-                            { id: 'aaaaaaaaaaaaaaaaaaaaaaaa', title: 'duplicate from page 2' },
-                        ],
-                    },
-                }),
-            },
-            '/api/galaxy/creator/datacenter/note/analyze/list?type=0&page_size=10&page_num=1': {
-                ok: true,
-                body: JSON.stringify({
-                    data: {
-                        total: 3,
-                        note_infos: [
-                            { id: 'aaaaaaaaaaaaaaaaaaaaaaaa', title: 'page 1' },
-                        ],
-                    },
-                }),
-            },
-        };
-        expect(__test__.harvestAnalyzeListCaptures(captureMap)).toEqual({
-            total: 3,
-            items: [
-                { id: 'aaaaaaaaaaaaaaaaaaaaaaaa', title: 'page 1' },
-                { id: 'bbbbbbbbbbbbbbbbbbbbbbbb', title: 'page 2' },
-            ],
-        });
-    });
-    it('treats incomplete captured pagination as fallback-needed instead of partial success', () => {
-        const firstPageItems = Array.from({ length: 10 }, (_, index) => ({
-            id: String(index).padStart(24, '0'),
-        }));
-        expect(__test__.isAnalyzeCaptureComplete(firstPageItems, 25, 20)).toBe(false);
-        expect(__test__.isAnalyzeCaptureComplete(firstPageItems, 25, 10)).toBe(true);
-        expect(__test__.isAnalyzeCaptureComplete(firstPageItems, 0, 20)).toBe(true);
-    });
-    it('unwraps browser bridge capture-map envelopes', () => {
-        const captureMap = {
-            '/api/galaxy/creator/datacenter/note/analyze/list?page_num=1': {
-                ok: true,
-                body: '{"data":{"total":0,"note_infos":[]}}',
-            },
-        };
-        expect(__test__.parseCaptureMapPayload({ session: 'site:xiaohongshu', data: JSON.stringify(captureMap) })).toEqual(captureMap);
-        expect(__test__.parseCaptureMapPayload({ session: 'site:xiaohongshu', data: captureMap })).toEqual(captureMap);
-    });
-    it('does not fall back to partial DOM rows when captured total proves pagination is incomplete', async () => {
-        const cmd = getRegistry().get('xiaohongshu/creator-notes');
-        const captureMap = {
-            '/api/galaxy/creator/datacenter/note/analyze/list?type=0&page_size=10&page_num=1': {
-                ok: true,
-                body: JSON.stringify({
-                    data: {
-                        total: 25,
-                        note_infos: Array.from({ length: 10 }, (_, index) => ({
-                            id: String(index).padStart(24, '0'),
-                            title: `note ${index}`,
-                        })),
-                    },
-                }),
-            },
-        };
-        const page = createPageMock(undefined);
-        page.evaluate = vi.fn()
-            .mockResolvedValueOnce(undefined)
-            .mockResolvedValueOnce(undefined)
-            .mockResolvedValueOnce(JSON.stringify(captureMap))
-            .mockResolvedValueOnce(false);
-
-        await expect(cmd.func(page, { limit: 20 })).rejects.toBeInstanceOf(CommandExecutionError);
-    });
-    it('throws EmptyResultError when the creator account has no notes', async () => {
-        const cmd = getRegistry().get('xiaohongshu/creator-notes');
-        const page = createPageMock(undefined);
-        page.evaluate = vi.fn()
-            .mockResolvedValueOnce(undefined)
-            .mockResolvedValueOnce(undefined)
-            .mockResolvedValueOnce([])
-            .mockResolvedValueOnce({ text: '', html: '' });
-
-        await expect(cmd.func(page, { limit: 1 })).rejects.toBeInstanceOf(EmptyResultError);
-    });
-});

package/clis/xiaohongshu/creator-profile.js

@@ -1,55 +0,0 @@
-/**
- * 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 '@agentrhq/webcmd/registry';
-cli({
-    site: 'xiaohongshu',
-    name: 'creator-profile',
-    access: 'read',
-    description: '小红书创作者账号信息 (粉丝/关注/获赞/成长等级)',
-    domain: 'creator.xiaohongshu.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    navigateBefore: false,
-    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/clis/xiaohongshu/creator-stats.js

@@ -1,76 +0,0 @@
-/**
- * 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 '@agentrhq/webcmd/registry';
-import { EmptyResultError } from '@agentrhq/webcmd/errors';
-cli({
-    site: 'xiaohongshu',
-    name: 'creator-stats',
-    access: 'read',
-    description: '小红书创作者数据总览 (观看/点赞/收藏/评论/分享/涨粉，含每日趋势)',
-    domain: 'creator.xiaohongshu.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    navigateBefore: false,
-    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 EmptyResultError('xiaohongshu creator-stats', `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/clis/xiaohongshu/creator-stats.test.js

@@ -1,24 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { EmptyResultError } from '@agentrhq/webcmd/errors';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './creator-stats.js';
-
-describe('xiaohongshu creator-stats', () => {
-    it('throws EmptyResultError when the requested stats period has no data', async () => {
-        const cmd = getRegistry().get('xiaohongshu/creator-stats');
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn().mockResolvedValue({
-                data: {
-                    seven: null,
-                    thirty: {
-                        view_count: 1,
-                        view_list: [{ count: 1 }],
-                    },
-                },
-            }),
-        };
-
-        await expect(cmd.func(page, { period: 'seven' })).rejects.toBeInstanceOf(EmptyResultError);
-    });
-});