@jackwener/opencli 1.6.1 → 1.6.3

package/dist/clis/1688/item.d.ts

@@ -0,0 +1,70 @@
+interface BuyerProtectionModel {
+    serviceName?: string;
+    shortBuyerDesc?: string;
+    packageBuyerDesc?: string;
+    textDesc?: string;
+    agreeDeliveryHours?: number;
+}
+interface ItemBrowserPayload {
+    href?: string;
+    title?: string;
+    bodyText?: string;
+    offerTitle?: string;
+    offerId?: string | number;
+    seller?: {
+        companyName?: string;
+        memberId?: string;
+        winportUrl?: string;
+        sellerWinportUrlMap?: Record<string, string>;
+    };
+    trade?: {
+        beginAmount?: string | number;
+        priceDisplay?: string;
+        unit?: string;
+        saleCount?: string | number;
+        offerIDatacenterSellInfo?: Record<string, unknown>;
+        offerPriceModel?: {
+            currentPrices?: Array<{
+                beginAmount?: string | number;
+                price?: string | number;
+            }>;
+        };
+    };
+    gallery?: {
+        mainImage?: string[];
+        offerImgList?: string[];
+        wlImageInfos?: Array<{
+            fullPathImageURI?: string;
+        }>;
+    };
+    shipping?: {
+        deliveryLimitText?: string;
+        logisticsText?: string;
+        protectionInfos?: BuyerProtectionModel[];
+        buyerProtectionModel?: BuyerProtectionModel[];
+    };
+    services?: BuyerProtectionModel[];
+}
+interface VisibleAttribute {
+    key: string;
+    value: string;
+}
+declare function normalizeItemPayload(payload: ItemBrowserPayload): Record<string, unknown>;
+declare function normalizeVisibleAttributes(raw: unknown): VisibleAttribute[];
+declare function stripAlibabaSuffix(title: string | undefined): string;
+declare function extractMoqText(bodyText: string, beginAmount: string | number | undefined, unit: string): string;
+declare function extractDeliveryDaysText(bodyText: string, services: BuyerProtectionModel[], shipping: ItemBrowserPayload['shipping']): string | null;
+declare function extractKeywordLine(bodyText: string, keywords: string[]): string | null;
+declare function extractSalesText(bodyText: string): string | null;
+declare function extractStockQuantity(bodyText: string): number | null;
+export declare const __test__: {
+    normalizeItemPayload: typeof normalizeItemPayload;
+    normalizeVisibleAttributes: typeof normalizeVisibleAttributes;
+    stripAlibabaSuffix: typeof stripAlibabaSuffix;
+    extractMoqText: typeof extractMoqText;
+    extractDeliveryDaysText: typeof extractDeliveryDaysText;
+    extractKeywordLine: typeof extractKeywordLine;
+    extractSalesText: typeof extractSalesText;
+    extractStockQuantity: typeof extractStockQuantity;
+};
+export {};

package/dist/clis/1688/item.js

@@ -0,0 +1,187 @@
+import { CommandExecutionError } from '../../src/errors.js';
+import { cli, Strategy } from '../../src/registry.js';
+import { isRecord } from '../../src/utils.js';
+import { assertAuthenticatedState, buildDetailUrl, buildProvenance, canonicalizeSellerUrl, cleanMultilineText, cleanText, extractLocation, extractMemberId, extractOfferId, extractShopId, gotoAndReadState, normalizePriceTiers, parseMoqText, parsePriceText, toNumber, uniqueNonEmpty, } from './shared.js';
+function normalizeItemPayload(payload) {
+    const href = cleanText(payload.href);
+    const bodyText = cleanMultilineText(payload.bodyText);
+    const sellerName = cleanText(payload.seller?.companyName);
+    const sellerUrlRaw = cleanText(payload.seller?.winportUrl
+        ?? payload.seller?.sellerWinportUrlMap?.defaultUrl
+        ?? payload.seller?.sellerWinportUrlMap?.indexUrl);
+    const sellerUrl = canonicalizeSellerUrl(sellerUrlRaw);
+    const offerId = cleanText(String(payload.offerId ?? '')) || extractOfferId(href) || null;
+    const memberId = cleanText(payload.seller?.memberId) || extractMemberId(sellerUrlRaw || href) || null;
+    const shopId = extractShopId(sellerUrl ?? href);
+    const unit = cleanText(payload.trade?.unit);
+    const priceDisplay = cleanText(payload.trade?.priceDisplay);
+    const priceRange = parsePriceText(priceDisplay ? `¥${priceDisplay}` : bodyText);
+    const moqText = extractMoqText(bodyText, payload.trade?.beginAmount, unit);
+    const moq = parseMoqText(moqText);
+    const services = uniqueServices(payload);
+    const serviceBadges = uniqueNonEmpty(services.map((service) => cleanText(service.serviceName)));
+    const attributes = normalizeVisibleAttributes(payload.trade?.offerIDatacenterSellInfo);
+    const priceTiers = normalizePriceTiers(payload.trade?.offerPriceModel?.currentPrices ?? [], unit || null);
+    const images = uniqueNonEmpty([
+        ...(payload.gallery?.mainImage ?? []),
+        ...(payload.gallery?.offerImgList ?? []),
+        ...((payload.gallery?.wlImageInfos ?? []).map((item) => item.fullPathImageURI ?? '')),
+    ]);
+    const detailUrl = offerId ? buildDetailUrl(offerId) : href;
+    const provenance = buildProvenance(href || detailUrl);
+    return {
+        offer_id: offerId,
+        member_id: memberId,
+        shop_id: shopId,
+        title: cleanText(payload.offerTitle) || stripAlibabaSuffix(payload.title) || firstNonEmptyLine(bodyText) || null,
+        item_url: detailUrl,
+        main_images: images,
+        price_text: priceRange.price_text || null,
+        price_tiers: priceTiers,
+        currency: priceRange.currency,
+        moq_text: moq.moq_text || null,
+        moq_value: moq.moq_value,
+        seller_name: sellerName || null,
+        seller_url: sellerUrl,
+        shop_name: sellerName || null,
+        origin_place: extractLocation(bodyText),
+        delivery_days_text: extractDeliveryDaysText(bodyText, services, payload.shipping),
+        customization_text: extractKeywordLine(bodyText, ['来样定制', '来图定制', '支持定制', '可定制', '定制']),
+        private_label_text: extractKeywordLine(bodyText, ['贴牌', '贴标', '定制logo', '打logo', 'OEM', 'ODM']),
+        visible_attributes: attributes,
+        sales_text: extractSalesText(bodyText),
+        service_badges: serviceBadges,
+        stock_quantity: extractStockQuantity(bodyText),
+        ...provenance,
+    };
+}
+function normalizeVisibleAttributes(raw) {
+    if (!isRecord(raw))
+        return [];
+    return Object.entries(raw)
+        .filter(([key, value]) => key !== 'sellPointModel' && cleanText(key) && cleanText(String(value)))
+        .map(([key, value]) => ({ key: cleanText(key), value: cleanText(String(value)) }));
+}
+function uniqueServices(payload) {
+    const combined = [
+        ...(Array.isArray(payload.services) ? payload.services : []),
+        ...(Array.isArray(payload.shipping?.protectionInfos) ? payload.shipping.protectionInfos : []),
+        ...(Array.isArray(payload.shipping?.buyerProtectionModel) ? payload.shipping.buyerProtectionModel : []),
+    ];
+    const seen = new Set();
+    const result = [];
+    for (const service of combined) {
+        const key = cleanText(service.serviceName);
+        if (!key || seen.has(key))
+            continue;
+        seen.add(key);
+        result.push(service);
+    }
+    return result;
+}
+function stripAlibabaSuffix(title) {
+    return cleanText(title).replace(/\s*-\s*阿里巴巴$/, '').trim();
+}
+function firstNonEmptyLine(text) {
+    return text.split('\n').map((line) => cleanText(line)).find(Boolean) ?? '';
+}
+function extractMoqText(bodyText, beginAmount, unit) {
+    const lineMatch = bodyText.match(/\d+(?:\.\d+)?\s*(件|个|套|箱|包|双|台|把|只)\s*起批/);
+    if (lineMatch)
+        return lineMatch[0];
+    const moqValue = toNumber(beginAmount);
+    if (moqValue !== null) {
+        return `${moqValue}${unit || ''}起批`;
+    }
+    return '';
+}
+function extractDeliveryDaysText(bodyText, services, shipping) {
+    const shippingText = cleanText(shipping?.deliveryLimitText) || cleanText(shipping?.logisticsText);
+    if (shippingText)
+        return shippingText;
+    const textMatch = bodyText.match(/\d+\s*(?:小时|天)(?:内)?发货/);
+    if (textMatch)
+        return textMatch[0];
+    const hourMatch = services.find((service) => typeof service.agreeDeliveryHours === 'number');
+    if (hourMatch && typeof hourMatch.agreeDeliveryHours === 'number') {
+        return `${hourMatch.agreeDeliveryHours}小时内发货`;
+    }
+    return null;
+}
+function extractKeywordLine(bodyText, keywords) {
+    const lines = bodyText.split('\n').map((line) => cleanText(line)).filter(Boolean);
+    for (const line of lines) {
+        if (keywords.some((keyword) => line.includes(keyword))) {
+            return line;
+        }
+    }
+    return null;
+}
+function extractSalesText(bodyText) {
+    const match = bodyText.match(/(?:全网销量|已售)\s*\d+(?:\.\d+)?\+?\s*[件套个单]?/);
+    return match ? cleanText(match[0]) : null;
+}
+function extractStockQuantity(bodyText) {
+    const match = bodyText.match(/库存\s*(\d+)/);
+    return match ? Number.parseInt(match[1], 10) : null;
+}
+async function readItemPayload(page, itemUrl) {
+    const state = await gotoAndReadState(page, itemUrl, 2500, 'item');
+    assertAuthenticatedState(state, 'item');
+    const payload = await page.evaluate(`
+    (() => {
+      const root = window.context ?? {};
+      const model = root.result?.global?.globalData?.model ?? null;
+      const toJson = (value) => JSON.parse(JSON.stringify(value ?? null));
+      return {
+        href: window.location.href,
+        title: document.title || '',
+        bodyText: document.body ? document.body.innerText || '' : '',
+        offerTitle: model?.offerTitleModel?.subject ?? '',
+        offerId: model?.tradeModel?.offerId ?? '',
+        seller: toJson(model?.sellerModel),
+        trade: toJson(model?.tradeModel),
+        gallery: toJson(root.result?.data?.gallery?.fields ?? null),
+        shipping: toJson(root.result?.data?.shippingServices?.fields ?? null),
+        services: toJson(root.result?.data?.shippingServices?.fields?.protectionInfos ?? []),
+      };
+    })()
+  `);
+    const resolvedOfferId = cleanText(String(payload.offerId ?? '')) || extractOfferId(cleanText(payload.href));
+    if (!resolvedOfferId) {
+        throw new CommandExecutionError('1688 item page did not expose product context', '当前 tab 非商品详情上下文，请切到 detail.1688.com 商品页并重试');
+    }
+    return payload;
+}
+cli({
+    site: '1688',
+    name: 'item',
+    description: '1688 商品详情（公开商品字段、价格阶梯、卖家基础信息）',
+    domain: 'www.1688.com',
+    strategy: Strategy.COOKIE,
+    navigateBefore: false,
+    args: [
+        {
+            name: 'input',
+            required: true,
+            positional: true,
+            help: '1688 商品 URL 或 offer ID（如 887904326744）',
+        },
+    ],
+    columns: ['offer_id', 'title', 'price_text', 'moq_text', 'seller_name', 'origin_place'],
+    func: async (page, kwargs) => {
+        const itemUrl = buildDetailUrl(String(kwargs.input ?? ''));
+        const payload = await readItemPayload(page, itemUrl);
+        return [normalizeItemPayload(payload)];
+    },
+});
+export const __test__ = {
+    normalizeItemPayload,
+    normalizeVisibleAttributes,
+    stripAlibabaSuffix,
+    extractMoqText,
+    extractDeliveryDaysText,
+    extractKeywordLine,
+    extractSalesText,
+    extractStockQuantity,
+};

package/dist/clis/1688/item.test.js

@@ -0,0 +1,67 @@
+import { describe, expect, it } from 'vitest';
+import { __test__ } from './item.js';
+describe('1688 item normalization', () => {
+    it('normalizes public item payload into contract fields', () => {
+        const result = __test__.normalizeItemPayload({
+            href: 'https://detail.1688.com/offer/887904326744.html',
+            title: '法式春季长袖开衫连衣裙女新款大码女装碎花吊带裙套装142077 - 阿里巴巴',
+            bodyText: `
+        青岛沁澜衣品服装有限公司
+        入驻13年
+        主营：大码女装
+        店铺回头率
+        87%
+        山东青岛
+        3套起批
+        已售1600+套
+        支持定制logo
+      `,
+            offerTitle: '法式春季长袖开衫连衣裙女新款大码女装碎花吊带裙套装142077',
+            offerId: 887904326744,
+            seller: {
+                companyName: '青岛沁澜衣品服装有限公司',
+                memberId: 'b2b-1641351767',
+                winportUrl: 'https://yinuoweierfushi.1688.com/page/index.html?spm=a1',
+            },
+            trade: {
+                beginAmount: 3,
+                priceDisplay: '96.00-98.00',
+                unit: '套',
+                saleCount: 1655,
+                offerIDatacenterSellInfo: {
+                    面料名称: '莫代尔',
+                    主面料成分: '莫代尔纤维',
+                    sellPointModel: '{"ignore":true}',
+                },
+                offerPriceModel: {
+                    currentPrices: [
+                        { beginAmount: 3, price: '98.00' },
+                        { beginAmount: 50, price: '97.00' },
+                    ],
+                },
+            },
+            gallery: {
+                mainImage: ['https://example.com/1.jpg'],
+                offerImgList: ['https://example.com/2.jpg'],
+                wlImageInfos: [{ fullPathImageURI: 'https://example.com/3.jpg' }],
+            },
+            services: [
+                { serviceName: '延期必赔', agreeDeliveryHours: 360 },
+                { serviceName: '品质保障' },
+            ],
+        });
+        expect(result.offer_id).toBe('887904326744');
+        expect(result.member_id).toBe('b2b-1641351767');
+        expect(result.shop_id).toBe('yinuoweierfushi');
+        expect(result.seller_url).toBe('https://yinuoweierfushi.1688.com');
+        expect(result.price_text).toBe('¥96.00-98.00');
+        expect(result.moq_text).toBe('3套起批');
+        expect(result.origin_place).toBe('山东青岛');
+        expect(result.delivery_days_text).toBe('360小时内发货');
+        expect(result.private_label_text).toBe('支持定制logo');
+        expect(result.visible_attributes).toEqual([
+            { key: '面料名称', value: '莫代尔' },
+            { key: '主面料成分', value: '莫代尔纤维' },
+        ]);
+    });
+});

package/dist/clis/1688/search.d.ts

@@ -0,0 +1,56 @@
+interface SearchPayload {
+    href?: string;
+    title?: string;
+    bodyText?: string;
+    next_url?: string;
+    candidates?: Array<{
+        item_url?: string;
+        title?: string;
+        container_text?: string;
+        desc_rows?: string[];
+        price_text?: string | null;
+        sales_text?: string | null;
+        hover_price_text?: string | null;
+        moq_text?: string | null;
+        tag_items?: string[];
+        hover_items?: string[];
+        seller_name?: string | null;
+        seller_url?: string | null;
+    }>;
+}
+interface SearchRow {
+    rank: number;
+    offer_id: string | null;
+    member_id: string | null;
+    shop_id: string | null;
+    title: string | null;
+    item_url: string | null;
+    seller_name: string | null;
+    seller_url: string | null;
+    price_text: string | null;
+    price_min: number | null;
+    price_max: number | null;
+    currency: string | null;
+    moq_text: string | null;
+    moq_value: number | null;
+    location: string | null;
+    badges: string[];
+    sales_text: string | null;
+    return_rate_text: string | null;
+    source_url: string;
+    fetched_at: string;
+    strategy: string;
+}
+declare function normalizeSearchCandidate(candidate: NonNullable<SearchPayload['candidates']>[number], sourceUrl: string): SearchRow;
+declare function extractMoqText(text: string | null | undefined): string;
+declare function extractSalesText(text: string | null | undefined): string;
+declare function firstWord(text: string): string;
+declare function buildDedupeKey(row: Pick<SearchRow, 'offer_id' | 'item_url'>): string | null;
+export declare const __test__: {
+    normalizeSearchCandidate: typeof normalizeSearchCandidate;
+    extractMoqText: typeof extractMoqText;
+    extractSalesText: typeof extractSalesText;
+    firstWord: typeof firstWord;
+    buildDedupeKey: typeof buildDedupeKey;
+};
+export {};

package/dist/clis/1688/search.js

@@ -0,0 +1,309 @@
+import { CommandExecutionError, EmptyResultError } from '../../src/errors.js';
+import { cli, Strategy } from '../../src/registry.js';
+import { FACTORY_BADGE_PATTERNS, SERVICE_BADGE_PATTERNS, assertAuthenticatedState, buildProvenance, buildSearchUrl, canonicalizeItemUrl, canonicalizeSellerUrl, cleanText, extractBadges, extractLocation, extractMemberId, extractOfferId, extractShopId, gotoAndReadState, parseMoqText, parsePriceText, SEARCH_LIMIT_DEFAULT, SEARCH_LIMIT_MAX, parseSearchLimit, uniqueNonEmpty, } from './shared.js';
+const SEARCH_ITEM_URL_PATTERNS = [
+    'detail.1688.com/offer/',
+    'detail.m.1688.com/page/index.html?offerId=',
+];
+const MAX_SEARCH_PAGES = 12;
+function normalizeSearchCandidate(candidate, sourceUrl) {
+    const canonicalItemUrl = canonicalizeItemUrl(cleanText(candidate.item_url));
+    const containerText = cleanText(candidate.container_text);
+    const priceText = firstNonEmpty([
+        normalizeInlineText(candidate.price_text),
+        normalizeInlineText(extractPriceText(candidate.hover_price_text)),
+    ]);
+    const priceRange = parsePriceText(priceText || containerText);
+    const moq = parseMoqText(firstNonEmpty([
+        normalizeInlineText(candidate.moq_text),
+        normalizeInlineText(extractMoqText(containerText)),
+    ]));
+    const canonicalSellerUrl = canonicalizeSellerUrl(cleanText(candidate.seller_url));
+    const evidenceText = uniqueNonEmpty([
+        containerText,
+        ...(candidate.desc_rows ?? []),
+        ...(candidate.tag_items ?? []),
+        ...(candidate.hover_items ?? []),
+    ]).join('\n');
+    const badges = extractBadges(evidenceText, [...FACTORY_BADGE_PATTERNS, ...SERVICE_BADGE_PATTERNS]);
+    const salesText = firstNonEmpty([
+        extractSalesText(candidate.sales_text),
+        extractSalesText(containerText),
+    ]);
+    const returnRateText = extractReturnRateText([...(candidate.tag_items ?? []), ...(candidate.hover_items ?? [])]);
+    const provenance = buildProvenance(sourceUrl);
+    return {
+        rank: 0,
+        offer_id: extractOfferId(canonicalItemUrl ?? '') ?? null,
+        member_id: extractMemberId(canonicalSellerUrl ?? '') ?? null,
+        shop_id: extractShopId(canonicalSellerUrl ?? '') ?? null,
+        title: cleanText(candidate.title) || firstWord(containerText) || null,
+        item_url: canonicalItemUrl,
+        seller_name: cleanText(candidate.seller_name) || null,
+        seller_url: canonicalSellerUrl,
+        price_text: priceRange.price_text || null,
+        price_min: priceRange.price_min,
+        price_max: priceRange.price_max,
+        currency: priceRange.currency,
+        moq_text: moq.moq_text || null,
+        moq_value: moq.moq_value,
+        location: extractLocation(containerText),
+        badges,
+        sales_text: salesText || null,
+        return_rate_text: returnRateText,
+        source_url: provenance.source_url,
+        fetched_at: provenance.fetched_at,
+        strategy: provenance.strategy,
+    };
+}
+function extractMoqText(text) {
+    const normalized = normalizeInlineText(text);
+    return normalized.match(/\d+(?:\.\d+)?\s*(件|个|套|箱|包|双|台|把|只)\s*起批/i)?.[0]
+        ?? normalized.match(/≥\s*\d+(?:\.\d+)?\s*(件|个|套|箱|包|双|台|把|只)?/i)?.[0]
+        ?? normalized.match(/\d+(?:\.\d+)?\s*(?:~|-|至|到)\s*\d+(?:\.\d+)?\s*(件|个|套|箱|包|双|台|把|只)/i)?.[0]
+        ?? '';
+}
+function extractPriceText(text) {
+    const normalized = normalizeInlineText(text);
+    return normalized.match(/[¥$€]\s*\d+(?:\.\d+)?/)?.[0] ?? '';
+}
+function extractSalesText(text) {
+    const normalized = normalizeInlineText(text);
+    if (!normalized)
+        return '';
+    if (/^\d+(?:\.\d+)?\+?\s*(件|套|个|单)$/.test(normalized)) {
+        return normalized;
+    }
+    const match = normalized.match(/(?:已售|销量|售)\s*\d+(?:\.\d+)?\+?\s*(件|套|个|单)?/);
+    return match ? cleanText(match[0]) : '';
+}
+function firstWord(text) {
+    return text.split(/\s+/).find(Boolean) ?? '';
+}
+function firstNonEmpty(values) {
+    return values.map((value) => cleanText(value)).find(Boolean) ?? '';
+}
+function normalizeInlineText(text) {
+    return cleanText(text)
+        .replace(/([¥$€])\s+(?=\d)/g, '$1')
+        .replace(/(\d)\s*\.\s*(\d)/g, '$1.$2')
+        .replace(/\s*([~-])\s*/g, '$1')
+        .trim();
+}
+function extractReturnRateText(values) {
+    return uniqueNonEmpty(values.map((value) => normalizeInlineText(value)))
+        .find((value) => /^回头率\s*\d+(?:\.\d+)?%$/.test(value))
+        ?? null;
+}
+function buildDedupeKey(row) {
+    if (row.offer_id)
+        return `offer:${row.offer_id}`;
+    if (row.item_url)
+        return `url:${row.item_url}`;
+    return null;
+}
+async function readSearchPayload(page, url) {
+    const state = await gotoAndReadState(page, url, 2500, 'search');
+    assertAuthenticatedState(state, 'search');
+    const payload = await page.evaluate(`
+    (() => {
+      const normalizeText = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+      const normalizeUrl = (href) => {
+        if (!href) return '';
+        try {
+          return new URL(href, window.location.href).toString();
+        } catch {
+          return '';
+        }
+      };
+      const isItemHref = (href) => ${JSON.stringify(SEARCH_ITEM_URL_PATTERNS)}
+        .some((pattern) => (href || '').includes(pattern));
+      const uniqueTexts = (values) => [...new Set(values.map((value) => normalizeText(value)).filter(Boolean))];
+      const collectTexts = (root, selector) => uniqueTexts(
+        Array.from(root.querySelectorAll(selector)).map((node) => node.innerText || node.textContent || ''),
+      );
+      const firstText = (root, selectors) => {
+        for (const selector of selectors) {
+          const node = root.querySelector(selector);
+          const value = normalizeText(node ? node.innerText || node.textContent || '' : '');
+          if (value) return value;
+        }
+        return '';
+      };
+      const findMoqText = (values, priceText) => {
+        const moqPattern = /(≥\\s*\\d+(?:\\.\\d+)?\\s*(件|个|套|箱|包|双|台|把|只)?)|(\\d+(?:\\.\\d+)?\\s*(?:~|-|至|到)\\s*\\d+(?:\\.\\d+)?\\s*(件|个|套|箱|包|双|台|把|只))|(\\d+(?:\\.\\d+)?\\s*(件|个|套|箱|包|双|台|把|只)\\s*起批)/i;
+        return values.find((value) => moqPattern.test(value))
+          || normalizeText(priceText).match(moqPattern)?.[0]
+          || '';
+      };
+      const isSellerHref = (href) => {
+        if (!href) return false;
+        try {
+          const url = new URL(href, window.location.href);
+          const host = url.hostname || '';
+          if (!host.endsWith('.1688.com')) return false;
+          if (
+            host === 's.1688.com'
+            || host === 'r.1688.com'
+            || host === 'air.1688.com'
+            || host === 'detail.1688.com'
+            || host === 'detail.m.1688.com'
+            || host === 'dj.1688.com'
+          ) {
+            return false;
+          }
+          return true;
+        } catch {
+          return false;
+        }
+      };
+      const pickContainer = (anchor) => {
+        let node = anchor;
+        while (node && node !== document.body) {
+          const text = normalizeText(node.innerText || node.textContent || '');
+          if (text.length >= 40 && text.length <= 2000) {
+            return node;
+          }
+          node = node.parentElement;
+        }
+        return anchor;
+      };
+      const collectCandidates = () => {
+        const anchors = Array.from(document.querySelectorAll('a')).filter((anchor) => isItemHref(anchor.href || ''));
+        const seen = new Set();
+        const items = [];
+        for (const anchor of anchors) {
+          const href = anchor.href || '';
+          if (!href || seen.has(href)) continue;
+          seen.add(href);
+
+          const container = pickContainer(anchor);
+          const tagItems = collectTexts(container, '.offer-tag-row .offer-desc-item');
+          const hoverItems = collectTexts(container, '.offer-hover-wrapper .offer-desc-item');
+          const sellerAnchor = Array.from(container.querySelectorAll('a'))
+            .find((link) => isSellerHref(link.href || ''));
+          const hoverPriceText = firstText(container, [
+            '.offer-hover-wrapper .hover-price-item',
+            '.offer-hover-wrapper .price-item',
+          ]);
+
+          items.push({
+            item_url: href,
+            title: firstText(container, ['.offer-title-row .title-text', '.offer-title-row'])
+              || normalizeText(anchor.innerText || anchor.textContent || ''),
+            container_text: normalizeText(container.innerText || container.textContent || ''),
+            desc_rows: collectTexts(container, '.offer-desc-row'),
+            price_text: firstText(container, ['.offer-price-row .price-item']),
+            sales_text: firstText(container, ['.offer-price-row .col-desc_after', '.offer-desc-row .col-desc_after']),
+            hover_price_text: hoverPriceText,
+            moq_text: findMoqText(hoverItems, hoverPriceText),
+            tag_items: tagItems,
+            hover_items: hoverItems,
+            seller_name: sellerAnchor ? normalizeText(sellerAnchor.innerText || sellerAnchor.textContent || '') : null,
+            seller_url: sellerAnchor ? sellerAnchor.href : null,
+          });
+        }
+        return items;
+      };
+      const findNextUrl = () => {
+        const selectors = [
+          'a.fui-next:not(.disabled)',
+          'a.next-pagination-item:not(.disabled)',
+          'a[rel="next"]:not(.disabled)',
+          'a[data-role="next"]:not(.disabled)',
+        ];
+        for (const selector of selectors) {
+          const node = document.querySelector(selector);
+          if (!node) continue;
+          const href = normalizeUrl(node.getAttribute('href') || node.href || '');
+          if (href) return href;
+        }
+        const textBased = Array.from(document.querySelectorAll('a'))
+          .find((node) => /下一页|next/i.test(normalizeText(node.textContent || '')));
+        if (!textBased) return '';
+        return normalizeUrl(textBased.getAttribute('href') || textBased.href || '');
+      };
+
+      return {
+        href: window.location.href,
+        title: document.title || '',
+        bodyText: document.body ? document.body.innerText || '' : '',
+        next_url: findNextUrl(),
+        candidates: collectCandidates(),
+      };
+    })()
+  `);
+    if (!payload || typeof payload !== 'object') {
+        throw new CommandExecutionError('1688 search page did not return a readable payload', 'Open the same query in Chrome and verify the page is fully loaded before retrying.');
+    }
+    return payload;
+}
+async function collectSearchRows(page, query, limit) {
+    const rowsByKey = new Map();
+    const seenPages = new Set();
+    let nextUrl = buildSearchUrl(query);
+    let pageCount = 0;
+    while (nextUrl && rowsByKey.size < limit && pageCount < MAX_SEARCH_PAGES) {
+        if (seenPages.has(nextUrl))
+            break;
+        seenPages.add(nextUrl);
+        pageCount += 1;
+        const payload = await readSearchPayload(page, nextUrl);
+        const sourceUrl = cleanText(payload.href) || nextUrl;
+        const candidates = Array.isArray(payload.candidates) ? payload.candidates : [];
+        for (const candidate of candidates) {
+            const row = normalizeSearchCandidate(candidate, sourceUrl);
+            const dedupeKey = buildDedupeKey(row);
+            if (!dedupeKey || rowsByKey.has(dedupeKey))
+                continue;
+            rowsByKey.set(dedupeKey, row);
+            if (rowsByKey.size >= limit)
+                break;
+        }
+        const candidateNextUrl = cleanText(payload.next_url);
+        if (!candidateNextUrl || candidateNextUrl === sourceUrl)
+            break;
+        nextUrl = candidateNextUrl;
+    }
+    if (rowsByKey.size === 0) {
+        throw new EmptyResultError('1688 search', 'No visible results were extracted. Retry with a different query or open the same search page in Chrome first.');
+    }
+    return [...rowsByKey.values()]
+        .slice(0, limit)
+        .map((row, index) => ({ ...row, rank: index + 1 }));
+}
+cli({
+    site: '1688',
+    name: 'search',
+    description: '1688 商品搜索（结果候选、卖家链接、价格/MOQ/销量文本）',
+    domain: 'www.1688.com',
+    strategy: Strategy.COOKIE,
+    navigateBefore: false,
+    args: [
+        {
+            name: 'query',
+            required: true,
+            positional: true,
+            help: '搜索关键词，如 "置物架"',
+        },
+        {
+            name: 'limit',
+            type: 'int',
+            default: SEARCH_LIMIT_DEFAULT,
+            help: `结果数量上限（默认 ${SEARCH_LIMIT_DEFAULT}，最大 ${SEARCH_LIMIT_MAX}）`,
+        },
+    ],
+    columns: ['rank', 'title', 'price_text', 'moq_text', 'seller_name', 'location'],
+    func: async (page, kwargs) => {
+        const query = String(kwargs.query ?? '');
+        const limit = parseSearchLimit(kwargs.limit);
+        return collectSearchRows(page, query, limit);
+    },
+});
+export const __test__ = {
+    normalizeSearchCandidate,
+    extractMoqText,
+    extractSalesText,
+    firstWord,
+    buildDedupeKey,
+};