@jackwener/opencli 1.6.9 → 1.7.0

package/dist/clis/taobao/add-cart.js

@@ -0,0 +1,149 @@
+import { AuthRequiredError } from '@jackwener/opencli/errors';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { normalizeNumericId } from '../_shared/common.js';
+cli({
+    site: 'taobao',
+    name: 'add-cart',
+    description: '淘宝加入购物车',
+    domain: 'item.taobao.com',
+    strategy: Strategy.COOKIE,
+    args: [
+        { name: 'id', positional: true, required: true, help: '商品 ID' },
+        { name: 'spec', help: '规格关键词（如 "180度" "红色 XL"），多个规格用空格分隔，模糊匹配' },
+        { name: 'dry-run', type: 'bool', default: false, help: '仅预览，不实际加入购物车' },
+    ],
+    columns: ['status', 'title', 'price', 'selected_spec', 'item_id'],
+    navigateBefore: false,
+    func: async (page, kwargs) => {
+        const itemId = normalizeNumericId(kwargs.id, 'id', '827563850178');
+        const specKeywords = kwargs.spec ? String(kwargs.spec).split(/\s+/).filter(Boolean) : [];
+        const dryRun = !!kwargs['dry-run'];
+        await page.goto('https://www.taobao.com');
+        await page.wait(2);
+        await page.evaluate(`location.href = ${JSON.stringify(`https://item.taobao.com/item.htm?id=${itemId}`)}`);
+        await page.wait(6);
+        const info = await page.evaluate(`
+      (() => {
+        const normalize = v => (v || '').replace(/\\s+/g, ' ').trim();
+        const titleEl = document.querySelector('[class*="mainTitle--"]');
+        const title = titleEl ? normalize(titleEl.textContent) : document.title.split('-')[0].trim();
+        const text = document.body?.innerText || '';
+        const priceMatch = text.match(/[￥¥]\\s*(\\d+(?:\\.\\d{1,2})?)/);
+        const price = priceMatch ? '¥' + priceMatch[1] : '';
+        return { title: title.slice(0, 80), price };
+      })()
+    `);
+        if (dryRun) {
+            return [{
+                    status: 'dry-run',
+                    title: info?.title || '',
+                    price: info?.price || '',
+                    selected_spec: specKeywords.join(' ') || '(未选择)',
+                    item_id: itemId,
+                }];
+        }
+        const specArgs = JSON.stringify(specKeywords);
+        const selectResult = await page.evaluate(`
+      (() => {
+        const normalize = v => (v || '').replace(/\\s+/g, ' ').trim();
+        const keywords = ${specArgs};
+        const items = document.querySelectorAll('[class*="valueItem--"]');
+        const selected = [];
+
+        if (keywords.length === 0 && items.length > 0) {
+          const groups = new Map();
+          for (const item of items) {
+            const group = item.closest('[class*="skuItem--"], [class*="prop--"]') || item.parentElement;
+            const groupKey = group?.className?.substring(0, 30) || 'default';
+            if (!groups.has(groupKey)) groups.set(groupKey, []);
+            groups.get(groupKey).push(item);
+          }
+          for (const [, groupItems] of groups) {
+            const hasSelected = groupItems.some(el => el.className.includes('selected') || el.className.includes('active'));
+            if (hasSelected) continue;
+            for (const item of groupItems) {
+              if (!item.className.includes('disabled') && !item.className.includes('gray')) {
+                item.click();
+                selected.push(normalize(item.textContent).substring(0, 40));
+                break;
+              }
+            }
+          }
+        } else {
+          const groups = new Map();
+          for (const item of items) {
+            const group = item.closest('[class*="skuItem--"], [class*="prop--"]') || item.parentElement;
+            const groupKey = group?.className?.substring(0, 30) || 'default';
+            if (!groups.has(groupKey)) groups.set(groupKey, []);
+            groups.get(groupKey).push(item);
+          }
+
+          for (const [, groupItems] of groups) {
+            let best = null;
+            let bestScore = 0;
+            for (const item of groupItems) {
+              if (item.className.includes('disabled')) continue;
+              const t = normalize(item.textContent);
+              const score = keywords.filter(kw => t.includes(kw)).length;
+              if (score > bestScore) { bestScore = score; best = item; }
+            }
+            if (best && bestScore > 0) {
+              best.click();
+              selected.push(normalize(best.textContent).substring(0, 40));
+            }
+          }
+        }
+        return selected;
+      })()
+    `);
+        await page.wait(1);
+        await page.evaluate(`
+      (() => {
+        const all = document.querySelectorAll('button, [role="button"], a, div, span');
+        for (const el of all) {
+          const t = (el.textContent || '').trim();
+          if ((t === '加入购物车' || t === '加入 购物车') && el.children.length < 5) {
+            el.click();
+            return 'clicked';
+          }
+        }
+        return 'btn_not_found';
+      })()
+    `);
+        const result = await page.evaluate(`
+      (async () => {
+        for (let i = 0; i < 10; i++) {
+          await new Promise(r => setTimeout(r, 500));
+          const text = document.body?.innerText || '';
+          if (text.includes('已加入购物车') || text.includes('商品已成功') || text.includes('去购物车结算') || text.includes('去购物车')) {
+            return 'success';
+          }
+          if (text.includes('请选择') || text.includes('请先选择')) {
+            return 'need_spec';
+          }
+          if (text.includes('请登录')) {
+            return 'login_required';
+          }
+        }
+        if (location.href.includes('cart')) return 'success';
+        return 'unknown';
+      })()
+    `);
+        if (result === 'login_required') {
+            throw new AuthRequiredError('taobao add-cart requires a logged-in Taobao session');
+        }
+        let status = '? 未确认';
+        if (result === 'success')
+            status = '✓ 已加入购物车';
+        else if (result === 'need_spec')
+            status = '✗ 需要选择更多规格';
+        const selectedSpec = Array.isArray(selectResult) ? selectResult.join(' | ') : '';
+        return [{
+                status,
+                title: info?.title || '',
+                price: info?.price || '',
+                selected_spec: selectedSpec || '(未选择)',
+                item_id: itemId,
+            }];
+    },
+});

package/dist/clis/taobao/cart.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/taobao/cart.js

@@ -0,0 +1,95 @@
+import { AuthRequiredError } from '@jackwener/opencli/errors';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { clampInt } from '../_shared/common.js';
+cli({
+    site: 'taobao',
+    name: 'cart',
+    description: '查看淘宝购物车',
+    domain: 'cart.taobao.com',
+    strategy: Strategy.COOKIE,
+    args: [
+        { name: 'limit', type: 'int', default: 20, help: '返回数量 (max 50)' },
+    ],
+    columns: ['index', 'title', 'price', 'spec', 'shop'],
+    navigateBefore: false,
+    func: async (page, kwargs) => {
+        const limit = clampInt(kwargs.limit, 20, 1, 50);
+        await page.goto('https://www.taobao.com');
+        await page.wait(2);
+        await page.evaluate(`location.href = 'https://cart.taobao.com/cart.htm'`);
+        await page.wait(6);
+        await page.autoScroll({ times: 3, delayMs: 1500 });
+        const data = await page.evaluate(`
+      (async () => {
+        const text = document.body?.innerText || '';
+        if (text.length < 500 || text.includes('请登录')) {
+          return { error: 'auth-required' };
+        }
+
+        const sections = text.split(/移入收藏/);
+        const results = [];
+
+        for (const section of sections) {
+          const lines = section.split('\\n').map(l => l.trim()).filter(Boolean);
+          if (lines.length < 3) continue;
+
+          let title = '';
+          let titleIdx = -1;
+          for (let i = 0; i < lines.length; i++) {
+            const l = lines[i];
+            if (l.length > 15 && l.length < 200 && !l.match(/^(删除|全选|全部商品|合计|结算|找同款|退货|￥|¥|\\d+$|颜色|尺码|规格|套餐|主板|运行)/)) {
+              if (l.length > title.length) {
+                title = l;
+                titleIdx = i;
+              }
+            }
+          }
+          if (!title) continue;
+
+          let price = '';
+          for (let i = 0; i < lines.length; i++) {
+            if (lines[i] === '￥' || lines[i] === '¥') {
+              let p = '';
+              for (let j = i + 1; j < Math.min(i + 4, lines.length); j++) {
+                if (lines[j].match(/^[\\d,.]+$/)) p += lines[j];
+                else if (lines[j] === '.') p += '.';
+                else break;
+              }
+              if (p) { price = '￥' + p; break; }
+            }
+          }
+
+          let spec = '';
+          for (const l of lines) {
+            if (l.match(/^(颜色分类|尺码|规格|套餐|主板|运行)[：:]/)) {
+              spec = l.slice(0, 40);
+              break;
+            }
+          }
+
+          let shop = '';
+          if (titleIdx > 0) {
+            const prev = lines[titleIdx - 1];
+            if (prev && prev.length > 2 && prev.length < 30 && !prev.match(/^(删除|\\d|￥|¥|券|退|满|超)/)) {
+              shop = prev;
+            }
+          }
+
+          results.push({
+            index: results.length + 1,
+            title: title.slice(0, 80),
+            price,
+            spec,
+            shop,
+          });
+          if (results.length >= ${limit}) break;
+        }
+        return { results };
+      })()
+    `);
+        if (data?.error === 'auth-required') {
+            throw new AuthRequiredError('taobao cart requires a logged-in Taobao session');
+        }
+        return Array.isArray(data?.results) ? data.results : [];
+    },
+});

package/dist/clis/taobao/commands.test.d.ts

@@ -0,0 +1,5 @@
+import './search.js';
+import './detail.js';
+import './reviews.js';
+import './cart.js';
+import './add-cart.js';

package/dist/clis/taobao/commands.test.js

@@ -0,0 +1,64 @@
+import { describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '@jackwener/opencli/registry';
+import './search.js';
+import './detail.js';
+import './reviews.js';
+import './cart.js';
+import './add-cart.js';
+function createPageMock() {
+    return {
+        goto: vi.fn().mockResolvedValue(undefined),
+        evaluate: vi.fn().mockResolvedValue({ title: 'Demo', price: '¥99' }),
+        snapshot: vi.fn().mockResolvedValue(undefined),
+        click: vi.fn().mockResolvedValue(undefined),
+        typeText: vi.fn().mockResolvedValue(undefined),
+        pressKey: vi.fn().mockResolvedValue(undefined),
+        scrollTo: vi.fn().mockResolvedValue(undefined),
+        getFormState: vi.fn().mockResolvedValue({ forms: [], orphanFields: [] }),
+        wait: vi.fn().mockResolvedValue(undefined),
+        tabs: vi.fn().mockResolvedValue([]),
+        selectTab: vi.fn().mockResolvedValue(undefined),
+        networkRequests: vi.fn().mockResolvedValue([]),
+        consoleMessages: vi.fn().mockResolvedValue([]),
+        scroll: vi.fn().mockResolvedValue(undefined),
+        autoScroll: vi.fn().mockResolvedValue(undefined),
+        installInterceptor: vi.fn().mockResolvedValue(undefined),
+        getInterceptedRequests: vi.fn().mockResolvedValue([]),
+        getCookies: vi.fn().mockResolvedValue([]),
+        screenshot: vi.fn().mockResolvedValue(''),
+        waitForCapture: vi.fn().mockResolvedValue(undefined),
+    };
+}
+describe('taobao command registration', () => {
+    it('registers all taobao shopping commands', () => {
+        for (const name of ['search', 'detail', 'reviews', 'cart', 'add-cart']) {
+            expect(getRegistry().get(`taobao/${name}`)).toBeDefined();
+        }
+    });
+});
+describe('taobao command safety', () => {
+    it('rejects invalid numeric ids before evaluating page scripts', async () => {
+        const page = createPageMock();
+        const detail = getRegistry().get('taobao/detail');
+        await expect(detail.func(page, { id: 'bad-id' })).rejects.toMatchObject({
+            name: 'ArgumentError',
+            code: 'ARGUMENT',
+        });
+        expect(page.goto).not.toHaveBeenCalled();
+        expect(page.evaluate).not.toHaveBeenCalled();
+    });
+    it('supports dry-run for add-cart without clicking add-to-cart', async () => {
+        const page = createPageMock();
+        const addCart = getRegistry().get('taobao/add-cart');
+        const result = await addCart.func(page, { id: '827563850178', 'dry-run': true, spec: '红色 XL' });
+        expect(result).toEqual([
+            expect.objectContaining({
+                status: 'dry-run',
+                item_id: '827563850178',
+            }),
+        ]);
+        expect(page.goto).toHaveBeenCalledTimes(1);
+        expect(page.goto).toHaveBeenCalledWith('https://www.taobao.com');
+        expect(page.evaluate).toHaveBeenCalledTimes(2);
+    });
+});

package/dist/clis/taobao/detail.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/taobao/detail.js

@@ -0,0 +1,70 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { normalizeNumericId } from '../_shared/common.js';
+cli({
+    site: 'taobao',
+    name: 'detail',
+    description: '淘宝商品详情',
+    domain: 'item.taobao.com',
+    strategy: Strategy.COOKIE,
+    args: [
+        { name: 'id', positional: true, required: true, help: '商品 ID' },
+    ],
+    columns: ['field', 'value'],
+    navigateBefore: false,
+    func: async (page, kwargs) => {
+        const itemId = normalizeNumericId(kwargs.id, 'id', '827563850178');
+        await page.goto('https://www.taobao.com');
+        await page.wait(2);
+        await page.evaluate(`location.href = ${JSON.stringify(`https://item.taobao.com/item.htm?id=${itemId}`)}`);
+        await page.wait(6);
+        const data = await page.evaluate(`
+      (() => {
+        const normalize = v => (v || '').replace(/\\s+/g, ' ').trim();
+        const text = document.body?.innerText || '';
+        const results = [];
+
+        const titleEl = document.querySelector('[class*="mainTitle--"]');
+        const title = titleEl ? normalize(titleEl.textContent) : document.title.split('-')[0].replace(/^【[^】]+】/, '').trim();
+        results.push({ field: '商品名称', value: title.slice(0, 100) });
+
+        const pricePattern = /[￥¥]\\s*(\\d+(?:\\.\\d{1,2})?)/g;
+        const prices = [];
+        let m;
+        while ((m = pricePattern.exec(text)) && prices.length < 3) {
+          const p = parseFloat(m[1]);
+          if (p > 0.1 && p < 100000) prices.push(p);
+        }
+        if (prices.length > 0) {
+          results.push({ field: '价格', value: '¥' + Math.min(...prices) });
+        }
+
+        const salesMatch = text.match(/(\\d+万?\\+?)\\s*人付款/) || text.match(/月销\\s*(\\d+万?\\+?)/);
+        if (salesMatch) results.push({ field: '销量', value: salesMatch[0] });
+
+        const reviewMatch = text.match(/累计评价\\s*(\\d+万?\\+?)/) || text.match(/评价[（(]\\s*(\\d+万?\\+?)/);
+        if (reviewMatch) results.push({ field: '评价数', value: reviewMatch[1] });
+
+        const ratingMatch = text.match(/(\\d+\\.\\d)\\s*(?:分|描述|物流|服务)/);
+        if (ratingMatch) results.push({ field: '店铺评分', value: ratingMatch[0] });
+
+        const shopMatch = text.match(/([\u4e00-\u9fa5A-Za-z0-9]{2,15}(?:旗舰店|专卖店|企业店|专营店))/);
+        if (shopMatch) results.push({ field: '店铺', value: shopMatch[1] });
+
+        const locMatch = text.match(/发货地[：:]*\\s*([\u4e00-\u9fa5]{2,10})/) || text.match(/([\u4e00-\u9fa5]{2,4}(?:省|市))\\s*发货/);
+        if (locMatch) results.push({ field: '发货地', value: locMatch[1] });
+
+        if (text.includes('颜色分类')) {
+          const start = text.indexOf('颜色分类');
+          const specSection = start >= 0 ? text.substring(start, start + 200) : '';
+          const specs = specSection.split('\\n').filter(l => l.trim().length > 2 && l.trim().length < 50).slice(0, 5);
+          if (specs.length) results.push({ field: '可选规格', value: specs.join(' | ') });
+        }
+
+        results.push({ field: 'ID', value: ${JSON.stringify(itemId)} });
+        results.push({ field: '链接', value: location.href.split('&')[0] });
+        return results;
+      })()
+    `);
+        return Array.isArray(data) ? data : [];
+    },
+});

package/dist/clis/taobao/reviews.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/taobao/reviews.js

@@ -0,0 +1,76 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { clampInt, normalizeNumericId } from '../_shared/common.js';
+cli({
+    site: 'taobao',
+    name: 'reviews',
+    description: '淘宝商品评价',
+    domain: 'item.taobao.com',
+    strategy: Strategy.COOKIE,
+    args: [
+        { name: 'id', positional: true, required: true, help: '商品 ID' },
+        { name: 'limit', type: 'int', default: 10, help: '返回评价数量 (max 20)' },
+    ],
+    columns: ['rank', 'user', 'content', 'date', 'spec'],
+    navigateBefore: false,
+    func: async (page, kwargs) => {
+        const itemId = normalizeNumericId(kwargs.id, 'id', '827563850178');
+        const limit = clampInt(kwargs.limit, 10, 1, 20);
+        await page.goto('https://www.taobao.com');
+        await page.wait(2);
+        await page.evaluate(`location.href = ${JSON.stringify(`https://item.taobao.com/item.htm?id=${itemId}`)}`);
+        await page.wait(6);
+        const data = await page.evaluate(`
+      (async () => {
+        const normalize = v => (v || '').replace(/\\s+/g, ' ').trim();
+        let sellerId = '';
+        const pageText = document.documentElement.innerHTML || '';
+        const sellerMatch = pageText.match(/sellerId['":\\s]+['"]?(\\d+)/) || pageText.match(/userId['":\\s]+['"]?(\\d+)/) || pageText.match(/shopId['":\\s]+['"]?(\\d+)/);
+        if (sellerMatch) sellerId = sellerMatch[1];
+
+        if (!sellerId) {
+          const shopLink = document.querySelector('a[href*="shopId="], a[href*="seller_id="], a[href*="userId="]');
+          const href = shopLink?.getAttribute('href') || '';
+          const m = href.match(/(?:shopId|seller_id|userId)=(\\d+)/);
+          if (m) sellerId = m[1];
+        }
+
+        const url = 'https://rate.tmall.com/list_detail_rate.htm?itemId=' + ${JSON.stringify(itemId)}
+          + (sellerId ? '&sellerId=' + sellerId : '')
+          + '&order=3&currentPage=1&append=0&content=1&tagId=&posi=&picture=&groupValue=&needFold=0&_ksTS=' + Date.now();
+
+        try {
+          const results = await new Promise((resolve) => {
+            const cbName = '_ocli_rate_' + Date.now();
+            let settled = false;
+            const cleanup = (value) => {
+              if (settled) return;
+              settled = true;
+              delete window[cbName];
+              script.remove();
+              resolve(value);
+            };
+            window[cbName] = (payload) => {
+              const list = payload?.rateDetail?.rateList || [];
+              cleanup(list.slice(0, ${limit}).map((item, i) => ({
+                rank: i + 1,
+                user: (item.displayUserNick || item.userNick || '').slice(0, 15),
+                content: normalize(item.rateContent || '').slice(0, 150),
+                date: (item.rateDate || '').slice(0, 10),
+                spec: normalize(item.auctionSku || '').slice(0, 40),
+              })));
+            };
+            const script = document.createElement('script');
+            script.src = url + '&callback=' + cbName;
+            script.onerror = () => cleanup([]);
+            document.head.appendChild(script);
+            setTimeout(() => cleanup([]), 10000);
+          });
+          if (results.length > 0) return results;
+        } catch {}
+
+        return [];
+      })()
+    `);
+        return Array.isArray(data) ? data : [];
+    },
+});

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

@@ -0,0 +1 @@
+export {};

package/dist/clis/taobao/search.js

@@ -0,0 +1,96 @@
+import { AuthRequiredError } from '@jackwener/opencli/errors';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { clampInt, requireNonEmptyQuery } from '../_shared/common.js';
+cli({
+    site: 'taobao',
+    name: 'search',
+    description: '淘宝商品搜索',
+    domain: 's.taobao.com',
+    strategy: Strategy.COOKIE,
+    args: [
+        { name: 'query', positional: true, required: true, help: '搜索关键词' },
+        { name: 'sort', default: 'default', choices: ['default', 'sale', 'price'], help: '排序 (default/sale销量/price价格)' },
+        { name: 'limit', type: 'int', default: 10, help: '返回结果数量 (max 40)' },
+    ],
+    columns: ['rank', 'title', 'price', 'sales', 'shop', 'location', 'item_id', 'url'],
+    navigateBefore: false,
+    func: async (page, kwargs) => {
+        const limit = clampInt(kwargs.limit, 10, 1, 40);
+        const query = requireNonEmptyQuery(kwargs.query);
+        const sortMap = { default: '', sale: '&sort=sale-desc', price: '&sort=price-asc' };
+        const sortParam = sortMap[String(kwargs.sort || 'default')] || '';
+        await page.goto('https://www.taobao.com');
+        await page.wait(2);
+        await page.evaluate(`location.href = ${JSON.stringify(`https://s.taobao.com/search?q=${encodeURIComponent(query)}${sortParam}`)}`);
+        await page.wait(8);
+        await page.autoScroll({ times: 3, delayMs: 2000 });
+        const data = await page.evaluate(`
+      (async () => {
+        const normalize = v => (v || '').replace(/\\s+/g, ' ').trim();
+        const bodyText = document.body?.innerText || '';
+        if (bodyText.length < 1000 && bodyText.includes('请登录')) {
+          return { error: 'auth-required' };
+        }
+
+        for (let i = 0; i < 30; i++) {
+          if (document.querySelectorAll('[class*="doubleCard--"]').length > 3) break;
+          await new Promise(r => setTimeout(r, 500));
+        }
+
+        const cards = document.querySelectorAll('[class*="doubleCard--"]');
+        const results = [];
+        const seenTitles = new Set();
+
+        for (const card of cards) {
+          const titleEl = card.querySelector('[class*="title--"]');
+          const title = titleEl ? normalize(titleEl.textContent) : '';
+          if (!title || title.length < 3 || seenTitles.has(title)) continue;
+          seenTitles.add(title);
+
+          const intEl = card.querySelector('[class*="priceInt--"]');
+          const floatEl = card.querySelector('[class*="priceFloat--"]');
+          let price = '';
+          if (intEl) {
+            price = '¥' + normalize(intEl.textContent) + (floatEl ? normalize(floatEl.textContent) : '');
+          }
+
+          const salesEl = card.querySelector('[class*="realSales--"]');
+          const sales = salesEl ? normalize(salesEl.textContent) : '';
+
+          const shopEl = card.querySelector('[class*="shopName--"]');
+          let shop = shopEl ? normalize(shopEl.textContent) : '';
+          shop = shop.replace(/^\\d+年老店/, '').replace(/^回头客[\\d万]+/, '');
+
+          const locEls = card.querySelectorAll('[class*="procity--"]');
+          const location = Array.from(locEls).map(el => normalize(el.textContent)).join('');
+
+          let itemId = '';
+          let wrapper = card.parentElement;
+          for (let i = 0; i < 3 && wrapper; i++) {
+            const spmId = wrapper.getAttribute('data-spm-act-id');
+            if (spmId && /^\\d{10,}$/.test(spmId)) { itemId = spmId; break; }
+            wrapper = wrapper.parentElement;
+          }
+
+          results.push({
+            rank: results.length + 1,
+            title: title.slice(0, 80),
+            price,
+            sales,
+            shop,
+            location,
+            item_id: itemId,
+            url: itemId ? 'https://item.taobao.com/item.htm?id=' + itemId : '',
+          });
+          if (results.length >= ${limit}) break;
+        }
+
+        return { results };
+      })()
+    `);
+        if (data?.error === 'auth-required') {
+            throw new AuthRequiredError('taobao search requires a logged-in Taobao session');
+        }
+        return Array.isArray(data?.results) ? data.results : [];
+    },
+});

package/dist/clis/tiktok/comment.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/tiktok/comment.js

@@ -0,0 +1,57 @@
+import { cli } from '@jackwener/opencli/registry';
+cli({
+    site: 'tiktok',
+    name: 'comment',
+    description: 'Comment on a TikTok video',
+    domain: 'www.tiktok.com',
+    args: [
+        { name: 'url', required: true, positional: true, help: 'TikTok video URL' },
+        { name: 'text', required: true, positional: true, help: 'Comment text' },
+    ],
+    columns: ['status', 'url', 'text'],
+    pipeline: [
+        { navigate: { url: '${{ args.url }}', settleMs: 6000 } },
+        { evaluate: `(async () => {
+  const url = \${{ args.url | json }};
+  const commentText = \${{ args.text | json }};
+  const wait = (ms) => new Promise(r => setTimeout(r, ms));
+
+  // Click comment icon to expand comment section
+  const commentIcon = document.querySelector('[data-e2e="comment-icon"]');
+  if (commentIcon) {
+    const cBtn = commentIcon.closest('button') || commentIcon.closest('[role="button"]') || commentIcon;
+    cBtn.click();
+    await wait(3000);
+  }
+
+  // Count existing comments for verification
+  const beforeCount = document.querySelectorAll('[data-e2e="comment-level-1"]').length;
+
+  // Find comment input
+  const input = document.querySelector('[data-e2e="comment-input"] [contenteditable="true"]') ||
+                document.querySelector('[contenteditable="true"]');
+  if (!input) throw new Error('Comment input not found - make sure you are logged in');
+
+  input.focus();
+  document.execCommand('insertText', false, commentText);
+  await wait(1000);
+
+  // Click post button
+  const btns = Array.from(document.querySelectorAll('[data-e2e="comment-post"], button'));
+  const postBtn = btns.find(function(b) {
+    var t = b.textContent.trim();
+    return t === 'Post' || t === '发布' || t === '发送';
+  });
+  if (!postBtn) throw new Error('Post button not found');
+  postBtn.click();
+  await wait(3000);
+
+  // Verify comment was posted by checking if comment count increased
+  const afterCount = document.querySelectorAll('[data-e2e="comment-level-1"]').length;
+  const posted = afterCount > beforeCount;
+
+  return [{ status: posted ? 'Commented' : 'Comment may have failed', url: url, text: commentText }];
+})()
+` },
+    ],
+});

package/dist/clis/tiktok/explore.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/tiktok/explore.js

@@ -0,0 +1,35 @@
+import { cli } from '@jackwener/opencli/registry';
+cli({
+    site: 'tiktok',
+    name: 'explore',
+    description: 'Get trending TikTok videos from explore page',
+    domain: 'www.tiktok.com',
+    args: [
+        { name: 'limit', type: 'int', default: 20, help: 'Number of videos' },
+    ],
+    columns: ['rank', 'author', 'views', 'url'],
+    pipeline: [
+        { navigate: { url: 'https://www.tiktok.com/explore', settleMs: 5000 } },
+        { evaluate: `(() => {
+  const limit = \${{ args.limit }};
+  const links = Array.from(document.querySelectorAll('a[href*="/video/"]'));
+  const seen = new Set();
+  const results = [];
+  for (const a of links) {
+    const href = a.href;
+    if (seen.has(href)) continue;
+    seen.add(href);
+    const match = href.match(/@([^/]+)\\/video\\/(\\d+)/);
+    results.push({
+      rank: results.length + 1,
+      author: match ? match[1] : '',
+      views: a.textContent.trim() || '-',
+      url: href,
+    });
+    if (results.length >= limit) break;
+  }
+  return results;
+})()
+` },
+    ],
+});