@jackwener/opencli 1.3.3 → 1.4.1

package/src/clis/instagram/search.yaml

@@ -37,7 +37,8 @@ pipeline:
           name: item.user?.full_name || '',
           verified: item.user?.is_verified ? 'Yes' : 'No',
           private: item.user?.is_private ? 'Yes' : 'No',
+          url: 'https://www.instagram.com/' + (item.user?.username || ''),
         }));
       })()
 
-columns: [rank, username, name, verified, private]
+columns: [rank, username, name, verified, private, url]

package/src/clis/jd/item.test.ts

@@ -0,0 +1,35 @@
+import { describe, expect, it } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import './item.js';
+
+describe('jd item adapter', () => {
+  const command = getRegistry().get('jd/item');
+
+  it('registers the command with correct shape', () => {
+    expect(command).toBeDefined();
+    expect(command!.site).toBe('jd');
+    expect(command!.name).toBe('item');
+    expect(command!.domain).toBe('item.jd.com');
+    expect(command!.strategy).toBe('cookie');
+    expect(typeof command!.func).toBe('function');
+  });
+
+  it('has sku as a required positional arg', () => {
+    const skuArg = command!.args.find((a) => a.name === 'sku');
+    expect(skuArg).toBeDefined();
+    expect(skuArg!.required).toBe(true);
+    expect(skuArg!.positional).toBe(true);
+  });
+
+  it('has images arg with default 10', () => {
+    const imagesArg = command!.args.find((a) => a.name === 'images');
+    expect(imagesArg).toBeDefined();
+    expect(imagesArg!.default).toBe(10);
+  });
+
+  it('includes expected columns', () => {
+    expect(command!.columns).toEqual(
+      expect.arrayContaining(['title', 'price', 'shop', 'specs', 'mainImages', 'detailImages']),
+    );
+  });
+});

package/src/clis/jd/item.ts

@@ -0,0 +1,101 @@
+/**
+ * 京东商品详情 — browser cookie, DOM scraping + evaluate.
+ *
+ * 依赖: 需要在 Chrome 已登录京东
+ * 用法: opencli jd item 100291143898
+ */
+import { cli, Strategy } from '../../registry.js';
+
+cli({
+  site: 'jd',
+  name: 'item',
+  description: '京东商品详情（价格、主图、详情图、规格参数）',
+  domain: 'item.jd.com',
+  strategy: Strategy.COOKIE,
+  args: [
+    {
+      name: 'sku',
+      required: true,
+      positional: true,
+      help: '商品 SKU ID（如 100291143898）',
+    },
+    {
+      name: 'images',
+      type: 'int',
+      default: 10,
+      help: '详情图数量（默认10）',
+    },
+  ],
+  columns: ['title', 'price', 'shop', 'specs', 'mainImages', 'detailImages'],
+  func: async (page, kwargs) => {
+    const sku = kwargs.sku;
+    const maxImages = kwargs.images as number;
+    const url = `https://item.jd.com/${sku}.html`;
+
+    await page.goto(url, { waitUntil: 'load' });
+    await page.wait(2);
+
+    // 滚动加载详情图
+    for (let i = 0; i < 6; i++) {
+      await page.evaluate(`window.scrollTo(0, ${i * 2500})`);
+      await page.wait(1);
+    }
+    await page.evaluate(`window.scrollTo(0, document.body.scrollHeight)`);
+    await page.wait(2);
+
+    const data = await page.evaluate(`
+      (() => {
+        const maxImg = ${maxImages};
+        // 尝试多种价格选择器
+        const skuMatch = location.pathname.match(/(\\d+)\\.html/);
+        const sku = skuMatch ? skuMatch[1] : '';
+        const priceEl = document.querySelector('.J-p-' + sku) ||
+                        document.querySelector('[class*="price"] [class*="num"]') ||
+                        document.querySelector('.p-price strong') ||
+                        document.querySelector('.price.jd-price');
+        const price = priceEl?.textContent?.trim() || 'not found';
+
+        // 标题
+        const title = document.querySelector('.product-title')?.textContent?.trim() ||
+                      document.title.split('-')[0].trim();
+
+        // 店铺
+        const shop = document.querySelector('.J-shop-name')?.textContent?.trim() || '京东自营';
+
+        // 所有图片
+        const allImgs = Array.from(document.querySelectorAll('img[src*="360buyimg.com"]'));
+        const srcs = allImgs.map(img => img.src).filter(Boolean);
+        const unique = [...new Set(srcs)];
+
+        // 主图
+        const mainImgs = unique
+          .filter(u => u.includes('/n1/') || u.includes('/n3/') || u.includes('/n4/') || u.includes('/img/'))
+          .slice(0, maxImg);
+
+        // 详情图
+        const detailImgs = unique
+          .filter(u => u.includes('/babel/') || u.includes('/popshop/'))
+          .slice(0, maxImg);
+
+        // 规格参数：从页面文本提取
+        const text = document.body.innerText;
+        const specMatch = text.match(/商品编号[\\s\\S]*?(?=包装清单|\\n\\n|$)/);
+        let specs = {};
+        if (specMatch) {
+          const lines = specMatch[0].split('\\n').filter(l => l.trim());
+          for (let i = 0; i < lines.length - 1; i += 2) {
+            const key = lines[i].trim();
+            const val = lines[i + 1]?.trim() || '';
+            if (key && val && key !== '商品编号') {
+              specs[key] = val;
+            }
+          }
+        }
+
+        return { title, price, shop, specs, mainImages: mainImgs, detailImages: detailImgs, totalImages: unique.length };
+      })()
+    `);
+
+    return [data];
+  },
+});

package/src/clis/jike/feed.ts

@@ -1,5 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
-import { JikePost, getPostDataJs } from './shared.js';
+import { JikePost, getPostDataJs } from './utils.js';
 
 /**
  * 即刻首页动态流适配器

package/src/clis/jike/search.ts

@@ -1,5 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
-import { JikePost, getPostDataJs } from './shared.js';
+import { JikePost, getPostDataJs } from './utils.js';
 
 /**
  * 即刻搜索适配器

package/src/clis/linkedin/search.ts

@@ -1,5 +1,6 @@
 import { cli, Strategy } from '../../registry.js';
 import type { IPage } from '../../types.js';
+import { ArgumentError, CommandExecutionError } from '../../errors.js';
 
 // ── Filter value mappings ──────────────────────────────────────────────
 
@@ -64,7 +65,7 @@ function mapFilterValues(input: unknown, mapping: Record<string, string>, label:
   const resolved = values.map(value => {
     const key = value.toLowerCase();
     const mapped = mapping[key];
-    if (!mapped) throw new Error(`Unsupported ${label}: ${value}`);
+    if (!mapped) throw new ArgumentError(`Unsupported ${label}: ${value}`);
     return mapped;
   });
   return [...new Set(resolved)];
@@ -214,7 +215,7 @@ async function resolveCompanyIds(page: IPage, input: unknown): Promise<string[]>
   }
 
   if (unresolved.length) {
-    throw new Error(`Could not resolve LinkedIn company filter: ${unresolved.join(', ')}`);
+    throw new ArgumentError(`Could not resolve LinkedIn company filter: ${unresolved.join(', ')}`);
   }
 
   return [...ids];
@@ -252,7 +253,7 @@ async function fetchJobCards(
     })()`);
 
     if (!batch || batch.error) {
-      throw new Error(batch?.error || 'LinkedIn search returned an unexpected response');
+      throw new CommandExecutionError(batch?.error || 'LinkedIn search returned an unexpected response');
     }
 
     const elements: any[] = Array.isArray(batch?.elements) ? batch.elements : [];
@@ -387,7 +388,7 @@ cli({
     const location = (kwargs.location ?? '').trim();
     const keywords = String(kwargs.query ?? '').trim();
 
-    if (!keywords) throw new Error('query is required');
+    if (!keywords) throw new ArgumentError('query is required');
 
     const searchParams = new URLSearchParams({ keywords });
     if (location) searchParams.set('location', location);

package/src/clis/linkedin/timeline.test.ts

@@ -0,0 +1,99 @@
+import { describe, expect, it } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import './timeline.js';
+
+const { parseMetric, buildPostId, mergeTimelinePosts } = await import('./timeline.js').then(
+  (m) => (m as any).__test__,
+);
+
+describe('linkedin timeline adapter', () => {
+  const command = getRegistry().get('linkedin/timeline');
+
+  it('registers the command with correct shape', () => {
+    expect(command).toBeDefined();
+    expect(command!.site).toBe('linkedin');
+    expect(command!.name).toBe('timeline');
+    expect(command!.domain).toBe('www.linkedin.com');
+    expect(command!.strategy).toBe('cookie');
+    expect(command!.browser).toBe(true);
+    expect(typeof command!.func).toBe('function');
+  });
+
+  it('has limit arg with default 20', () => {
+    const limitArg = command!.args.find((a) => a.name === 'limit');
+    expect(limitArg).toBeDefined();
+    expect(limitArg!.default).toBe(20);
+  });
+
+  it('includes expected columns', () => {
+    expect(command!.columns).toEqual(
+      expect.arrayContaining(['author', 'text', 'reactions', 'comments', 'url']),
+    );
+  });
+});
+
+describe('parseMetric', () => {
+  it('parses plain numbers', () => {
+    expect(parseMetric('42')).toBe(42);
+    expect(parseMetric('1,234')).toBe(1234);
+  });
+
+  it('handles k/m suffixes', () => {
+    expect(parseMetric('2.5k')).toBe(2500);
+    expect(parseMetric('1.2M')).toBe(1200000);
+  });
+
+  it('returns 0 for empty/undefined', () => {
+    expect(parseMetric('')).toBe(0);
+    expect(parseMetric(undefined)).toBe(0);
+    expect(parseMetric(null)).toBe(0);
+  });
+});
+
+describe('buildPostId', () => {
+  it('uses url when present', () => {
+    expect(buildPostId({ url: 'https://linkedin.com/post/123' })).toBe(
+      'https://linkedin.com/post/123',
+    );
+  });
+
+  it('falls back to composite key', () => {
+    const id = buildPostId({ author: 'Alice', posted_at: '2h', text: 'Hello world' });
+    expect(id).toBe('Alice::2h::Hello world');
+  });
+});
+
+describe('mergeTimelinePosts', () => {
+  it('deduplicates by url', () => {
+    const url = 'https://linkedin.com/post/1';
+    const a = {
+      id: url,
+      author: 'Alice',
+      author_url: '',
+      headline: '',
+      text: 'Hello',
+      posted_at: '1h',
+      reactions: 5,
+      comments: 1,
+      url,
+    };
+    const result = mergeTimelinePosts([a], [a]);
+    expect(result).toHaveLength(1);
+  });
+
+  it('skips posts without author or text', () => {
+    const empty = {
+      id: '2',
+      author: '',
+      author_url: '',
+      headline: '',
+      text: 'some text',
+      posted_at: '',
+      reactions: 0,
+      comments: 0,
+      url: '',
+    };
+    const result = mergeTimelinePosts([], [empty]);
+    expect(result).toHaveLength(0);
+  });
+});