@jackwener/opencli 0.9.6 → 1.0.0

package/src/clis/wechat/read.ts

@@ -0,0 +1,72 @@
+import { execSync, spawnSync } from 'node:child_process';
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const readCommand = cli({
+  site: 'wechat',
+  name: 'read',
+  description: 'Read the current chat content by selecting all and copying',
+  domain: 'localhost',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [],
+  columns: ['Content'],
+  func: async (page: IPage | null) => {
+    try {
+      // Backup clipboard
+      let clipBackup = '';
+      try {
+        clipBackup = execSync('pbpaste', { encoding: 'utf-8' });
+      } catch { /* empty */ }
+
+      // Activate WeChat
+      execSync("osascript -e 'tell application \"WeChat\" to activate'");
+      execSync("osascript -e 'delay 0.3'");
+
+      // Click on the chat area first, then select all and copy
+      execSync(
+        "osascript " +
+        "-e 'tell application \"System Events\"' " +
+        "-e 'tell application process \"WeChat\"' " +
+        // Click in the message area (center-right of the window)
+        "-e 'set frontWin to front window' " +
+        "-e 'set winPos to position of frontWin' " +
+        "-e 'set winSize to size of frontWin' " +
+        "-e 'end tell' " +
+        "-e 'end tell'"
+      );
+
+      execSync("osascript -e 'delay 0.2'");
+
+      // Select all text in chat area and copy
+      execSync(
+        "osascript " +
+        "-e 'tell application \"System Events\"' " +
+        "-e 'keystroke \"a\" using command down' " +
+        "-e 'delay 0.2' " +
+        "-e 'keystroke \"c\" using command down' " +
+        "-e 'delay 0.2' " +
+        "-e 'end tell'"
+      );
+
+      const content = execSync('pbpaste', { encoding: 'utf-8' }).trim();
+
+      // Restore clipboard
+      if (clipBackup) {
+        spawnSync('pbcopy', { input: clipBackup });
+      }
+
+      // Press Escape to deselect
+      execSync(
+        "osascript " +
+        "-e 'tell application \"System Events\"' " +
+        "-e 'key code 53' " + // Escape
+        "-e 'end tell'"
+      );
+
+      return [{ Content: content || '(no content captured)' }];
+    } catch (err: any) {
+      return [{ Content: 'Error: ' + err.message }];
+    }
+  },
+});

package/src/clis/wechat/search.ts

@@ -0,0 +1,36 @@
+import { execSync } from 'node:child_process';
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const searchCommand = cli({
+  site: 'wechat',
+  name: 'search',
+  description: 'Open WeChat search and type a query (find contacts or messages)',
+  domain: 'localhost',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [{ name: 'query', required: true, positional: true, help: 'Search query (contact name or keyword)' }],
+  columns: ['Status'],
+  func: async (page: IPage | null, kwargs: any) => {
+    const query = kwargs.query as string;
+    try {
+      // Activate WeChat
+      execSync("osascript -e 'tell application \"WeChat\" to activate'");
+      execSync("osascript -e 'delay 0.3'");
+
+      // Cmd+F to open search (WeChat Mac uses Cmd+F for search)
+      execSync(
+        "osascript " +
+        "-e 'tell application \"System Events\"' " +
+        "-e 'keystroke \"f\" using command down' " +
+        "-e 'delay 0.5' " +
+        `-e 'keystroke ${JSON.stringify(query)}' ` +
+        "-e 'end tell'"
+      );
+
+      return [{ Status: `Searching for: ${query}` }];
+    } catch (err: any) {
+      return [{ Status: 'Error: ' + err.message }];
+    }
+  },
+});

package/src/clis/wechat/send.ts

@@ -0,0 +1,49 @@
+import { execSync, spawnSync } from 'node:child_process';
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const sendCommand = cli({
+  site: 'wechat',
+  name: 'send',
+  description: 'Send a message in the active WeChat conversation via clipboard paste',
+  domain: 'localhost',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [{ name: 'text', required: true, positional: true, help: 'Message to send' }],
+  columns: ['Status'],
+  func: async (page: IPage | null, kwargs: any) => {
+    const text = kwargs.text as string;
+    try {
+      // Backup clipboard
+      let clipBackup = '';
+      try {
+        clipBackup = execSync('pbpaste', { encoding: 'utf-8' });
+      } catch { /* clipboard may be empty */ }
+
+      // Copy text to clipboard
+      spawnSync('pbcopy', { input: text });
+
+      // Activate WeChat and paste
+      execSync("osascript -e 'tell application \"WeChat\" to activate'");
+      execSync("osascript -e 'delay 0.5'");
+
+      execSync(
+        "osascript " +
+        "-e 'tell application \"System Events\"' " +
+        "-e 'keystroke \"v\" using command down' " +
+        "-e 'delay 0.2' " +
+        "-e 'keystroke return' " +
+        "-e 'end tell'"
+      );
+
+      // Restore clipboard
+      if (clipBackup) {
+        spawnSync('pbcopy', { input: clipBackup });
+      }
+
+      return [{ Status: 'Success' }];
+    } catch (err: any) {
+      return [{ Status: 'Error: ' + err.message }];
+    }
+  },
+});

package/src/clis/wechat/status.ts

@@ -0,0 +1,35 @@
+import { execSync } from 'node:child_process';
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const statusCommand = cli({
+  site: 'wechat',
+  name: 'status',
+  description: 'Check if WeChat Desktop is running on macOS',
+  domain: 'localhost',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [],
+  columns: ['Status', 'Detail'],
+  func: async (page: IPage | null) => {
+    try {
+      const running = execSync("osascript -e 'application \"WeChat\" is running'", { encoding: 'utf-8' }).trim();
+      if (running !== 'true') {
+        return [{ Status: 'Stopped', Detail: 'WeChat is not running' }];
+      }
+
+      // Get window count to check if logged in
+      const windowCount = execSync(
+        "osascript -e 'tell application \"System Events\" to count windows of application process \"WeChat\"'",
+        { encoding: 'utf-8' }
+      ).trim();
+
+      return [{
+        Status: 'Running',
+        Detail: `${windowCount} window(s) open`,
+      }];
+    } catch (err: any) {
+      return [{ Status: 'Error', Detail: err.message }];
+    }
+  },
+});

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

@@ -0,0 +1,95 @@
+/**
+ * Xiaohongshu Creator Note Detail — per-note analytics breakdown.
+ *
+ * Uses the creator.xiaohongshu.com internal API (cookie auth).
+ * Returns total reads, engagement, likes, collects, comments, shares
+ * for a specific note, split by channel (organic vs promoted vs video).
+ *
+ * Requires: logged into creator.xiaohongshu.com in Chrome.
+ */
+
+import { cli, Strategy } from '../../registry.js';
+
+cli({
+  site: 'xiaohongshu',
+  name: 'creator-note-detail',
+  description: '小红书单篇笔记详细数据 (阅读/互动/点赞/收藏/评论/分享，区分自然流量/推广/视频)',
+  domain: 'creator.xiaohongshu.com',
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    { name: 'note_id', type: 'string', required: true, help: 'Note ID (from note URL or creator-notes command)' },
+  ],
+  columns: ['channel', 'reads', 'engagement', 'likes', 'collects', 'comments', 'shares'],
+  func: async (page, kwargs) => {
+    const noteId: string = kwargs.note_id;
+    const encodedNoteId = encodeURIComponent(noteId);
+
+    // Navigate for cookie context
+    await page.goto('https://creator.xiaohongshu.com/new/home');
+    await page.wait(2);
+
+    const data = await page.evaluate(`
+      async () => {
+        try {
+          const resp = await fetch(
+            '/api/galaxy/creator/data/note_detail?note_id=${encodedNoteId}',
+            { credentials: 'include' }
+          );
+          if (!resp.ok) return { error: 'HTTP ' + resp.status };
+          return await resp.json();
+        } catch (e) {
+          return { error: e.message };
+        }
+      }
+    `);
+
+    if (data?.error) {
+      throw new Error(data.error + '. Check note_id and login status.');
+    }
+    if (!data?.data) {
+      throw new Error('Unexpected response structure');
+    }
+
+    const d = data.data;
+
+    return [
+      {
+        channel: 'Total',
+        reads: d.total_read ?? 0,
+        engagement: d.total_engage ?? 0,
+        likes: d.total_like ?? 0,
+        collects: d.total_fav ?? 0,
+        comments: d.total_cmt ?? 0,
+        shares: d.total_share ?? 0,
+      },
+      {
+        channel: 'Organic',
+        reads: d.normal_read ?? 0,
+        engagement: d.normal_engage ?? 0,
+        likes: d.normal_like ?? 0,
+        collects: d.normal_fav ?? 0,
+        comments: d.normal_cmt ?? 0,
+        shares: d.normal_share ?? 0,
+      },
+      {
+        channel: 'Promoted',
+        reads: d.total_promo_read ?? 0,
+        engagement: 0,
+        likes: 0,
+        collects: 0,
+        comments: 0,
+        shares: 0,
+      },
+      {
+        channel: 'Video',
+        reads: d.video_read ?? 0,
+        engagement: d.video_engage ?? 0,
+        likes: d.video_like ?? 0,
+        collects: d.video_fav ?? 0,
+        comments: d.video_cmt ?? 0,
+        shares: d.video_share ?? 0,
+      },
+    ];
+  },
+});

package/src/clis/xiaohongshu/creator-notes.ts

@@ -0,0 +1,116 @@
+/**
+ * Xiaohongshu Creator Note List — per-note metrics from the creator backend.
+ *
+ * Navigates to the note manager page and extracts per-note data from
+ * the rendered DOM. This approach bypasses the v2 API signature requirement.
+ *
+ * Returns: note title, publish date, views, likes, collects, comments.
+ *
+ * Requires: logged into creator.xiaohongshu.com in Chrome.
+ */
+
+import { cli, Strategy } from '../../registry.js';
+
+cli({
+  site: 'xiaohongshu',
+  name: 'creator-notes',
+  description: '小红书创作者笔记列表 + 每篇数据 (标题/日期/观看/点赞/收藏/评论)',
+  domain: 'creator.xiaohongshu.com',
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: 'Number of notes to return' },
+  ],
+  columns: ['rank', 'id', 'title', 'date', 'views', 'likes', 'collects', 'comments', 'url'],
+  func: async (page, kwargs) => {
+    const limit = kwargs.limit || 20;
+
+    // Navigate to note manager
+    await page.goto('https://creator.xiaohongshu.com/new/note-manager');
+    await page.wait(4);
+
+    // Scroll to load more notes if needed
+    await page.autoScroll({ times: Math.ceil(limit / 10), delayMs: 1500 });
+
+    // Extract note data from rendered DOM
+    const notes = await page.evaluate(`
+      (() => {
+        const results = [];
+        // Note cards in the manager page contain title, date, and metric numbers
+        // Each note card has a consistent structure with the title, date line,
+        // and a row of 4 numbers (views, likes, collects, comments)
+        const cards = document.querySelectorAll('[class*="note-item"], [class*="noteItem"], [class*="card"]');
+
+        if (cards.length === 0) {
+          // Fallback: parse from any container with note-like content
+          const allText = document.body.innerText;
+          const notePattern = /(.+?)\\s+发布于\\s+(\\d{4}年\\d{2}月\\d{2}日\\s+\\d{2}:\\d{2})\\s*(\\d+)\\s*(\\d+)\\s*(\\d+)\\s*(\\d+)/g;
+          let match;
+          while ((match = notePattern.exec(allText)) !== null) {
+            results.push({
+              title: match[1].trim(),
+              date: match[2],
+              views: parseInt(match[3]) || 0,
+              likes: parseInt(match[4]) || 0,
+              collects: parseInt(match[5]) || 0,
+              comments: parseInt(match[6]) || 0,
+            });
+          }
+          return results;
+        }
+
+        cards.forEach(card => {
+          const text = card.innerText || '';
+          const linkEl = card.querySelector('a[href*="/publish/"], a[href*="/note/"], a[href*="/explore/"]');
+          const href = linkEl?.getAttribute('href') || '';
+          const idMatch = href.match(/\/(?:publish|explore|note)\/([a-zA-Z0-9]+)/);
+          // Try to extract structured data
+          const lines = text.split('\\n').map(l => l.trim()).filter(Boolean);
+          if (lines.length < 2) return;
+
+          const title = lines[0];
+          const dateLine = lines.find(l => l.includes('发布于'));
+          const dateMatch = dateLine?.match(/发布于\\s+(\\d{4}年\\d{2}月\\d{2}日\\s+\\d{2}:\\d{2})/);
+
+          // Remove the publish timestamp before collecting note metrics.
+          // Otherwise year/month/day/hour digits are picked up as views/likes/etc.
+          const metricText = dateLine ? text.replace(dateLine, ' ') : text;
+          const nums = metricText.match(/(?:^|\\s)(\\d+)(?:\\s|$)/g)?.map(n => parseInt(n.trim())) || [];
+
+          if (title && !title.includes('全部笔记')) {
+            results.push({
+              id: idMatch ? idMatch[1] : '',
+              title: title.replace(/\\s+/g, ' ').substring(0, 80),
+              date: dateMatch ? dateMatch[1] : '',
+              views: nums[0] || 0,
+              likes: nums[1] || 0,
+              collects: nums[2] || 0,
+              comments: nums[3] || 0,
+              url: href ? new URL(href, window.location.origin).toString() : '',
+            });
+          }
+        });
+
+        return results;
+      })()
+    `);
+
+    if (!Array.isArray(notes) || notes.length === 0) {
+      throw new Error('No notes found. Are you logged into creator.xiaohongshu.com?');
+    }
+
+    return notes
+      .slice(0, limit)
+      .map((n: any, i: number) => ({
+        rank: i + 1,
+        id: n.id,
+        title: n.title,
+        date: n.date,
+        views: n.views,
+        likes: n.likes,
+        collects: n.collects,
+        comments: n.comments,
+        url: n.url,
+      }));
+  },
+});

package/src/clis/xiaohongshu/creator-profile.ts

@@ -0,0 +1,60 @@
+/**
+ * Xiaohongshu Creator Profile — creator account info and growth status.
+ *
+ * Uses the creator.xiaohongshu.com internal API (cookie auth).
+ * Returns follower/following counts, total likes+collects, and
+ * creator level growth info.
+ *
+ * Requires: logged into creator.xiaohongshu.com in Chrome.
+ */
+
+import { cli, Strategy } from '../../registry.js';
+
+cli({
+  site: 'xiaohongshu',
+  name: 'creator-profile',
+  description: '小红书创作者账号信息 (粉丝/关注/获赞/成长等级)',
+  domain: 'creator.xiaohongshu.com',
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [],
+  columns: ['field', 'value'],
+  func: async (page, _kwargs) => {
+    await page.goto('https://creator.xiaohongshu.com/new/home');
+    await page.wait(3);
+
+    const data = await page.evaluate(`
+      async () => {
+        try {
+          const resp = await fetch('/api/galaxy/creator/home/personal_info', {
+            credentials: 'include',
+          });
+          if (!resp.ok) return { error: 'HTTP ' + resp.status };
+          return await resp.json();
+        } catch (e) {
+          return { error: e.message };
+        }
+      }
+    `);
+
+    if (data?.error) {
+      throw new Error(data.error + '. Are you logged into creator.xiaohongshu.com?');
+    }
+    if (!data?.data) {
+      throw new Error('Unexpected response structure');
+    }
+
+    const d = data.data;
+    const grow = d.grow_info || {};
+
+    return [
+      { field: 'Name', value: d.name ?? '' },
+      { field: 'Followers', value: d.fans_count ?? 0 },
+      { field: 'Following', value: d.follow_count ?? 0 },
+      { field: 'Likes & Collects', value: d.faved_count ?? 0 },
+      { field: 'Creator Level', value: grow.level ?? 0 },
+      { field: 'Level Progress', value: `${grow.fans_count ?? 0}/${grow.max_fans_count ?? 0} fans` },
+      { field: 'Bio', value: (d.personal_desc ?? '').replace(/\\n/g, ' | ') },
+    ];
+  },
+});

package/src/clis/xiaohongshu/creator-stats.ts

@@ -0,0 +1,81 @@
+/**
+ * Xiaohongshu Creator Analytics — account-level metrics overview.
+ *
+ * Uses the creator.xiaohongshu.com internal API (cookie auth).
+ * Returns 7-day and 30-day aggregate stats: views, likes, collects,
+ * comments, shares, new followers, and daily trend data.
+ *
+ * Requires: logged into creator.xiaohongshu.com in Chrome.
+ */
+
+import { cli, Strategy } from '../../registry.js';
+
+cli({
+  site: 'xiaohongshu',
+  name: 'creator-stats',
+  description: '小红书创作者数据总览 (观看/点赞/收藏/评论/分享/涨粉，含每日趋势)',
+  domain: 'creator.xiaohongshu.com',
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    {
+      name: 'period',
+      type: 'string',
+      default: 'seven',
+      help: 'Stats period: seven or thirty',
+      choices: ['seven', 'thirty'],
+    },
+  ],
+  columns: ['metric', 'total', 'trend'],
+  func: async (page, kwargs) => {
+    const period: string = kwargs.period || 'seven';
+
+    // Navigate to creator center for cookie context
+    await page.goto('https://creator.xiaohongshu.com/new/home');
+    await page.wait(3);
+
+    const data = await page.evaluate(`
+      async () => {
+        try {
+          const resp = await fetch('/api/galaxy/creator/data/note_detail_new', {
+            credentials: 'include',
+          });
+          if (!resp.ok) return { error: 'HTTP ' + resp.status };
+          return await resp.json();
+        } catch (e) {
+          return { error: e.message };
+        }
+      }
+    `);
+
+    if (data?.error) {
+      throw new Error(data.error + '. Are you logged into creator.xiaohongshu.com?');
+    }
+    if (!data?.data) {
+      throw new Error('Unexpected response structure');
+    }
+
+    const stats = data.data[period];
+    if (!stats) {
+      throw new Error(`No data for period "${period}". Available: ${Object.keys(data.data).join(', ')}`);
+    }
+
+    // Format daily trend as sparkline-like summary
+    const formatTrend = (list: any[]): string => {
+      if (!list || !list.length) return '-';
+      return list.map((d: any) => d.count).join(' → ');
+    };
+
+    return [
+      { metric: '观看数 (views)', total: stats.view_count ?? 0, trend: formatTrend(stats.view_list) },
+      { metric: '平均观看时长 (avg view time ms)', total: stats.view_time_avg ?? 0, trend: formatTrend(stats.view_time_list) },
+      { metric: '主页访问 (home views)', total: stats.home_view_count ?? 0, trend: formatTrend(stats.home_view_list) },
+      { metric: '点赞数 (likes)', total: stats.like_count ?? 0, trend: formatTrend(stats.like_list) },
+      { metric: '收藏数 (collects)', total: stats.collect_count ?? 0, trend: formatTrend(stats.collect_list) },
+      { metric: '评论数 (comments)', total: stats.comment_count ?? 0, trend: formatTrend(stats.comment_list) },
+      { metric: '弹幕数 (danmaku)', total: stats.danmaku_count ?? 0, trend: '-' },
+      { metric: '分享数 (shares)', total: stats.share_count ?? 0, trend: formatTrend(stats.share_list) },
+      { metric: '涨粉数 (new followers)', total: stats.rise_fans_count ?? 0, trend: formatTrend(stats.rise_fans_list) },
+    ];
+  },
+});