@jackwener/opencli 1.0.6 → 1.1.0

package/src/clis/sinafinance/news.ts

@@ -0,0 +1,76 @@
+/**
+ * Sina Finance 7x24 live news feed.
+ *
+ * Uses the public CJ API — no key or browser required.
+ * https://app.cj.sina.com.cn/api/news/pc
+ */
+
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+
+// User-facing type (0-9) → Sina API tag ID
+const TYPE_MAP = [
+  0,   // 0: 全部
+  10,  // 1: A股
+  1,   // 2: 宏观
+  3,   // 3: 公司
+  4,   // 4: 数据
+  5,   // 5: 市场
+  102, // 6: 国际
+  6,   // 7: 观点
+  6,   // 8: 央行
+  8,   // 9: 其它
+] as const;
+
+interface SinaNewsItem {
+  id?: string;
+  create_time?: string;
+  rich_text?: string;
+  view_num?: number;
+}
+
+function stripHtml(html: string): string {
+  return html.replace(/<[^>]+>/g, '').trim();
+}
+
+cli({
+  site: 'sinafinance',
+  name: 'news',
+  description: '新浪财经 7x24 小时实时快讯',
+  domain: 'app.cj.sina.com.cn',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: 'Max results (max 50)' },
+    { name: 'type', type: 'int', default: 0, help: 'News type: 0=全部 1=A股 2=宏观 3=公司 4=数据 5=市场 6=国际 7=观点 8=央行 9=其它' },
+  ],
+  columns: ['id', 'time', 'content', 'views'],
+  func: async (_page, args) => {
+    const limit = Math.max(1, Math.min(Number(args.limit), 50));
+    const apiTag = TYPE_MAP[args.type as number] ?? 0;
+
+    const params = new URLSearchParams({
+      page: '1',
+      size: String(limit),
+      tag: String(apiTag),
+    });
+
+    const res = await fetch(`https://app.cj.sina.com.cn/api/news/pc?${params}`);
+    if (!res.ok) {
+      throw new CliError('FETCH_ERROR', `Sina Finance API HTTP ${res.status}`, 'Check your network connection');
+    }
+    const json = await res.json() as { result?: { data?: { feed?: { list?: SinaNewsItem[] } } } };
+    const list = json?.result?.data?.feed?.list ?? [];
+
+    if (!list.length) {
+      throw new CliError('NOT_FOUND', 'No news found', 'Try a different type or increase limit');
+    }
+
+    return list.map((item) => ({
+      id: item.id ?? '',
+      time: item.create_time ?? '',
+      content: stripHtml(item.rich_text ?? ''),
+      views: item.view_num ?? 0,
+    }));
+  },
+});

package/src/clis/wikipedia/search.ts

@@ -0,0 +1,32 @@
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+import { wikiFetch } from './utils.js';
+
+interface WikiSearchResult { title: string; snippet: string; }
+
+cli({
+  site: 'wikipedia',
+  name: 'search',
+  description: 'Search Wikipedia articles',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'keyword', positional: true, required: true, help: 'Search keyword' },
+    { name: 'limit', type: 'int', default: 10, help: 'Max results' },
+    { name: 'lang', default: 'en', help: 'Language code (e.g. en, zh, ja)' },
+  ],
+  columns: ['title', 'snippet', 'url'],
+  func: async (_page, args) => {
+    const limit = Math.max(1, Math.min(Number(args.limit), 50));
+    const lang = args.lang || 'en';
+    const q = encodeURIComponent(args.keyword);
+    const data = await wikiFetch(lang, `/w/api.php?action=query&list=search&srsearch=${q}&srlimit=${limit}&format=json&utf8=1`) as { query?: { search?: WikiSearchResult[] } };
+    const results = data?.query?.search;
+    if (!results?.length) throw new CliError('NOT_FOUND', 'No articles found', 'Try a different keyword');
+    return results.map((r) => ({
+      title: r.title,
+      snippet: r.snippet.replace(/<[^>]+>/g, '').slice(0, 120),
+      url: `https://${lang}.wikipedia.org/wiki/${encodeURIComponent(r.title.replace(/ /g, '_'))}`,
+    }));
+  },
+});

package/src/clis/wikipedia/summary.ts

@@ -0,0 +1,28 @@
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+import { wikiFetch } from './utils.js';
+
+cli({
+  site: 'wikipedia',
+  name: 'summary',
+  description: 'Get Wikipedia article summary',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'title', positional: true, required: true, help: 'Article title (e.g. "Transformer (machine learning model)")' },
+    { name: 'lang', default: 'en', help: 'Language code (e.g. en, zh, ja)' },
+  ],
+  columns: ['title', 'description', 'extract', 'url'],
+  func: async (_page, args) => {
+    const lang = args.lang || 'en';
+    const title = encodeURIComponent(args.title.replace(/ /g, '_'));
+    const data = await wikiFetch(lang, `/api/rest_v1/page/summary/${title}`) as { title?: string; description?: string; extract?: string; content_urls?: { desktop?: { page?: string } } };
+    if (!data?.title) throw new CliError('NOT_FOUND', `Article "${args.title}" not found`, 'Try searching first: opencli wikipedia search <keyword>');
+    return [{
+      title: data.title,
+      description: data.description ?? '-',
+      extract: (data.extract ?? '').slice(0, 300),
+      url: data.content_urls?.desktop?.page ?? `https://${lang}.wikipedia.org/wiki/${title}`,
+    }];
+  },
+});

package/src/clis/wikipedia/utils.ts

@@ -0,0 +1,20 @@
+/**
+ * Wikipedia adapter utilities.
+ *
+ * Uses the public MediaWiki REST API and Action API — no key required.
+ * REST API: https://en.wikipedia.org/api/rest_v1/
+ * Action API: https://en.wikipedia.org/w/api.php
+ */
+
+import { CliError } from '../../errors.js';
+
+export async function wikiFetch(lang: string, path: string): Promise<unknown> {
+  const url = `https://${lang}.wikipedia.org${path}`;
+  const resp = await fetch(url, {
+    headers: { 'User-Agent': 'opencli/1.0 (https://github.com/jackwener/opencli)' },
+  });
+  if (!resp.ok) {
+    throw new CliError('FETCH_ERROR', `Wikipedia API HTTP ${resp.status}`, `Check your title or search term`);
+  }
+  return resp.json();
+}

package/src/clis/xiaohongshu/creator-note-detail.test.ts

@@ -0,0 +1,223 @@
+import { describe, expect, it, vi } from 'vitest';
+import type { IPage } from '../../types.js';
+import { getRegistry } from '../../registry.js';
+import { appendAudienceRows, appendTrendRows, parseCreatorNoteDetailText } from './creator-note-detail.js';
+import './creator-note-detail.js';
+
+function createPageMock(evaluateResult: any): IPage {
+  return {
+    goto: vi.fn().mockResolvedValue(undefined),
+    evaluate: vi.fn().mockResolvedValue(evaluateResult),
+    snapshot: vi.fn().mockResolvedValue(undefined),
+    click: vi.fn().mockResolvedValue(undefined),
+    typeText: vi.fn().mockResolvedValue(undefined),
+    pressKey: vi.fn().mockResolvedValue(undefined),
+    wait: vi.fn().mockResolvedValue(undefined),
+    tabs: vi.fn().mockResolvedValue([]),
+    closeTab: vi.fn().mockResolvedValue(undefined),
+    newTab: vi.fn().mockResolvedValue(undefined),
+    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(''),
+  };
+}
+
+describe('xiaohongshu creator-note-detail', () => {
+  it('parses note detail page text into info and metric rows', () => {
+    const bodyText = `笔记数据详情
+一张图讲清 诡秘之主·耕种者途径
+#诡秘之主
+#耕种者序列
+2026-03-18 20:01
+切换笔记
+笔记诊断
+核心数据
+观看来源
+观众画像
+核心数据
+基础数据
+部分数据统计中，次日可查看
+导出数据
+曝光数
+1733
+粉丝占比 6.6%
+实时
+观看数
+544
+粉丝占比 7.2%
+封面点击率
+18.6%
+粉丝 19.1%
+平均观看时长
+51.5秒
+粉丝 55.8秒
+涨粉数
+3
+按小时
+按天
+互动数据
+数据实时更新
+导出数据
+点赞数
+19
+粉丝占比 60%
+评论数
+7
+粉丝占比 33.3%
+收藏数
+10
+粉丝占比 33.3%
+分享数
+6
+粉丝占比 0%`;
+
+    expect(parseCreatorNoteDetailText(bodyText, '69ba940500000000200384db')).toEqual([
+      { section: '笔记信息', metric: 'note_id', value: '69ba940500000000200384db', extra: '' },
+      { section: '笔记信息', metric: 'title', value: '一张图讲清 诡秘之主·耕种者途径', extra: '' },
+      { section: '笔记信息', metric: 'published_at', value: '2026-03-18 20:01', extra: '' },
+      { section: '基础数据', metric: '曝光数', value: '1733', extra: '粉丝占比 6.6%' },
+      { section: '基础数据', metric: '观看数', value: '544', extra: '粉丝占比 7.2%' },
+      { section: '基础数据', metric: '封面点击率', value: '18.6%', extra: '粉丝 19.1%' },
+      { section: '基础数据', metric: '平均观看时长', value: '51.5秒', extra: '粉丝 55.8秒' },
+      { section: '基础数据', metric: '涨粉数', value: '3', extra: '' },
+      { section: '互动数据', metric: '点赞数', value: '19', extra: '粉丝占比 60%' },
+      { section: '互动数据', metric: '评论数', value: '7', extra: '粉丝占比 33.3%' },
+      { section: '互动数据', metric: '收藏数', value: '10', extra: '粉丝占比 33.3%' },
+      { section: '互动数据', metric: '分享数', value: '6', extra: '粉丝占比 0%' },
+    ]);
+  });
+
+  it('appends audience source and portrait rows from API payloads', () => {
+    const rows = appendAudienceRows([], {
+      audienceSource: {
+        source: [
+          {
+            title: '首页推荐',
+            value_with_double: 89.9,
+            info: {
+              imp_count: 1469,
+              view_count: 276,
+              interaction_count: 15,
+            },
+          },
+        ],
+      },
+      audienceSourceDetail: {
+        gender: [
+          { title: '男性', value: 82 },
+          { title: '女性', value: 18 },
+        ],
+        age: [
+          { title: '25-34', value: 55 },
+        ],
+        city: [
+          { title: '上海', value: 8 },
+        ],
+        interest: [
+          { title: '二次元', value: 13 },
+        ],
+      },
+    });
+
+    expect(rows).toEqual([
+      { section: '观看来源', metric: '首页推荐', value: '89.9%', extra: '曝光 1469 · 观看 276 · 互动 15' },
+      { section: '观众画像', metric: '性别/男性', value: '82%', extra: '' },
+      { section: '观众画像', metric: '性别/女性', value: '18%', extra: '' },
+      { section: '观众画像', metric: '年龄/25-34', value: '55%', extra: '' },
+      { section: '观众画像', metric: '城市/上海', value: '8%', extra: '' },
+      { section: '观众画像', metric: '兴趣/二次元', value: '13%', extra: '' },
+    ]);
+  });
+
+  it('appends trend summary rows from hour/day series payloads', () => {
+    const rows = appendTrendRows([], {
+      audienceTrend: {
+        no_data: true,
+        no_data_tip_msg: '数据统计中，请稍后查看',
+      },
+      noteBase: {
+        hour: {
+          view_list: [
+            { date: new Date('2026-03-18T21:00:00+08:00').getTime(), count: 54 },
+            { date: new Date('2026-03-18T22:00:00+08:00').getTime(), count: 51 },
+          ],
+          like_list: [
+            { date: new Date('2026-03-18T21:00:00+08:00').getTime(), count: 2 },
+          ],
+        },
+        day: {
+          view_list: [
+            { date: new Date('2026-03-18T00:00:00+08:00').getTime(), count: 307 },
+          ],
+        },
+      },
+    });
+
+    expect(rows).toEqual([
+      { section: '趋势说明', metric: '观众趋势', value: '暂不可用', extra: '数据统计中，请稍后查看' },
+      { section: '趋势数据', metric: '按小时/观看数', value: '2 points', extra: '03-18 21:00=54 | 03-18 22:00=51' },
+      { section: '趋势数据', metric: '按小时/点赞数', value: '1 points', extra: '03-18 21:00=2' },
+      { section: '趋势数据', metric: '按天/观看数', value: '1 points', extra: '2026-03-18=307' },
+    ]);
+  });
+
+  it('navigates to the note detail page and returns parsed rows', async () => {
+    const cmd = getRegistry().get('xiaohongshu/creator-note-detail');
+    expect(cmd?.func).toBeTypeOf('function');
+
+    const page = createPageMock(`笔记数据详情
+示例笔记
+2026-03-19 12:00
+曝光数
+100
+粉丝占比 10%
+观看数
+50
+粉丝占比 20%
+封面点击率
+12%
+粉丝 11%
+平均观看时长
+30秒
+粉丝 31秒
+涨粉数
+2
+点赞数
+8
+粉丝占比 25%
+评论数
+1
+粉丝占比 0%
+收藏数
+3
+粉丝占比 50%
+分享数
+0
+粉丝占比 0%`);
+
+    const result = await cmd!.func!(page, { note_id: 'demo-note-id' });
+
+    expect((page.goto as any).mock.calls[0][0]).toBe('https://creator.xiaohongshu.com/statistics/note-detail?noteId=demo-note-id');
+    expect((page.evaluate as any).mock.calls[0][0]).toBe('() => document.body.innerText');
+    expect(result).toEqual([
+      { section: '笔记信息', metric: 'note_id', value: 'demo-note-id', extra: '' },
+      { section: '笔记信息', metric: 'title', value: '示例笔记', extra: '' },
+      { section: '笔记信息', metric: 'published_at', value: '2026-03-19 12:00', extra: '' },
+      { section: '基础数据', metric: '曝光数', value: '100', extra: '粉丝占比 10%' },
+      { section: '基础数据', metric: '观看数', value: '50', extra: '粉丝占比 20%' },
+      { section: '基础数据', metric: '封面点击率', value: '12%', extra: '粉丝 11%' },
+      { section: '基础数据', metric: '平均观看时长', value: '30秒', extra: '粉丝 31秒' },
+      { section: '基础数据', metric: '涨粉数', value: '2', extra: '' },
+      { section: '互动数据', metric: '点赞数', value: '8', extra: '粉丝占比 25%' },
+      { section: '互动数据', metric: '评论数', value: '1', extra: '粉丝占比 0%' },
+      { section: '互动数据', metric: '收藏数', value: '3', extra: '粉丝占比 50%' },
+      { section: '互动数据', metric: '分享数', value: '0', extra: '粉丝占比 0%' },
+    ]);
+  });
+});