@agentrhq/webcmd 0.1.2 → 0.2.1

package/clis/douyin/publish.test.js

@@ -1,38 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './publish.js';
-describe('douyin publish registration', () => {
-    it('registers the publish command', () => {
-        const registry = getRegistry();
-        const cmds = [...registry.values()];
-        const cmd = cmds.find((c) => c.site === 'douyin' && c.name === 'publish');
-        expect(cmd).toBeDefined();
-        expect(cmd?.args.some((a) => a.name === 'video')).toBe(true);
-        expect(cmd?.args.some((a) => a.name === 'title')).toBe(true);
-        expect(cmd?.args.some((a) => a.name === 'schedule')).toBe(true);
-    });
-    it('has all expected args', () => {
-        const registry = getRegistry();
-        const cmd = [...registry.values()].find((c) => c.site === 'douyin' && c.name === 'publish');
-        const argNames = cmd?.args.map((a) => a.name) ?? [];
-        expect(argNames).toContain('video');
-        expect(argNames).toContain('title');
-        expect(argNames).toContain('schedule');
-        expect(argNames).toContain('caption');
-        expect(argNames).toContain('cover');
-        expect(argNames).toContain('visibility');
-        expect(argNames).toContain('allow_download');
-        expect(argNames).toContain('collection');
-        expect(argNames).toContain('activity');
-        expect(argNames).toContain('poi_id');
-        expect(argNames).toContain('poi_name');
-        expect(argNames).toContain('hotspot');
-        expect(argNames).toContain('no_safety_check');
-        expect(argNames).toContain('sync_toutiao');
-    });
-    it('uses COOKIE strategy', () => {
-        const registry = getRegistry();
-        const cmd = [...registry.values()].find((c) => c.site === 'douyin' && c.name === 'publish');
-        expect(cmd?.strategy).toBe('cookie');
-    });
-});

package/clis/douyin/search.js

@@ -1,308 +0,0 @@
-/**
- * Douyin search — keyword video search on www.douyin.com.
- *
- * Strategy: DOM extraction from the server-rendered search results page.
- *
- * Why not XHR interception:
- *   The `www.douyin.com/search/<q>?type=video` page renders results into
- *   `<ul data-e2e="scroll-list">` server-side during initial navigation
- *   and (for the Webcmd-bridged browser context) does NOT fire a
- *   subsequent `/aweme/v1/web/general/search/single/` XHR — we confirmed
- *   this by `wait xhr "general/search/single"` timing out at 20s on a
- *   logged-in profile that has visible result cards in the DOM. Direct
- *   synthesis of the XHR from page context returns
- *   `status_code: 0, data: [], search_nil_info: { search_nil_type:
- *   "verify_check" }` because the bare URL lacks the SPA-computed
- *   `a_bogus` / `msToken` signature.
- *
- *   DOM extraction sidesteps both blockers: the data is already in the
- *   rendered HTML at the moment of navigation, signature-free.
- *
- * Selector approach:
- *   Douyin obfuscates card classnames (e.g. `.ckopQfVu`, `.cIiU4Muu`)
- *   and they churn between builds. We pin only the stable hooks:
- *     - container:   `[data-e2e="scroll-list"]`
- *     - row:         `li` inside the container
- *     - url:         `a[href*="/video/"]`
- *     - other fields are extracted from the row's leaf text nodes by
- *       SHAPE (digit+万/亿 → likes; HH:MM or MM:SS → duration; text after
- *       `@` → author nickname; longest remaining → desc).
- *
- * Output fields mirror `tiktok search` (rank, desc, author, url, plays,
- * likes, comments, shares) so downstream tools that already normalize
- * tiktok rows can consume douyin rows without per-adapter glue. The
- * search results page only surfaces the like count — plays/comments/
- * shares are not in the card markup and we expose them as 0 rather
- * than fabricate values; clients that need them should fetch
- * /aweme/v1/web/aweme/detail/?aweme_id=... for the relevant id.
- *
- * Prerequisite: the bound Chrome profile must be logged in to
- * https://www.douyin.com. The search results page renders an empty
- * skeleton for anonymous visitors, which we surface as AuthRequiredError.
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-
-export const MAX_SEARCH_LIMIT = 30;
-// Time budget for the SPA's initial DOM commit. Empirically the
-// scroll-list `<li>` rows appear within 2-4s of navigation when logged
-// in; 15s covers slow networks without blocking on a permanently-empty
-// page (anonymous gate, network error).
-export const RENDER_TIMEOUT_MS = 15000;
-
-export function parseSearchLimit(raw) {
-    const parsed = Number(raw ?? 10);
-    if (!Number.isFinite(parsed) || !Number.isInteger(parsed)) {
-        throw new ArgumentError(`--limit must be an integer between 1 and ${MAX_SEARCH_LIMIT}, got ${JSON.stringify(raw)}`);
-    }
-    if (parsed < 1 || parsed > MAX_SEARCH_LIMIT) {
-        throw new ArgumentError(`--limit must be between 1 and ${MAX_SEARCH_LIMIT}, got ${parsed}`);
-    }
-    return parsed;
-}
-
-/**
- * Parse a Douyin display count like "1.9万", "3.1万", "4702", "1.2亿"
- * into a plain integer. Returns 0 for unparseable input rather than
- * throwing — the CLI promises numeric columns and missing data is
- * common enough on real result rows that a soft fallback is the right
- * choice.
- */
-export function parseDouyinCount(text) {
-    if (typeof text !== 'string') return 0;
-    const m = text.replace(/\s/g, '').match(/^(\d+(?:\.\d+)?)([万亿])?$/);
-    if (!m) {
-        const plain = Number(text.replace(/[,\s]/g, ''));
-        return Number.isFinite(plain) ? Math.round(plain) : 0;
-    }
-    const n = Number(m[1]);
-    if (!Number.isFinite(n)) return 0;
-    if (m[2] === '万') return Math.round(n * 10_000);
-    if (m[2] === '亿') return Math.round(n * 100_000_000);
-    return Math.round(n);
-}
-
-export function extractDouyinVideoId(href) {
-    if (typeof href !== 'string' || !href) return '';
-    let full = href;
-    if (full.startsWith('//')) full = 'https:' + full;
-    else if (full.startsWith('/')) full = 'https://www.douyin.com' + full;
-    try {
-        const parsed = new URL(full);
-        if (!/(^|\.)douyin\.com$/.test(parsed.hostname)) return '';
-        const match = parsed.pathname.match(/^\/video\/(\d+)$/);
-        return match?.[1] ?? '';
-    }
-    catch {
-        return '';
-    }
-}
-
-/**
- * Resolve scheme-relative or absolute Douyin video links to the canonical
- * https://www.douyin.com/video/<id> shape. Returns '' for unparseable
- * input rather than throwing — callers expect a string column.
- */
-export function normalizeDouyinVideoUrl(href) {
-    const id = extractDouyinVideoId(href);
-    return id ? `https://www.douyin.com/video/${id}` : '';
-}
-
-function isSearchCardMetadataText(text) {
-    if (!text) return true;
-    if (/^\d{1,2}:\d{2}(?::\d{2})?$/.test(text)) return true;
-    if (/^\d+(?:\.\d+)?[万亿]?$/.test(text)) return true;
-    if (/^(合集|视频|作者)$/.test(text)) return true;
-    if (/^(刚刚|今天|昨天|前天)$/.test(text)) return true;
-    if (/^\d+\s*(秒|分钟|小时|天|周|个月|月|年)前$/.test(text)) return true;
-    if (/^\d{4}[-/.年]\d{1,2}(?:[-/.月]\d{1,2}日?)?$/.test(text)) return true;
-    return false;
-}
-
-/**
- * Project a single rendered card into the canonical row shape. Operates
- * on a serialized card payload (the raw `{href, leafTexts}` we collect
- * via page.evaluate) so this function is unit-testable without a real
- * browser.
- *
- * `leafTexts` is the ordered list of `textContent.trim()` for every leaf
- * element inside the card (no children). The fields we want are
- * identified by shape:
- *   - duration: matches `HH:MM:SS` or `MM:SS`
- *   - likes:    matches `<digits>(.<digits>)?(万|亿)?` and ISN'T the duration
- *   - author:   the text node immediately following an `@` text node
- *   - desc:     the longest remaining leaf text
- */
-export function projectCard(card, index) {
-    const url = normalizeDouyinVideoUrl(card?.url ?? card?.href);
-    const texts = Array.isArray(card?.leafTexts) ? card.leafTexts.map((t) => String(t ?? '').trim()).filter(Boolean) : [];
-
-    const DURATION_RE = /^\d{1,2}:\d{2}(?::\d{2})?$/;
-    const COUNT_RE = /^\d+(?:\.\d+)?[万亿]?$/;
-
-    let likes = 0;
-    let author = '';
-    let longest = '';
-
-    for (let i = 0; i < texts.length; i++) {
-        const t = texts[i];
-        if (DURATION_RE.test(t)) continue;
-        if (!likes && COUNT_RE.test(t)) {
-            likes = parseDouyinCount(t);
-            continue;
-        }
-        if (t === '@' && !author) {
-            author = (texts[i + 1] ?? '').trim();
-            continue;
-        }
-        if (t === author) continue;
-        if (isSearchCardMetadataText(t)) continue;
-        if (t.length > longest.length) longest = t;
-    }
-    let desc = longest;
-    // Strip a leading "@author" that some renders fuse into the desc text node.
-    if (author && desc.startsWith('@' + author)) {
-        desc = desc.slice(author.length + 1).trim();
-    }
-    return {
-        rank: index + 1,
-        desc,
-        author,
-        url,
-        plays: 0,
-        likes,
-        comments: 0,
-        shares: 0,
-    };
-}
-
-function isProjectedRowUsable(row) {
-    return Boolean(row?.url && row?.desc);
-}
-
-export function projectSearchCards(cards, limit) {
-    const window = Array.isArray(cards) ? cards.slice(0, limit) : [];
-    const rows = window.map((card, index) => projectCard(card, index));
-    const invalidCount = rows.filter((row) => !isProjectedRowUsable(row)).length;
-    return { rows: rows.filter(isProjectedRowUsable), invalidCount };
-}
-
-// JS snippet that waits for the scroll-list to populate, then returns
-// `{state: 'rendered', cards}` or `{state: 'login_wall'}` /
-// `{state: 'timeout'}`. Runs inside page.evaluate so we don't pay a
-// round-trip per poll iteration.
-const WAIT_AND_EXTRACT_JS = (timeoutMs) => `
-  new Promise((resolve) => {
-    const collectCards = () => {
-      const cards = [];
-      const lis = document.querySelectorAll('[data-e2e="scroll-list"] li');
-      for (const li of lis) {
-        const a = li.querySelector('a[href*="/video/"]');
-        if (!a) continue;
-        const leafTexts = [];
-        for (const el of li.querySelectorAll('*')) {
-          if (el.children.length > 0) continue;
-          const t = (el.textContent || '').trim();
-          if (t) leafTexts.push(t);
-        }
-        cards.push({ href: a.getAttribute('href') || '', leafTexts });
-      }
-      return cards;
-    };
-    const detectState = () => {
-      const cards = collectCards();
-      if (cards.length > 0) return { state: 'rendered', cards };
-      // Anonymous gate: Douyin renders a centered "登录后查看更多内容"
-      // overlay on /search/ for visitors without sessionid. Match either
-      // the literal Chinese prompt or a visible login modal/mask.
-      const text = (document.body && document.body.innerText) || '';
-      if (/登录后查看|请先登录|登录抖音|验证码|验证|verify_check|安全校验/.test(text)) return { state: 'login_wall' };
-      if (/暂无相关搜索结果|没有找到相关结果|搜索结果为空|暂无结果/.test(text)) return { state: 'empty' };
-      const modal = document.querySelector('[class*="login-mask"], [class*="LoginMask"], [class*="login-modal"], dialog[role="dialog"]');
-      if (modal && modal instanceof HTMLElement) {
-        const r = modal.getBoundingClientRect();
-        const s = getComputedStyle(modal);
-        if (r.width > 0 && r.height > 0 && s.display !== 'none' && s.visibility !== 'hidden') {
-          return { state: 'login_wall' };
-        }
-      }
-      return null;
-    };
-    const found = detectState();
-    if (found) return resolve(found);
-    const observer = new MutationObserver(() => {
-      const s = detectState();
-      if (s) { observer.disconnect(); resolve(s); }
-    });
-    observer.observe(document.body, { childList: true, subtree: true });
-    setTimeout(() => {
-      observer.disconnect();
-      const fallback = detectState();
-      resolve(fallback ?? { state: 'timeout' });
-    }, ${timeoutMs});
-  })
-`;
-
-function unwrapEvaluateResult(payload) {
-    if (payload && !Array.isArray(payload) && typeof payload === 'object' && 'session' in payload && 'data' in payload) {
-        return payload.data;
-    }
-    return payload;
-}
-
-cli({
-    site: 'douyin',
-    name: 'search',
-    access: 'read',
-    description: '关键词搜索抖音视频',
-    domain: 'www.douyin.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'query', required: true, positional: true, help: '搜索关键词' },
-        { name: 'limit', type: 'int', default: 10, help: `结果数量 (1-${MAX_SEARCH_LIMIT})` },
-    ],
-    columns: ['rank', 'desc', 'author', 'url', 'plays', 'likes', 'comments', 'shares'],
-    func: async (page, kwargs) => {
-        const limit = parseSearchLimit(kwargs.limit);
-        const keyword = String(kwargs.query ?? '').trim();
-        if (!keyword) {
-            throw new ArgumentError('douyin search 需要 <query> 关键词');
-        }
-        await page.goto(`https://www.douyin.com/search/${encodeURIComponent(keyword)}?type=video`);
-        let result;
-        try {
-            result = unwrapEvaluateResult(await page.evaluate(WAIT_AND_EXTRACT_JS(RENDER_TIMEOUT_MS)));
-        } catch (error) {
-            throw new CommandExecutionError(`Douyin search extraction failed: ${error instanceof Error ? error.message : String(error)}`);
-        }
-        if (!result || typeof result !== 'object') {
-            throw new CommandExecutionError('Douyin search: unexpected evaluator payload shape');
-        }
-        if (result.state === 'login_wall') {
-            throw new AuthRequiredError(
-                'www.douyin.com',
-                'Douyin search results are blocked behind a login wall — log in at https://www.douyin.com in Chrome first.',
-            );
-        }
-        if (result.state === 'empty') {
-            throw new EmptyResultError('douyin search', `No Douyin videos matched "${keyword}".`);
-        }
-        if (result.state === 'timeout') {
-            throw new CommandExecutionError('Douyin search did not render result cards within the timeout. Open the same search in Chrome and verify login/security state before retrying.');
-        }
-        if (!Array.isArray(result.cards)) {
-            throw new CommandExecutionError('Douyin search: evaluator returned malformed cards payload');
-        }
-        if (result.cards.length === 0) {
-            throw new EmptyResultError('douyin search', `No Douyin videos matched "${keyword}".`);
-        }
-        const projected = projectSearchCards(result.cards, limit);
-        if (projected.invalidCount > 0) {
-            throw new CommandExecutionError('Douyin search parser found result cards without stable video url or description');
-        }
-        if (projected.rows.length === 0) {
-            throw new EmptyResultError('douyin search', `No Douyin videos matched "${keyword}".`);
-        }
-        return projected.rows;
-    },
-});

package/clis/douyin/search.test.js

@@ -1,307 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import {
-    extractDouyinVideoId,
-    MAX_SEARCH_LIMIT,
-    normalizeDouyinVideoUrl,
-    parseDouyinCount,
-    parseSearchLimit,
-    projectCard,
-    projectSearchCards,
-} from './search.js';
-
-function createPageMock({ evaluateResult } = {}) {
-    return {
-        goto: vi.fn().mockResolvedValue(undefined),
-        wait: vi.fn().mockResolvedValue(undefined),
-        evaluate: vi.fn().mockResolvedValue(evaluateResult),
-    };
-}
-
-describe('douyin search', () => {
-    it('registers the command on www.douyin.com', () => {
-        const registry = getRegistry();
-        const cmd = [...registry.values()].find((c) => c.site === 'douyin' && c.name === 'search');
-        expect(cmd).toBeDefined();
-        expect(cmd?.domain).toBe('www.douyin.com');
-    });
-
-    it('rejects invalid limit before navigation', async () => {
-        const cmd = getRegistry().get('douyin/search');
-        const page = createPageMock();
-        await expect(cmd.func(page, { query: '咖啡', limit: 0 })).rejects.toMatchObject({
-            code: 'ARGUMENT',
-            message: expect.stringContaining('--limit'),
-        });
-        expect(page.goto).not.toHaveBeenCalled();
-        expect(page.evaluate).not.toHaveBeenCalled();
-    });
-
-    it('rejects limit above MAX_SEARCH_LIMIT', () => {
-        expect(() => parseSearchLimit(MAX_SEARCH_LIMIT + 1)).toThrow(/--limit/);
-    });
-
-    it('rejects an empty query', async () => {
-        const cmd = getRegistry().get('douyin/search');
-        const page = createPageMock();
-        await expect(cmd.func(page, { query: '   ', limit: 5 })).rejects.toMatchObject({
-            code: 'ARGUMENT',
-        });
-        expect(page.goto).not.toHaveBeenCalled();
-    });
-
-    it('returns ranked cards from the rendered scroll-list', async () => {
-        const cmd = getRegistry().get('douyin/search');
-        const page = createPageMock({
-            evaluateResult: {
-                state: 'rendered',
-                cards: [
-                    {
-                        url: '//www.douyin.com/video/7585120459717365001',
-                        leafTexts: [
-                            '合集',
-                            '03:55',
-                            '1.9万',
-                            'Python邪修，5分钟学完Python基础 #python #编程',
-                            '@',
-                            '校长讲python（无小号）',
-                            '5月前',
-                        ],
-                    },
-                ],
-            },
-        });
-        const rows = await cmd.func(page, { query: 'python', limit: 5 });
-        expect(page.goto).toHaveBeenCalledWith('https://www.douyin.com/search/python?type=video');
-        expect(rows).toEqual([
-            {
-                rank: 1,
-                desc: 'Python邪修，5分钟学完Python基础 #python #编程',
-                author: '校长讲python（无小号）',
-                url: 'https://www.douyin.com/video/7585120459717365001',
-                plays: 0,
-                likes: 19000,
-                comments: 0,
-                shares: 0,
-            },
-        ]);
-    });
-
-    it('encodes Chinese keywords in the URL path', async () => {
-        const cmd = getRegistry().get('douyin/search');
-        const page = createPageMock({ evaluateResult: { state: 'rendered', cards: [{ url: '/video/1', leafTexts: ['hi'] }] } });
-        await cmd.func(page, { query: 'AI 编程', limit: 1 });
-        expect(page.goto).toHaveBeenCalledWith('https://www.douyin.com/search/AI%20%E7%BC%96%E7%A8%8B?type=video');
-    });
-
-    it('respects --limit cap when the page rendered more cards than requested', async () => {
-        const cmd = getRegistry().get('douyin/search');
-        const cards = Array.from({ length: 12 }, (_, i) => ({
-            url: `//www.douyin.com/video/100000${i}`,
-            leafTexts: ['03:00', `${i + 1}万`, `video ${i}`, '@', `user${i}`],
-        }));
-        const page = createPageMock({ evaluateResult: { state: 'rendered', cards } });
-        const rows = await cmd.func(page, { query: 'x', limit: 3 });
-        expect(rows).toHaveLength(3);
-        expect(rows.map((r) => r.url)).toEqual([
-            'https://www.douyin.com/video/1000000',
-            'https://www.douyin.com/video/1000001',
-            'https://www.douyin.com/video/1000002',
-        ]);
-    });
-
-    it('maps the explicit login-wall state to AuthRequiredError', async () => {
-        const cmd = getRegistry().get('douyin/search');
-        const page = createPageMock({ evaluateResult: { state: 'login_wall' } });
-        await expect(cmd.func(page, { query: 'x', limit: 1 })).rejects.toMatchObject({
-            code: 'AUTH_REQUIRED',
-            message: expect.stringContaining('login wall'),
-        });
-    });
-
-    it('maps explicit empty search state to EmptyResultError', async () => {
-        const cmd = getRegistry().get('douyin/search');
-        const page = createPageMock({ evaluateResult: { state: 'empty' } });
-        await expect(cmd.func(page, { query: 'x', limit: 1 })).rejects.toMatchObject({
-            code: 'EMPTY_RESULT',
-        });
-    });
-
-    it('maps timeout state to CommandExecutionError instead of treating parser drift as auth or empty', async () => {
-        const cmd = getRegistry().get('douyin/search');
-        const page = createPageMock({ evaluateResult: { state: 'timeout' } });
-        await expect(cmd.func(page, { query: 'x', limit: 1 })).rejects.toMatchObject({
-            code: 'COMMAND_EXEC',
-        });
-    });
-
-    it('unwraps Browser Bridge {session, data} envelopes before inspecting state', async () => {
-        const cmd = getRegistry().get('douyin/search');
-        const page = createPageMock({
-            evaluateResult: {
-                session: 'site:douyin',
-                data: { state: 'rendered', cards: [{ url: '/video/9', leafTexts: ['demo'] }] },
-            },
-        });
-        const rows = await cmd.func(page, { query: 'x', limit: 1 });
-        expect(rows).toHaveLength(1);
-        expect(rows[0].url).toBe('https://www.douyin.com/video/9');
-    });
-
-    it('throws CommandExecutionError on malformed evaluator payload', async () => {
-        const cmd = getRegistry().get('douyin/search');
-        const page = createPageMock({ evaluateResult: 'not-an-object' });
-        await expect(cmd.func(page, { query: 'x', limit: 1 })).rejects.toMatchObject({
-            code: 'COMMAND_EXEC',
-        });
-    });
-
-    it('throws CommandExecutionError on malformed cards payload', async () => {
-        const cmd = getRegistry().get('douyin/search');
-        const page = createPageMock({ evaluateResult: { state: 'rendered', cards: { bad: true } } });
-        await expect(cmd.func(page, { query: 'x', limit: 1 })).rejects.toMatchObject({
-            code: 'COMMAND_EXEC',
-        });
-    });
-
-    it('fails closed instead of partially returning cards missing stable url or desc', async () => {
-        const cmd = getRegistry().get('douyin/search');
-        const page = createPageMock({
-            evaluateResult: {
-                state: 'rendered',
-                cards: [
-                    { url: '/video/123', leafTexts: ['03:00', 'valid desc'] },
-                    { url: 'https://evil.test/video/456', leafTexts: ['03:00', 'invalid url'] },
-                ],
-            },
-        });
-        await expect(cmd.func(page, { query: 'x', limit: 2 })).rejects.toMatchObject({
-            code: 'COMMAND_EXEC',
-        });
-    });
-
-    it('fails closed when a card only has metadata text and no stable desc', async () => {
-        const cmd = getRegistry().get('douyin/search');
-        const page = createPageMock({
-            evaluateResult: {
-                state: 'rendered',
-                cards: [
-                    { url: '/video/123', leafTexts: ['合集', '03:00', '1.2万', '@', '作者名', '5月前'] },
-                ],
-            },
-        });
-        await expect(cmd.func(page, { query: 'x', limit: 1 })).rejects.toMatchObject({
-            code: 'COMMAND_EXEC',
-        });
-    });
-});
-
-describe('parseDouyinCount', () => {
-    it.each([
-        ['1.9万', 19_000],
-        ['3万', 30_000],
-        ['4702', 4702],
-        ['1,234', 1234],
-        ['1.2亿', 120_000_000],
-        ['', 0],
-        ['unknown', 0],
-        [null, 0],
-        [undefined, 0],
-    ])('parses %j as %i', (input, expected) => {
-        expect(parseDouyinCount(input)).toBe(expected);
-    });
-});
-
-describe('normalizeDouyinVideoUrl', () => {
-    it.each([
-        ['//www.douyin.com/video/123', 'https://www.douyin.com/video/123'],
-        ['/video/123?foo=bar', 'https://www.douyin.com/video/123'],
-        ['https://www.douyin.com/video/123?something', 'https://www.douyin.com/video/123'],
-        ['https://evil.test/video/123', ''],
-        ['https://www.douyin.com/user/video/123', ''],
-        ['', ''],
-        [null, ''],
-    ])('normalizes %j → %j', (input, expected) => {
-        expect(normalizeDouyinVideoUrl(input)).toBe(expected);
-    });
-
-    it('extracts only stable Douyin video ids', () => {
-        expect(extractDouyinVideoId('https://www.douyin.com/video/123')).toBe('123');
-        expect(extractDouyinVideoId('//www.douyin.com/video/456')).toBe('456');
-        expect(extractDouyinVideoId('https://evil.test/video/123')).toBe('');
-    });
-});
-
-describe('projectCard', () => {
-    it('extracts duration/likes/desc/author by leaf-text shape, classname-agnostic', () => {
-        const row = projectCard({
-            url: '//www.douyin.com/video/7585120459717365001',
-            leafTexts: ['合集', '03:55', '1.9万', 'Python邪修', '@', '校长', '5月前'],
-        }, 0);
-        expect(row).toEqual({
-            rank: 1,
-            desc: 'Python邪修',
-            author: '校长',
-            url: 'https://www.douyin.com/video/7585120459717365001',
-            plays: 0,
-            likes: 19000,
-            comments: 0,
-            shares: 0,
-        });
-    });
-
-    it('returns the longest non-skipped text as desc, not the publish-date suffix', () => {
-        const row = projectCard({
-            url: '/video/1',
-            leafTexts: ['02:00', '4702', 'hi long-text', '@', 'user', '1月前'],
-        }, 0);
-        expect(row.desc).toBe('hi long-text');
-        expect(row.author).toBe('user');
-    });
-
-    it('strips a fused @author prefix from the desc when present', () => {
-        const row = projectCard({
-            url: '/video/1',
-            leafTexts: ['02:00', '100', '@alice this is the caption', '@', 'alice'],
-        }, 0);
-        expect(row.author).toBe('alice');
-        expect(row.desc).toBe('this is the caption');
-    });
-
-    it('returns safe defaults when leafTexts is missing', () => {
-        const row = projectCard({ url: '/video/42', leafTexts: undefined }, 4);
-        expect(row).toEqual({
-            rank: 5,
-            desc: '',
-            author: '',
-            url: 'https://www.douyin.com/video/42',
-            plays: 0,
-            likes: 0,
-            comments: 0,
-            shares: 0,
-        });
-    });
-
-    it('returns rank=index+1 regardless of input', () => {
-        const row = projectCard({ url: '/video/1', leafTexts: ['x'] }, 9);
-        expect(row.rank).toBe(10);
-    });
-
-    it('projects cards and reports malformed rows in the returned window', () => {
-        const result = projectSearchCards([
-            { url: '/video/1', leafTexts: ['caption'] },
-            { url: '/video/not-numeric', leafTexts: ['bad'] },
-            { url: '/video/3', leafTexts: [] },
-        ], 3);
-        expect(result.rows).toHaveLength(1);
-        expect(result.invalidCount).toBe(2);
-    });
-
-    it('does not treat metadata-only leaf text as a stable desc', () => {
-        const result = projectSearchCards([
-            { url: '/video/1', leafTexts: ['合集', '03:55', '1.9万', '@', '校长', '5月前'] },
-        ], 1);
-        expect(result.rows).toHaveLength(0);
-        expect(result.invalidCount).toBe(1);
-    });
-});

package/clis/douyin/stats.js

@@ -1,28 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { browserFetch } from './_shared/browser-fetch.js';
-cli({
-    site: 'douyin',
-    name: 'stats',
-    access: 'read',
-    description: '作品数据分析',
-    domain: 'creator.douyin.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'aweme_id', required: true, positional: true, help: '抖音作品 ID（aweme_id，可从作品 URL 末尾获取）' },
-    ],
-    columns: ['metric', 'value'],
-    func: async (page, kwargs) => {
-        const now = Math.floor(Date.now() / 1000);
-        const sevenDaysAgo = now - 7 * 86400;
-        const url = 'https://creator.douyin.com/janus/douyin/creator/data/item_analysis/metrics_trend';
-        const body = {
-            aweme_id: kwargs.aweme_id,
-            start_time: sevenDaysAgo,
-            end_time: now,
-            metrics: ['play_count', 'like_count', 'comment_count', 'share_count'],
-        };
-        const res = await browserFetch(page, 'POST', url, { body });
-        const data = res.data ?? {};
-        return Object.entries(data).map(([metric, value]) => ({ metric, value }));
-    },
-});