@agentrhq/webcmd 0.1.1 → 0.2.0

package/clis/xiaohongshu/saved.js

@@ -1,29 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { COLLECT_API_PATTERN, fetchXhsCollectionNotes, parseCollectionLimit, resolveXhsUserId, SAVED_PROFILE_TAB } from './collection-helpers.js';
-
-cli({
-    site: 'xiaohongshu',
-    name: 'saved',
-    access: 'read',
-    description: '小红书收藏笔记列表',
-    domain: 'www.xiaohongshu.com',
-    strategy: Strategy.COOKIE,
-    navigateBefore: false,
-    browser: true,
-    args: [
-        { name: 'id', type: 'string', help: 'User id or profile URL (defaults to current logged-in user)' },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of notes to return' },
-    ],
-    columns: ['rank', 'id', 'title', 'author', 'likes', 'type', 'url'],
-    func: async (page, kwargs) => {
-        const limit = parseCollectionLimit(kwargs.limit);
-        const userId = await resolveXhsUserId(page, kwargs.id);
-        return fetchXhsCollectionNotes(page, {
-            userId,
-            profileTab: SAVED_PROFILE_TAB,
-            apiPattern: COLLECT_API_PATTERN,
-            limit,
-            emptyLabel: 'saved',
-        });
-    },
-});

package/clis/xiaohongshu/saved.test.js

@@ -1,143 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { ArgumentError, AuthRequiredError, CommandExecutionError } from '@agentrhq/webcmd/errors';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import { createPageMock } from '../test-utils.js';
-import './saved.js';
-
-describe('xiaohongshu saved', () => {
-    const command = getRegistry().get('xiaohongshu/saved');
-
-    it('registers with navigateBefore=false', () => {
-        expect(command).toBeDefined();
-        expect(command.navigateBefore).toBe(false);
-        expect(command.name).toBe('saved');
-    });
-
-    it('captures saved notes from the collect API', async () => {
-        const intercepted = [
-            {
-                data: {
-                    notes: [
-                        {
-                            note_id: '662908190000000001007366',
-                            xsec_token: 'tok',
-                            note_card: {
-                                display_title: '收藏笔记',
-                                type: 'normal',
-                                user: { user_id: 'user-1', nickname: 'Me' },
-                                interact_info: { liked_count: '8' },
-                            },
-                        },
-                    ],
-                },
-            },
-        ];
-        const evaluate = vi.fn()
-            .mockResolvedValueOnce(false)
-            .mockResolvedValueOnce('self-user')
-            .mockResolvedValueOnce(false)
-            .mockResolvedValueOnce({
-                hostname: 'www.xiaohongshu.com',
-                pathname: '/user/profile/self-user',
-                href: 'https://www.xiaohongshu.com/user/profile/self-user?tab=fav&subTab=note',
-            });
-        const getInterceptedRequests = vi.fn()
-            .mockResolvedValueOnce([])
-            .mockResolvedValueOnce(intercepted);
-        const page = createPageMock([], {
-            evaluate,
-            getInterceptedRequests,
-        });
-
-        const result = await command.func(page, { limit: 1 });
-        expect(result).toEqual([
-            {
-                rank: 1,
-                id: '662908190000000001007366',
-                title: '收藏笔记',
-                author: 'Me',
-                likes: '8',
-                type: 'normal',
-                url: 'https://www.xiaohongshu.com/user/profile/user-1/662908190000000001007366?xsec_token=tok&xsec_source=pc_user',
-            },
-        ]);
-        expect(page.installInterceptor).toHaveBeenCalledWith('note/collect/page');
-        expect(page.goto.mock.calls.at(-1)[0]).toBe('https://www.xiaohongshu.com/user/profile/self-user?tab=fav&subTab=note');
-    });
-
-    it('rejects invalid --limit before browser navigation', async () => {
-        const page = createPageMock();
-
-        await expect(command.func(page, { limit: 0 })).rejects.toBeInstanceOf(ArgumentError);
-        expect(page.goto).not.toHaveBeenCalled();
-    });
-
-    it('maps collection login wall to AuthRequiredError', async () => {
-        const page = createPageMock([], {
-            evaluate: vi.fn().mockResolvedValueOnce(true),
-        });
-
-        await expect(command.func(page, { id: 'self-user', limit: 5 })).rejects.toBeInstanceOf(AuthRequiredError);
-    });
-
-    it('maps collection login redirects to AuthRequiredError', async () => {
-        const page = createPageMock([], {
-            evaluate: vi.fn()
-                .mockResolvedValueOnce(false)
-                .mockResolvedValueOnce({
-                    hostname: 'www.xiaohongshu.com',
-                    pathname: '/login',
-                    href: 'https://www.xiaohongshu.com/login',
-                }),
-        });
-
-        await expect(command.func(page, { id: 'self-user', limit: 5 })).rejects.toBeInstanceOf(AuthRequiredError);
-    });
-
-    it('fails closed when navigation lands on another profile', async () => {
-        const page = createPageMock([], {
-            evaluate: vi.fn()
-                .mockResolvedValueOnce(false)
-                .mockResolvedValueOnce({
-                    hostname: 'www.xiaohongshu.com',
-                    pathname: '/user/profile/other-user',
-                    href: 'https://www.xiaohongshu.com/user/profile/other-user?tab=fav&subTab=note',
-                }),
-        });
-
-        await expect(command.func(page, { id: 'self-user', limit: 5 })).rejects.toBeInstanceOf(CommandExecutionError);
-        expect(page.getInterceptedRequests).not.toHaveBeenCalled();
-    });
-
-    it('fails closed when collection API rows lack signed note identity', async () => {
-        const page = createPageMock([], {
-            evaluate: vi.fn()
-                .mockResolvedValueOnce(false)
-                .mockResolvedValueOnce({
-                    hostname: 'www.xiaohongshu.com',
-                    pathname: '/user/profile/self-user',
-                    href: 'https://www.xiaohongshu.com/user/profile/self-user?tab=fav&subTab=note',
-                }),
-            getInterceptedRequests: vi.fn().mockResolvedValueOnce([{
-                data: { notes: [{ note_id: '662908190000000001007366' }] },
-            }]),
-        });
-
-        await expect(command.func(page, { id: 'self-user', limit: 5 })).rejects.toBeInstanceOf(CommandExecutionError);
-    });
-
-    it('fails closed when interceptor captures are malformed', async () => {
-        const page = createPageMock([], {
-            evaluate: vi.fn()
-                .mockResolvedValueOnce(false)
-                .mockResolvedValueOnce({
-                    hostname: 'www.xiaohongshu.com',
-                    pathname: '/user/profile/self-user',
-                    href: 'https://www.xiaohongshu.com/user/profile/self-user?tab=fav&subTab=note',
-                }),
-            getInterceptedRequests: vi.fn().mockResolvedValueOnce({ data: { notes: [] } }),
-        });
-
-        await expect(command.func(page, { id: 'self-user', limit: 5 })).rejects.toBeInstanceOf(CommandExecutionError);
-    });
-});

package/clis/xiaohongshu/search.js

@@ -1,330 +0,0 @@
-/**
- * Xiaohongshu search — DOM-based extraction from search results page.
- * The previous Pinia store + XHR interception approach broke because
- * the API now returns empty items. This version navigates directly to
- * the search results page and extracts data from rendered DOM elements.
- * Ref: https://github.com/agentrhq/webcmd/issues/10
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { ArgumentError, AuthRequiredError, CommandExecutionError } from '@agentrhq/webcmd/errors';
-/**
- * Wait for search results or login wall using MutationObserver (max 5s).
- * Returns 'content' if note items appeared, 'login_wall' if login gate
- * detected, or 'timeout' if neither appeared within the deadline.
- *
- * Note-item detection tries the legacy `section.note-item` class first
- * (still observed in many sessions, including rednote) and falls back to
- * a `<section>` element containing a `/search_result/` or `/explore/`
- * link. Issue #1506 reports the class being dropped on some xhs renders.
- */
-const WAIT_FOR_CONTENT_JS = `
-  new Promise((resolve) => {
-    const findNoteCard = () => document.querySelector(
-      'section.note-item, section:has(a[href*="/search_result/"]), section:has(a[href*="/explore/"])'
-    );
-    const detect = () => {
-      if (findNoteCard()) return 'content';
-      if (/登录后查看搜索结果/.test(document.body?.innerText || '')) return 'login_wall';
-      return null;
-    };
-    const found = detect();
-    if (found) return resolve(found);
-    const observer = new MutationObserver(() => {
-      const result = detect();
-      if (result) { observer.disconnect(); resolve(result); }
-    });
-    observer.observe(document.body, { childList: true, subtree: true });
-    setTimeout(() => { observer.disconnect(); resolve('timeout'); }, 5000);
-  })
-`;
-/**
- * Extract approximate publish date from a Xiaohongshu note URL.
- * XHS note IDs follow MongoDB ObjectID format where the first 8 hex
- * characters encode a Unix timestamp (the moment the ID was generated,
- * which closely matches publish time but is not an official API field).
- * e.g. "697f6c74..." → 0x697f6c74 = 1769958516 → 2026-02-01
- */
-export function noteIdToDate(url) {
-    const match = url.match(/\/(?:search_result|explore|note)\/([0-9a-f]{24})(?=[?#/]|$)/i);
-    if (!match)
-        return '';
-    const hex = match[1].substring(0, 8);
-    const ts = parseInt(hex, 16);
-    if (!ts || ts < 1_000_000_000 || ts > 4_000_000_000)
-        return '';
-    // Offset by UTC+8 (China Standard Time) so the date matches what XHS users see
-    return new Date((ts + 8 * 3600) * 1000).toISOString().slice(0, 10);
-}
-export function stripXhsAuthorDateSuffix(value) {
-    const text = (value || '').replace(/\s+/g, ' ').trim();
-    const stripped = text.replace(/\s*(?:\d{1,2}天前|\d+小时前|\d+分钟前|\d+秒前|刚刚|昨天|前天|\d+周前|\d+个月前|\d{1,2}-\d{1,2}|\d{4}-\d{1,2}-\d{1,2})$/u, '').trim();
-    return stripped || text;
-}
-/**
- * `page.evaluate` may return either the raw IIFE value or a
- * `{ session, data }` envelope depending on the browser-bridge version.
- * Adapter code that called `Array.isArray(payload)` directly on the
- * envelope silently received [] for every search. This helper normalizes
- * both shapes so callers can keep their Array.isArray checks unchanged.
- */
-export function unwrapEvaluateResult(payload) {
-    if (payload && !Array.isArray(payload) && typeof payload === 'object' && 'session' in payload && 'data' in payload) {
-        return payload.data;
-    }
-    return payload;
-}
-function requireSearchRows(payload, phase) {
-    const rows = unwrapEvaluateResult(payload);
-    if (!Array.isArray(rows)) {
-        throw new CommandExecutionError(`Unexpected Xiaohongshu search ${phase} payload shape; expected an array of rows.`);
-    }
-    return rows;
-}
-export function parseLimit(raw) {
-    const parsed = Number(raw ?? 20);
-    if (!Number.isFinite(parsed) || !Number.isInteger(parsed)) {
-        throw new ArgumentError(`--limit must be an integer between 1 and 100, got ${JSON.stringify(raw)}`);
-    }
-    if (parsed < 1 || parsed > 100) {
-        throw new ArgumentError(`--limit must be between 1 and 100, got ${parsed}`);
-    }
-    return parsed;
-}
-/**
- * Build a "scroll until enough or plateaued" IIFE used in place of a fixed
- * `autoScroll({ times: N })`. Xiaohongshu's search results page lazy-loads
- * ~5-7 notes per scroll, so the previous `times: 2` capped extraction at
- * ~13 items regardless of `--limit` (see #1471). This helper drives scrolls
- * dynamically:
- *
- *   - count visible `section.note-item` rows (excluding related-search
- *     `.query-note-item` rows)
- *   - if count >= targetCount → break (got enough)
- *   - if two consecutive scrolls add no new rows → break (DOM plateaued,
- *     no more lazy-load available)
- *   - hard cap at `maxScrolls` iterations (default 15) to bound runtime
- *
- * Exported so the rednote adapter (same DOM shape) can reuse it.
- */
-export function buildScrollUntilJs(targetCount, maxScrolls = 15) {
-    if (!Number.isSafeInteger(targetCount) || targetCount < 1) {
-        throw new ArgumentError(`targetCount must be a positive integer, got ${JSON.stringify(targetCount)}`);
-    }
-    if (!Number.isSafeInteger(maxScrolls) || maxScrolls < 1) {
-        throw new ArgumentError(`maxScrolls must be a positive integer, got ${JSON.stringify(maxScrolls)}`);
-    }
-    return `
-      (async () => {
-        const isVisibleNote = (el) => {
-          if (el.classList.contains('query-note-item')) return false;
-          const rect = el.getBoundingClientRect();
-          if (rect.width <= 0 || rect.height <= 0) return false;
-          const style = getComputedStyle(el);
-          return style.display !== 'none' && style.visibility !== 'hidden';
-        };
-        // Note containers: legacy \`section.note-item\` first, fallback to
-        // any \`<section>\` that wraps a search-result/explore note link
-        // (#1506 reports the class being dropped on some xhs renders).
-        const collectNoteCards = () => {
-          const classMatches = document.querySelectorAll('section.note-item');
-          if (classMatches.length > 0) return classMatches;
-          const sections = new Set();
-          for (const a of document.querySelectorAll('a[href*="/search_result/"], a[href*="/explore/"]')) {
-            const section = a.closest('section');
-            if (section) sections.add(section);
-          }
-          return sections;
-        };
-        const countItems = () => {
-          let count = 0;
-          for (const el of collectNoteCards()) {
-            if (isVisibleNote(el)) count++;
-          }
-          return count;
-        };
-
-        let lastCount = countItems();
-        let plateauRounds = 0;
-        for (let i = 0; i < ${maxScrolls}; i++) {
-          if (countItems() >= ${targetCount}) break;
-          const lastHeight = document.body.scrollHeight;
-          window.scrollTo(0, lastHeight);
-          await new Promise((resolve) => {
-            let to;
-            const ob = new MutationObserver(() => {
-              if (document.body.scrollHeight > lastHeight) {
-                clearTimeout(to);
-                ob.disconnect();
-                setTimeout(resolve, 200);
-              }
-            });
-            ob.observe(document.body, { childList: true, subtree: true });
-            to = setTimeout(() => { ob.disconnect(); resolve(null); }, 2500);
-          });
-          const newCount = countItems();
-          if (newCount === lastCount) {
-            plateauRounds++;
-            if (plateauRounds >= 2) break;
-          } else {
-            plateauRounds = 0;
-            lastCount = newCount;
-          }
-        }
-        return countItems();
-      })()
-    `;
-}
-/**
- * Build the search-result extraction IIFE. The web host is baked into the
- * `normalizeUrl` fallback so relative `/explore/...` hrefs resolve to a full
- * URL on the calling site. Exported so the rednote adapter can call it with
- * `www.rednote.com` without duplicating the selector logic.
- */
-export function buildSearchExtractJs(webHost) {
-    return `
-      (() => {
-        const normalizeUrl = (href) => {
-          if (!href) return '';
-          if (href.startsWith('http://') || href.startsWith('https://')) return href;
-          if (href.startsWith('/')) return 'https://${webHost}' + href;
-          return '';
-        };
-
-        const cleanText = (value) => (value || '').replace(/\\s+/g, ' ').trim();
-        const stripXhsAuthorDateSuffix = ${stripXhsAuthorDateSuffix.toString()};
-        const isVisibleNote = (el) => {
-          const rect = el.getBoundingClientRect();
-          if (rect.width <= 0 || rect.height <= 0) return false;
-          const style = getComputedStyle(el);
-          return style.display !== 'none' && style.visibility !== 'hidden';
-        };
-
-        const results = [];
-        const seen = new Set();
-
-        // Note containers: legacy \`section.note-item\` first, fallback to any
-        // \`<section>\` wrapping a search-result/explore link (#1506 reports the
-        // class being dropped on some xhs renders).
-        const collectNoteCards = () => {
-          const classMatches = document.querySelectorAll('section.note-item');
-          if (classMatches.length > 0) return classMatches;
-          const sections = new Set();
-          for (const a of document.querySelectorAll('a[href*="/search_result/"], a[href*="/explore/"]')) {
-            const section = a.closest('section');
-            if (section) sections.add(section);
-          }
-          return sections;
-        };
-
-        for (const el of collectNoteCards()) {
-          // Skip "related searches" sections
-          if (el.classList?.contains('query-note-item')) continue;
-          if (!isVisibleNote(el)) continue;
-
-          const titleEl = el.querySelector('.title, .note-title, a.title, .footer .title span');
-          const nameEl = el.querySelector('a.author .name, .author-name, .nick-name, .name');
-          const authorWrapEl = el.querySelector('a.author');
-          let author = cleanText(nameEl?.textContent || '');
-          if (!author && authorWrapEl) {
-            const nameChild = authorWrapEl.querySelector('.name');
-            author = nameChild ? cleanText(nameChild.textContent || '') : stripXhsAuthorDateSuffix(authorWrapEl.textContent || '');
-          }
-          const likesEl = el.querySelector('.count, .like-count, .like-wrapper .count');
-          // Prefer search_result link (preserves xsec_token) over generic /explore/ link
-          const detailLinkEl =
-            el.querySelector('a.cover.mask') ||
-            el.querySelector('a[href*="/search_result/"]') ||
-            el.querySelector('a[href*="/explore/"]') ||
-            el.querySelector('a[href*="/note/"]');
-          const authorLinkEl = el.querySelector('a.author, a[href*="/user/profile/"]');
-
-          const url = normalizeUrl(detailLinkEl?.getAttribute('href') || '');
-          if (!url) continue;
-
-          const key = url;
-          if (seen.has(key)) continue;
-          seen.add(key);
-
-          // Fallback title: the new bare-section render keeps the note caption
-          // inside the search_result anchor's first span, not in a class-named
-          // .title element. Pull from there when the class-based pick is empty.
-          let title = cleanText(titleEl?.textContent || '');
-          if (!title) {
-            const captionSpan = detailLinkEl?.querySelector('span');
-            title = cleanText(captionSpan?.textContent || '');
-          }
-
-          results.push({
-            title,
-            author,
-            likes: cleanText(likesEl?.textContent || '0'),
-            url,
-            author_url: normalizeUrl(authorLinkEl?.getAttribute('href') || ''),
-          });
-        }
-
-        return results;
-      })()
-    `;
-}
-export const command = cli({
-    site: 'xiaohongshu',
-    name: 'search',
-    access: 'read',
-    description: '搜索小红书笔记',
-    domain: 'www.xiaohongshu.com',
-    strategy: Strategy.COOKIE,
-    navigateBefore: false,
-    args: [
-        { name: 'query', required: true, positional: true, help: 'Search keyword' },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of results' },
-    ],
-    columns: ['rank', 'title', 'author', 'likes', 'published_at', 'url'],
-    func: async (page, kwargs) => {
-        const limit = parseLimit(kwargs.limit);
-        const keyword = encodeURIComponent(kwargs.query);
-        await page.goto(`https://www.xiaohongshu.com/search_result?keyword=${keyword}&source=web_search_result_notes`);
-        // Wait for search results to render (or login wall to appear).
-        // Uses MutationObserver to resolve as soon as content appears,
-        // instead of a fixed delay + blind retry.
-        const waitResult = unwrapEvaluateResult(await page.evaluate(WAIT_FOR_CONTENT_JS));
-        if (waitResult === 'login_wall') {
-            throw new AuthRequiredError('www.xiaohongshu.com', 'Xiaohongshu search results are blocked behind a login wall');
-        }
-        // Extract before scrolling. Xiaohongshu uses a virtualized masonry
-        // layout, so scrolling to the bottom can evict the initially visible
-        // note cards from the DOM and make extraction return [] even though the
-        // browser rendered results correctly.
-        const initialPayload = requireSearchRows(await page.evaluate(buildSearchExtractJs('www.xiaohongshu.com')), 'initial extraction');
-        const payload = [...initialPayload];
-        if (payload.length < limit) {
-            // Scroll until enough rows are rendered or the lazy-load plateaus.
-            // Replaces the previous fixed `autoScroll({ times: 2 })` which capped
-            // extraction at ~13 notes regardless of `--limit` (#1471).
-            await page.evaluate(buildScrollUntilJs(limit));
-            const scrolledPayload = requireSearchRows(await page.evaluate(buildSearchExtractJs('www.xiaohongshu.com')), 'post-scroll extraction');
-            const seen = new Set(payload.map((item) => item.url).filter(Boolean));
-            for (const item of scrolledPayload) {
-                if (item?.url && seen.has(item.url))
-                    continue;
-                if (item?.url)
-                    seen.add(item.url);
-                payload.push(item);
-                if (payload.length >= limit)
-                    break;
-            }
-        }
-        const data = payload;
-        return data
-            .filter((item) => item.title)
-            .slice(0, limit)
-            .map((item, i) => ({
-            rank: i + 1,
-            ...item,
-            published_at: noteIdToDate(item.url),
-        }));
-    },
-});
-export const __test__ = {
-    stripXhsAuthorDateSuffix,
-};