@agentrhq/webcmd 0.1.1 → 0.2.0

package/clis/autohome/__fixtures__/koubei.json

@@ -1,116 +0,0 @@
-{
- "baseData": {
-  "seriesname": "宝马X5",
-  "brandName": "宝马",
-  "levelname": "中大型SUV",
-  "pricerange": "59.80-74.80",
-  "average": "4.41",
-  "seriesAverage": "4.41",
-  "seriesScoreList": [
-   {
-    "typeName": "空间",
-    "typeKey": 3,
-    "score": 4.91,
-    "rank": 0
-   },
-   {
-    "typeName": "驾驶感受",
-    "typeKey": 4,
-    "score": 4.75,
-    "rank": 0
-   },
-   {
-    "typeName": "油耗",
-    "typeKey": 6,
-    "score": 4.02,
-    "rank": 0
-   },
-   {
-    "typeName": "外观",
-    "typeKey": 8,
-    "score": 4.75,
-    "rank": 0
-   },
-   {
-    "typeName": "内饰",
-    "typeKey": 9,
-    "score": 4.17,
-    "rank": 0
-   },
-   {
-    "typeName": "性价比",
-    "typeKey": 15,
-    "score": 4.22,
-    "rank": 0
-   },
-   {
-    "typeName": "配置",
-    "typeKey": 40,
-    "score": 4.02,
-    "rank": 0
-   }
-  ],
-  "cmpSeriesScore": [
-   {
-    "seriesId": 8449,
-    "newCarPPH": 0,
-    "newCarPPHUserCount": 0,
-    "seriesName": "奥迪E7X",
-    "score": "4.59",
-    "maxItemScore": "4.90",
-    "maxItemName": "动力",
-    "reliabilityPPH": 0,
-    "reliabilityPPHUserCount": 0
-   },
-   {
-    "seriesId": 8529,
-    "newCarPPH": 0,
-    "newCarPPHUserCount": 0,
-    "seriesName": "问界M6",
-    "score": "4.58",
-    "maxItemScore": "4.80",
-    "maxItemName": "空间",
-    "reliabilityPPH": 0,
-    "reliabilityPPHUserCount": 0
-   },
-   {
-    "seriesId": 8183,
-    "newCarPPH": 42,
-    "newCarPPHUserCount": 33,
-    "seriesName": "理想i6",
-    "score": "4.57",
-    "maxItemScore": "4.82",
-    "maxItemName": "空间",
-    "reliabilityPPH": 0,
-    "reliabilityPPHUserCount": 0
-   },
-   {
-    "seriesId": 8171,
-    "newCarPPH": 123,
-    "newCarPPHUserCount": 84,
-    "seriesName": "钛7",
-    "score": "4.52",
-    "maxItemScore": "4.70",
-    "maxItemName": "空间",
-    "reliabilityPPH": 0,
-    "reliabilityPPHUserCount": 0
-   },
-   {
-    "seriesId": 6643,
-    "newCarPPH": 47,
-    "newCarPPHUserCount": 53,
-    "seriesName": "问界M7",
-    "score": "4.51",
-    "maxItemScore": "4.68",
-    "maxItemName": "空间",
-    "reliabilityPPH": 0,
-    "reliabilityPPHUserCount": 0
-   }
-  ],
-  "seriesid": 6548
- },
- "qualityData": {
-  "pph": 136,
-  "userCount": 53
- }
-}

package/clis/autohome/autohome.test.js

@@ -1,115 +0,0 @@
-/**
- * Unit tests for the 汽车之家 (Autohome) adapter.
- *
- * `brand` parses the catalog HTML; `score` parses koubei __NEXT_DATA__.
- * Both pure parsers run against frozen real-data fixtures (宝马 / series 6548).
- */
-
-import { readFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { describe, expect, it } from 'vitest';
-import { getRegistry, Strategy } from '@agentrhq/webcmd/registry';
-
-import {
-    BRAND_COLUMNS,
-    SCORE_COLUMNS,
-    resolveBrandInitial,
-    normalizeSeriesId,
-    extractPageProps,
-    requireLimit,
-} from './utils.js';
-import { parseBrandSeries } from './brand.js';
-import { parseScore } from './score.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const CATALOG = readFileSync(join(__dirname, '__fixtures__/catalog.html'), 'utf8');
-const KOUBEI = JSON.parse(readFileSync(join(__dirname, '__fixtures__/koubei.json'), 'utf8'));
-
-describe('autohome adapter — registration', () => {
-    it('registers brand + score as PUBLIC (no browser)', () => {
-        for (const n of ['brand', 'score']) {
-            const cmd = getRegistry().get(`autohome/${n}`);
-            expect(cmd, n).toBeTruthy();
-            expect(cmd.strategy, n).toBe(Strategy.PUBLIC);
-            expect(cmd.browser, n).toBe(false);
-            expect(cmd.access, n).toBe('read');
-        }
-        expect(getRegistry().get('autohome/brand').columns).toEqual(BRAND_COLUMNS);
-        expect(getRegistry().get('autohome/score').columns).toEqual(SCORE_COLUMNS);
-    });
-});
-
-describe('autohome adapter — utils', () => {
-    it('resolveBrandInitial maps brands and letters', () => {
-        expect(resolveBrandInitial('宝马')).toBe('B');
-        expect(resolveBrandInitial('比亚迪')).toBe('B');
-        expect(resolveBrandInitial('理想')).toBe('L');
-        expect(resolveBrandInitial('丰田')).toBe('F');
-        expect(resolveBrandInitial('b')).toBe('B');
-        expect(() => resolveBrandInitial('不存在的牌子')).toThrow();
-        expect(() => resolveBrandInitial('')).toThrow();
-    });
-    it('normalizeSeriesId accepts numbers and URLs', () => {
-        expect(normalizeSeriesId('6548')).toBe('6548');
-        expect(normalizeSeriesId('https://k.autohome.com.cn/6548')).toBe('6548');
-        expect(normalizeSeriesId('s6548')).toBe('6548');
-        expect(() => normalizeSeriesId('宝马')).toThrow();
-    });
-    it('requireLimit rejects invalid limits instead of silently falling back', () => {
-        expect(requireLimit(undefined, 60, 120)).toBe(60);
-        expect(requireLimit('5', 60, 120)).toBe(5);
-        expect(() => requireLimit('abc', 60, 120)).toThrow(/integer/);
-        expect(() => requireLimit(121, 60, 120)).toThrow(/integer/);
-    });
-    it('extractPageProps returns null on missing blob', () => {
-        expect(extractPageProps('<html>no</html>')).toBeNull();
-    });
-});
-
-describe('autohome adapter — parsers against frozen fixtures', () => {
-    it('parseBrandSeries lists a brand\'s series with id + guide price', () => {
-        const rows = parseBrandSeries(CATALOG, '宝马', 60);
-        expect(rows.length).toBeGreaterThan(0);
-        for (const r of rows) {
-            expect(Object.keys(r).sort()).toEqual([...BRAND_COLUMNS].sort());
-            expect(r.series_id).toMatch(/^\d+$/);
-            expect(r.name).toContain('宝马');
-            expect(r.url).toContain(`/${r.series_id}/`);
-        }
-        expect(rows.some((r) => /万/.test(r.price))).toBe(true);
-    });
-
-    it('parseBrandSeries returns [] for a brand not on the page', () => {
-        expect(parseBrandSeries(CATALOG, '丰田', 60)).toEqual([]);
-    });
-
-    it('parseBrandSeries rejects catalog pages without brand blocks', () => {
-        expect(() => parseBrandSeries('<html></html>', '宝马', 60)).toThrow(/unexpected HTML shape/);
-    });
-
-    it('parseBrandSeries rejects malformed series cards', () => {
-        expect(() => parseBrandSeries('<dl><dt><div><a>宝马</a></div></dt><li id="s6548"></li></dl>', '宝马', 60))
-            .toThrow(/stable text value/);
-    });
-
-    it('parseScore builds a rating sheet with overall + axes + pph', () => {
-        const rows = parseScore(KOUBEI, '6548');
-        const map = Object.fromEntries(rows.map((r) => [r.field, r.value]));
-        expect(rows.every((r) => Object.keys(r).sort().join() === 'field,value')).toBe(true);
-        expect(map.name).toBe('宝马X5');
-        expect(map.brand).toBe('宝马');
-        expect(map.guide_price).toMatch(/万$/);
-        expect(typeof map.overall).toBe('number');
-        expect(map.overall).toBeGreaterThan(0);
-        expect(map.overall).toBeLessThanOrEqual(5);
-        // a known axis from the fixture
-        expect(typeof map['空间']).toBe('number');
-        expect(typeof map.pph_每百车故障).toBe('number');
-        expect(map.url).toContain('/6548');
-    });
-
-    it('parseScore rejects malformed koubei payloads', () => {
-        expect(() => parseScore({}, '6548')).toThrow(/unexpected payload shape/);
-    });
-});

package/clis/autohome/brand.js

@@ -1,108 +0,0 @@
-/**
- * autohome brand — list a brand's car series with guide prices.
- *
- * Fetches the brand catalog page `grade/carhtml/<INITIAL>.html` (UTF-8, fully
- * server-rendered), isolates the `<dl>` block whose `<dt>` names the brand,
- * and reads each `<li id="s<seriesId>">` series + its 指导价. Pure HTML→rows
- * so it is unit-tested against a frozen catalog slice.
- *
- * This is Autohome's login-free "search": you search by brand (the catalog is
- * brand-organized). Free-text model search is signature-gated and not offered;
- * for that, use `dongchedi search`.
- */
-
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import {
-    AH_BASE,
-    BRAND_COLUMNS,
-    CommandExecutionError,
-    EmptyResultError,
-    ahFetch,
-    clean,
-    requireLimit,
-    requireStableId,
-    requireText,
-    resolveBrandInitial,
-} from './utils.js';
-
-/**
- * Pure parser: catalog HTML + brand name → series rows. Exported for tests.
- */
-export function parseBrandSeries(html, brandName, limit) {
-    const source = String(html || '');
-    const blocks = source.match(/<dl[^>]*>[\s\S]*?<\/dl>/g);
-    if (!blocks) {
-        throw new CommandExecutionError('autohome brand catalog returned an unexpected HTML shape; expected brand <dl> blocks.');
-    }
-    const want = String(brandName || '').replace(/[·\s]/g, '');
-
-    // No brand name (single-letter catalog mode): scan the whole page.
-    // Otherwise isolate the <dl> block whose <dt> names the brand.
-    let block = html;
-    if (want) {
-        block = null;
-        for (const b of blocks) {
-            const nameM = b.match(/<dt>[\s\S]*?<div>\s*<a[^>]*>([^<]+)<\/a>/);
-            const name = nameM ? clean(nameM[1]).replace(/[·\s]/g, '') : '';
-            if (name && (name === want || name.startsWith(want) || want.startsWith(name))) {
-                block = b;
-                break;
-            }
-        }
-        if (!block) return [];
-    }
-
-    const rows = [];
-    const liRe = /<li id="s(\d+)">([\s\S]*?)<\/li>/g;
-    let m;
-    while ((m = liRe.exec(block)) !== null) {
-        const seriesId = requireStableId(m[1], `autohome brand row ${rows.length + 1}`);
-        const li = m[2];
-        const nameM = li.match(/<h4>\s*<a[^>]*>([^<]+)<\/a>/) || li.match(/<a[^>]*>([^<]+)<\/a>/);
-        const name = requireText(nameM && nameM[1], `autohome brand row ${rows.length + 1} name`);
-        const priceM = li.match(/指导价[：:]\s*<[^>]*>([^<]+)</) || li.match(/指导价[：:]\s*([^<]+)</);
-        let price = clean(priceM && priceM[1]);
-        if (/暂无|未上市|停售/.test(price)) price = '';
-        rows.push({
-            series_id: seriesId,
-            name,
-            price,
-            url: `${AH_BASE}/${seriesId}/`,
-        });
-        if (rows.length >= limit) break;
-    }
-    return rows;
-}
-
-cli({
-    site: 'autohome',
-    name: 'brand',
-    access: 'read',
-    aliases: ['series'],
-    description: '汽车之家按品牌列出全部车系 + 厂商指导价（免登录）',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'brand', required: true, positional: true, help: '品牌名（宝马 / 比亚迪 / 理想 / 丰田 …）或车系目录首字母 A-Z' },
-        { name: 'limit', type: 'int', default: 60, help: '返回的车系数量（最多 120）' },
-    ],
-    columns: BRAND_COLUMNS,
-    func: async (args) => {
-        const brand = String(args.brand || '').trim();
-        const initial = resolveBrandInitial(brand);
-        const limit = requireLimit(args.limit, 60, 120);
-
-        const html = await ahFetch(
-            `${AH_BASE}/grade/carhtml/${initial}.html`,
-            `brand ${brand}`,
-        );
-        const rows = parseBrandSeries(html, /^[A-Za-z]$/.test(brand) ? '' : brand, limit);
-        if (rows.length === 0) {
-            throw new EmptyResultError(
-                `autohome brand ${brand}`,
-                `No series found for '${brand}'. Check the brand name spelling (simplified Chinese), or try a single A-Z catalog letter.`,
-            );
-        }
-        return rows;
-    },
-});

package/clis/autohome/score.js

@@ -1,103 +0,0 @@
-/**
- * autohome score — 口碑 (owner-rating) summary for a car series.
- *
- * Reads `__NEXT_DATA__.props.pageProps.baseData` (+ `qualityData`) from the
- * koubei page `k.autohome.com.cn/<seriesId>`: overall rating, per-dimension
- * scores, level, guide price, the reliability PPH (每百辆车故障数), and the
- * competitor comparison. All unsigned, login-free. Returns a key/value sheet.
- *
- * Note: Autohome's per-review TEXT list loads from a separate signed XHR and
- * is intentionally not scraped — this command surfaces the aggregate only.
- */
-
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import {
-    AH_KOUBEI_BASE,
-    SCORE_COLUMNS,
-    CommandExecutionError,
-    EmptyResultError,
-    assertPlainObject,
-    ahFetch,
-    clean,
-    extractPageProps,
-    normalizeSeriesId,
-} from './utils.js';
-
-/** Number or null. */
-function num(v) {
-    const n = Number(v);
-    return Number.isFinite(n) ? n : null;
-}
-
-/**
- * Pure parser: koubei pageProps → field/value rows. Exported for unit tests.
- */
-export function parseScore(pp, seriesId) {
-    const bd = assertPlainObject(pp?.baseData, 'autohome baseData');
-    const qd = (pp && pp.qualityData) || {};
-
-    const competitors = (Array.isArray(bd.cmpSeriesScore) ? bd.cmpSeriesScore : [])
-        .map((c) => {
-            const name = clean(c.seriesname || c.seriesName);
-            const s = c.average || c.score;
-            return name ? `${name}(${s})` : '';
-        })
-        .filter(Boolean)
-        .slice(0, 4)
-        .join(', ');
-
-    const fields = [
-        ['series_id', String(seriesId)],
-        ['name', clean(bd.seriesname)],
-        ['brand', clean(bd.brandName)],
-        ['level', clean(bd.levelname)],
-        ['guide_price', bd.pricerange ? `${clean(bd.pricerange)}万` : ''],
-        ['overall', num(bd.average ?? bd.seriesAverage)],
-    ];
-
-    for (const axis of (Array.isArray(bd.seriesScoreList) ? bd.seriesScoreList : [])) {
-        const label = clean(axis.typeName);
-        if (label) fields.push([label, num(axis.score)]);
-    }
-
-    fields.push(['pph_每百车故障', num(qd.pph)]);
-    fields.push(['review_users', num(qd.userCount)]);
-    fields.push(['competitors', competitors]);
-    fields.push(['url', `${AH_KOUBEI_BASE}/${seriesId}`]);
-
-    return fields.map(([field, value]) => ({ field, value }));
-}
-
-cli({
-    site: 'autohome',
-    name: 'score',
-    access: 'read',
-    aliases: ['koubei', 'rating'],
-    description: '汽车之家车系口碑评分（总分 + 各维度 + 故障率PPH + 竞品对比，免登录）',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'series_id', required: true, positional: true, help: '车系 ID（来自 brand 的 series_id，或 k.autohome.com.cn/<id> URL）' },
-    ],
-    columns: SCORE_COLUMNS,
-    func: async (args) => {
-        const seriesId = normalizeSeriesId(args.series_id);
-        const html = await ahFetch(`${AH_KOUBEI_BASE}/${seriesId}`, `score ${seriesId}`);
-        const pp = extractPageProps(html);
-        if (!pp) {
-            throw new CommandExecutionError(
-                `autohome score ${seriesId}`,
-                'No koubei data found — the series id may be wrong, or Autohome changed its page.',
-            );
-        }
-        const rows = parseScore(pp, seriesId);
-        const map = Object.fromEntries(rows.map((r) => [r.field, r.value]));
-        if (!map.name && map.overall == null) {
-            throw new EmptyResultError(
-                `autohome score ${seriesId}`,
-                'This series has no koubei rating yet.',
-            );
-        }
-        return rows;
-    },
-});

package/clis/autohome/utils.js

@@ -1,157 +0,0 @@
-/**
- * Shared helpers for the 汽车之家 (Autohome) adapter.
- *
- * Autohome's keyword-search and per-trim-config JSON APIs are app-signature
- * gated (and the config page additionally uses CSS font-glyph obfuscation),
- * so those are deliberately NOT used — they cannot be read reliably without a
- * browser running Autohome's signing code, and faking partial data would be
- * worse than omitting it. Two sources ARE clean, no-login, plain-HTTP:
- *
- *   1. The brand catalog `grade/carhtml/<INITIAL>.html` — every series of a
- *      brand with its 指导价 (guide price), keyed by the brand's pinyin
- *      initial letter (hence the BRAND_INITIAL map below).
- *   2. The 口碑 page `k.autohome.com.cn/<seriesId>` — a Next.js page whose
- *      `__NEXT_DATA__.props.pageProps.baseData` carries the aggregate owner
- *      rating (overall + per-dimension), level, price, competitors, and the
- *      reliability PPH (每百辆车故障数).
- *
- * So the adapter searches by BRAND (you almost always know the brand) and
- * reads ratings by seriesId — both unsigned, both login-free.
- */
-
-import {
-    ArgumentError,
-    CommandExecutionError,
-    EmptyResultError,
-} from '@agentrhq/webcmd/errors';
-
-export const AH_BASE = 'https://www.autohome.com.cn';
-export const AH_KOUBEI_BASE = 'https://k.autohome.com.cn';
-
-const UA =
-    'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 '
-    + '(KHTML, like Gecko) Chrome/126.0 Safari/537.36';
-
-export const BRAND_COLUMNS = ['series_id', 'name', 'price', 'url'];
-export const SCORE_COLUMNS = ['field', 'value'];
-
-/**
- * 中文品牌名 → 车系目录页的拼音首字母 (grade/carhtml/<X>.html).
- * Covers the brands people actually search; unknown brands raise a clear
- * error rather than guessing the wrong page.
- */
-export const BRAND_INITIAL = {
-    奥迪: 'A', 阿斯顿马丁: 'A', 阿尔法罗密欧: 'A', 阿维塔: 'A', 埃安: 'A', 极狐: 'A',
-    宝马: 'B', 奔驰: 'B', 比亚迪: 'B', 别克: 'B', 本田: 'B', 标致: 'B', 保时捷: 'B', 宝骏: 'B', 北京: 'B', 北汽: 'B', 宾利: 'B', 北京现代: 'B',
-    长安: 'C', 长城: 'C', 长安启源: 'C', 长安欧尚: 'C', 传祺: 'C',
-    大众: 'D', 东风: 'D', 道奇: 'D', 东风风行: 'D', 东风小康: 'D',
-    法拉利: 'F', 福特: 'F', 丰田: 'F', 菲亚特: 'F', 福田: 'F', 方程豹: 'F', 飞凡: 'F',
-    广汽: 'G', 广汽丰田: 'G', 广汽本田: 'G', 高合: 'G',
-    哈弗: 'H', 红旗: 'H', 海马: 'H', 悍马: 'H', 哈飞: 'H', 华晨: 'H',
-    吉利: 'J', 捷豹: 'J', 极氪: 'J', 江淮: 'J', 几何: 'J', 捷途: 'J', 金杯: 'J', 江铃: 'J', 吉普: 'J', 极石: 'J',
-    凯迪拉克: 'K', 克莱斯勒: 'K', 开瑞: 'K', 凯翼: 'K',
-    兰博基尼: 'L', 路虎: 'L', 雷克萨斯: 'L', 林肯: 'L', 铃木: 'L', 劳斯莱斯: 'L', 雷诺: 'L', 理想: 'L', 领克: 'L', 零跑: 'L', 路特斯: 'L', 岚图: 'L', 猎豹: 'L',
-    马自达: 'M', 迈巴赫: 'M', 名爵: 'M', 玛莎拉蒂: 'M', 迈凯伦: 'M',
-    哪吒: 'N',
-    欧拉: 'O',
-    奇瑞: 'Q', 起亚: 'Q',
-    日产: 'R', 荣威: 'R',
-    斯巴鲁: 'S', 斯柯达: 'S', 三菱: 'S', 上汽大通: 'S', 思皓: 'S', 赛力斯: 'S', smart: 'S',
-    特斯拉: 'T', 腾势: 'T', 坦克: 'T',
-    沃尔沃: 'W', 五菱: 'W', 蔚来: 'W', 威马: 'W', 魏牌: 'W', 问界: 'W',
-    现代: 'X', 雪佛兰: 'X', 雪铁龙: 'X', 小鹏: 'X', 星途: 'X', 小米: 'X',
-    英菲尼迪: 'Y', 一汽: 'Y', 野马: 'Y', 仰望: 'Y',
-    智己: 'Z', 中华: 'Z', 众泰: 'Z',
-};
-
-/** Resolve a brand name to its catalog initial letter. */
-export function resolveBrandInitial(brandArg) {
-    const raw = String(brandArg || '').trim();
-    if (!raw) throw new ArgumentError('brand must be a non-empty value');
-    // single A-Z letter passes through (advanced: fetch a whole letter page)
-    if (/^[A-Za-z]$/.test(raw)) return raw.toUpperCase();
-    const key = raw.replace(/[·\s]/g, '');
-    if (BRAND_INITIAL[key]) return BRAND_INITIAL[key];
-    if (BRAND_INITIAL[raw]) return BRAND_INITIAL[raw];
-    throw new ArgumentError(
-        'brand',
-        `unknown brand '${brandArg}'. Pass a known Chinese brand name (e.g. 宝马 / 比亚迪 / 理想) or a single A-Z catalog letter.`,
-    );
-}
-
-/** Normalize a series id: a bare number or an autohome URL containing it. */
-export function normalizeSeriesId(rawInput) {
-    const raw = String(rawInput || '').trim();
-    if (!raw) throw new ArgumentError('series_id must be a non-empty value');
-    const m = raw.match(/\/(?:s)?(\d+)(?:\/|$|\.)/) || raw.match(/^s?(\d+)$/);
-    if (!m) {
-        throw new ArgumentError(`'${rawInput}' does not look like an autohome series id (a number, or a k.autohome.com.cn/<id> URL)`);
-    }
-    return m[1];
-}
-
-export function clean(s) {
-    return String(s == null ? '' : s).replace(/\s+/g, ' ').trim();
-}
-
-export function requireLimit(value, def, max) {
-    const raw = value == null || value === '' ? def : value;
-    const n = typeof raw === 'number' ? raw : Number(String(raw).trim());
-    if (!Number.isInteger(n) || n < 1 || n > max) {
-        throw new ArgumentError(`limit must be an integer between 1 and ${max}`);
-    }
-    return n;
-}
-
-export function requireStableId(value, label) {
-    const id = String(value ?? '').trim();
-    if (!/^\d+$/.test(id)) throw new CommandExecutionError(`${label} did not include a stable numeric id.`);
-    return id;
-}
-
-export function requireText(value, label) {
-    const text = clean(value);
-    if (!text) throw new CommandExecutionError(`${label} did not include a stable text value.`);
-    return text;
-}
-
-export function assertPlainObject(value, label) {
-    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-        throw new CommandExecutionError(`${label} returned an unexpected payload shape; expected an object.`);
-    }
-    return value;
-}
-
-/** Fetch an Autohome page as text. The grade + koubei pages are UTF-8. */
-export async function ahFetch(url, contextHint) {
-    let resp;
-    try {
-        resp = await fetch(url, {
-            headers: {
-                'User-Agent': UA,
-                Referer: `${AH_BASE}/`,
-                'Accept-Language': 'zh-CN,zh;q=0.9',
-            },
-        });
-    } catch (err) {
-        throw new CommandExecutionError(`autohome ${contextHint} network error: ${err?.message || err}`);
-    }
-    if (!resp.ok) {
-        throw new CommandExecutionError(`autohome ${contextHint} HTTP ${resp.status}`);
-    }
-    return resp.text();
-}
-
-/** Extract __NEXT_DATA__ pageProps from a koubei page (pure, testable). */
-export function extractPageProps(html) {
-    const m = String(html || '').match(/<script id="__NEXT_DATA__"[^>]*>([\s\S]*?)<\/script>/);
-    if (!m) return null;
-    try {
-        const data = JSON.parse(m[1]);
-        return (data && data.props && data.props.pageProps) || null;
-    } catch {
-        return null;
-    }
-}
-
-export { ArgumentError, CommandExecutionError, EmptyResultError };

package/clis/baidu-scholar/search.js

@@ -1,87 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { clampInt, requireNonEmptyQuery } from '../_shared/common.js';
-
-cli({
-    site: 'baidu-scholar',
-    name: 'search',
-    access: 'read',
-    description: '百度学术搜索',
-    domain: 'xueshu.baidu.com',
-    strategy: Strategy.PUBLIC,
-    browser: true,
-    args: [
-        { name: 'query', positional: true, required: true, help: '搜索关键词' },
-        { name: 'limit', type: 'int', default: 10, help: '返回结果数量 (max 20)' },
-    ],
-    columns: ['rank', 'title', 'authors', 'journal', 'year', 'cited', 'url'],
-    func: async (page, kwargs) => {
-        const limit = clampInt(kwargs.limit, 10, 1, 20);
-        const query = requireNonEmptyQuery(kwargs.query);
-        await page.goto(`https://xueshu.baidu.com/s?wd=${encodeURIComponent(query)}&pn=0&tn=SE_baiduxueshu_c1gjeupa`);
-        await page.wait(5);
-        const data = await page.evaluate(`
-      (async () => {
-        const normalize = v => (v || '').replace(/\\s+/g, ' ').trim();
-        for (let i = 0; i < 20; i++) {
-          if (document.querySelectorAll('.result').length > 0) break;
-          await new Promise(r => setTimeout(r, 500));
-        }
-        const results = [];
-        for (const el of document.querySelectorAll('.result')) {
-          const titleEl = el.querySelector('h3 a, .paper-title a, .t a');
-          const title = normalize(titleEl?.textContent);
-          if (!title) continue;
-
-          let url = titleEl?.getAttribute('href') || '';
-          if (url && !url.startsWith('http')) url = 'https://xueshu.baidu.com' + url;
-
-          const infoEl = el.querySelector('.paper-info');
-          const infoText = normalize(infoEl?.textContent);
-          const spans = infoEl ? Array.from(infoEl.querySelectorAll('span')) : [];
-
-          let journal = '';
-          let year = '';
-          let cited = '0';
-          const authorParts = [];
-
-          for (const span of spans) {
-            const text = normalize(span.textContent);
-            if (!text || text === '，' || text === ',') continue;
-            if (text.startsWith('《') || text.startsWith('〈')) {
-              journal = text.replace(/[《》〈〉]/g, '');
-              continue;
-            }
-            if (/^被引量[：:]/.test(text)) {
-              cited = text.match(/(\\d+)/)?.[1] || '0';
-              continue;
-            }
-            if (/^-\\s*(\\d{4})/.test(text) || /^\\d{4}年?$/.test(text)) {
-              year = text.match(/(\\d{4})/)?.[1] || '';
-              continue;
-            }
-            if (!journal && !/^被引/.test(text) && !text.startsWith('-')) {
-              authorParts.push(text);
-            }
-          }
-
-          if (!year) year = infoText.match(/(19|20)\\d{2}/)?.[0] || '';
-          if (!cited || cited === '0') cited = infoText.match(/被引量[：:]\\s*(\\d+)/)?.[1] || '0';
-
-          results.push({
-            rank: results.length + 1,
-            title,
-            authors: authorParts.join(', ').slice(0, 80),
-            journal,
-            year,
-            cited,
-            url,
-          });
-
-          if (results.length >= ${limit}) break;
-        }
-        return results;
-      })()
-    `);
-        return Array.isArray(data) ? data : [];
-    },
-});