@jackwener/opencli 0.9.6 → 0.9.8

package/src/clis/twitter/download.ts

@@ -0,0 +1,227 @@
+/**
+ * Twitter/X download — download images and videos from tweets.
+ *
+ * Usage:
+ *   opencli twitter download --username elonmusk --limit 10 --output ./twitter
+ *   opencli twitter download --tweet-url https://x.com/xxx/status/123 --output ./twitter
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { cli, Strategy } from '../../registry.js';
+import {
+  httpDownload,
+  ytdlpDownload,
+  checkYtdlp,
+  sanitizeFilename,
+  getTempDir,
+  exportCookiesToNetscape,
+} from '../../download/index.js';
+import { DownloadProgressTracker, formatBytes } from '../../download/progress.js';
+
+cli({
+  site: 'twitter',
+  name: 'download',
+  description: '下载 Twitter/X 媒体（图片和视频）',
+  domain: 'x.com',
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: 'username', help: 'Twitter username (downloads from media tab)' },
+    { name: 'tweet-url', help: 'Single tweet URL to download' },
+    { name: 'limit', type: 'int', default: 10, help: 'Number of tweets to scan' },
+    { name: 'output', default: './twitter-downloads', help: 'Output directory' },
+  ],
+  columns: ['index', 'type', 'status', 'size'],
+  func: async (page, kwargs) => {
+    const username = kwargs.username;
+    const tweetUrl = kwargs['tweet-url'];
+    const limit = kwargs.limit;
+    const output = kwargs.output;
+
+    if (!username && !tweetUrl) {
+      return [{
+        index: 0,
+        type: '-',
+        status: 'failed',
+        size: 'Must provide --username or --tweet-url',
+      }];
+    }
+
+    // Navigate to the appropriate page
+    if (tweetUrl) {
+      await page.goto(tweetUrl);
+    } else {
+      await page.goto(`https://x.com/${username}/media`);
+    }
+    await page.wait(3);
+
+    // Scroll to load more content
+    if (!tweetUrl) {
+      await page.autoScroll({ times: Math.ceil(limit / 5) });
+    }
+
+    // Extract media URLs
+    const data = await page.evaluate(`
+      (() => {
+        const media = [];
+
+        // Find images (high quality)
+        document.querySelectorAll('img[src*="pbs.twimg.com/media"]').forEach(img => {
+          let src = img.src || '';
+          // Get large version
+          src = src.replace(/&name=\\w+$/, '&name=large');
+          src = src.replace(/\\?format=/, '?format=');
+          if (!src.includes('&name=')) {
+            src = src + '&name=large';
+          }
+          media.push({ type: 'image', url: src });
+        });
+
+        // Find videos
+        document.querySelectorAll('video').forEach(video => {
+          const src = video.src || '';
+          if (src) {
+            media.push({ type: 'video', url: src, poster: video.poster || '' });
+          }
+        });
+
+        // Find video tweets (for yt-dlp)
+        document.querySelectorAll('[data-testid="videoPlayer"]').forEach(player => {
+          const tweetLink = player.closest('article')?.querySelector('a[href*="/status/"]');
+          const href = tweetLink?.getAttribute('href') || '';
+          if (href) {
+            const tweetUrl = 'https://x.com' + href;
+            media.push({ type: 'video-tweet', url: tweetUrl });
+          }
+        });
+
+        return media;
+      })()
+    `);
+
+    if (!data || data.length === 0) {
+      return [{
+        index: 0,
+        type: '-',
+        status: 'failed',
+        size: 'No media found',
+      }];
+    }
+
+    // Extract cookies
+    const cookieString = await page.evaluate(`(() => document.cookie)()`);
+
+    // Create output directory
+    const outputDir = tweetUrl
+      ? path.join(output, 'tweets')
+      : path.join(output, username || 'media');
+    fs.mkdirSync(outputDir, { recursive: true });
+
+    // Export cookies for yt-dlp
+    let cookiesFile: string | undefined;
+    if (typeof cookieString === 'string' && cookieString) {
+      const tempDir = getTempDir();
+      fs.mkdirSync(tempDir, { recursive: true });
+      cookiesFile = path.join(tempDir, `twitter_cookies_${Date.now()}.txt`);
+
+      const cookies = cookieString.split(';').map((c) => {
+        const [name, ...rest] = c.trim().split('=');
+        return {
+          name: name || '',
+          value: rest.join('=') || '',
+          domain: '.x.com',
+          path: '/',
+          secure: true,
+          httpOnly: false,
+        };
+      }).filter((c) => c.name);
+
+      exportCookiesToNetscape(cookies, cookiesFile);
+    }
+
+    // Deduplicate media
+    const seen = new Set<string>();
+    const uniqueMedia = data.filter((m: any) => {
+      if (seen.has(m.url)) return false;
+      seen.add(m.url);
+      return true;
+    }).slice(0, limit);
+
+    const tracker = new DownloadProgressTracker(uniqueMedia.length, true);
+    const results: any[] = [];
+
+    for (let i = 0; i < uniqueMedia.length; i++) {
+      const media = uniqueMedia[i];
+      const ext = media.type === 'image' ? 'jpg' : 'mp4';
+      const filename = `${username || 'tweet'}_${i + 1}.${ext}`;
+      const destPath = path.join(outputDir, filename);
+
+      const progressBar = tracker.onFileStart(filename, i);
+
+      try {
+        let result: { success: boolean; size: number; error?: string };
+
+        if (media.type === 'video-tweet' && checkYtdlp()) {
+          // Use yt-dlp for video tweets
+          result = await ytdlpDownload(media.url, destPath, {
+            cookiesFile,
+            extraArgs: ['--merge-output-format', 'mp4'],
+            onProgress: (percent) => {
+              if (progressBar) progressBar.update(percent, 100);
+            },
+          });
+        } else if (media.type === 'image') {
+          // Direct HTTP download for images
+          result = await httpDownload(media.url, destPath, {
+            cookies: typeof cookieString === 'string' ? cookieString : '',
+            timeout: 30000,
+            onProgress: (received, total) => {
+              if (progressBar) progressBar.update(received, total);
+            },
+          });
+        } else {
+          // Direct HTTP download for direct video URLs
+          result = await httpDownload(media.url, destPath, {
+            cookies: typeof cookieString === 'string' ? cookieString : '',
+            timeout: 60000,
+            onProgress: (received, total) => {
+              if (progressBar) progressBar.update(received, total);
+            },
+          });
+        }
+
+        if (progressBar) {
+          progressBar.complete(result.success, result.success ? formatBytes(result.size) : undefined);
+        }
+
+        tracker.onFileComplete(result.success);
+
+        results.push({
+          index: i + 1,
+          type: media.type === 'video-tweet' ? 'video' : media.type,
+          status: result.success ? 'success' : 'failed',
+          size: result.success ? formatBytes(result.size) : (result.error || 'unknown error'),
+        });
+      } catch (err: any) {
+        if (progressBar) progressBar.fail(err.message);
+        tracker.onFileComplete(false);
+
+        results.push({
+          index: i + 1,
+          type: media.type,
+          status: 'failed',
+          size: err.message,
+        });
+      }
+    }
+
+    tracker.finish();
+
+    // Cleanup cookies file
+    if (cookiesFile && fs.existsSync(cookiesFile)) {
+      fs.unlinkSync(cookiesFile);
+    }
+
+    return results;
+  },
+});

package/src/clis/wechat/README.md

@@ -0,0 +1,28 @@
+# WeChat (微信) Desktop Adapter
+
+Control **WeChat Mac Desktop** from the terminal via AppleScript + Accessibility API.
+
+> **Note:** WeChat is a native macOS app (not Electron), so CDP is not available. This adapter uses AppleScript keyboard simulation and clipboard operations.
+
+## Prerequisites
+
+1. WeChat must be running and logged in
+2. Terminal must have **Accessibility permission** (System Settings → Privacy & Security → Accessibility)
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `wechat status` | Check if WeChat is running |
+| `wechat send "msg"` | Send message in the active chat (clipboard paste + Enter) |
+| `wechat read` | Read current chat content (Cmd+A → Cmd+C) |
+| `wechat search "keyword"` | Open search and type a query (Cmd+F) |
+| `wechat chats` | Switch to Chats tab (Cmd+1) |
+| `wechat contacts` | Switch to Contacts tab (Cmd+2) |
+
+## Limitations
+
+- **No CDP support** — WeChat is native Cocoa, not Electron
+- `send` requires the correct conversation to be already open
+- `read` captures whatever is visible via select-all + copy
+- `search` types the query but cannot programmatically click results

package/src/clis/wechat/README.zh-CN.md

@@ -0,0 +1,28 @@
+# 微信桌面端适配器
+
+通过 AppleScript + Accessibility API 在终端中控制**微信 Mac 桌面端**。
+
+> **注意：** 微信是原生 macOS 应用（非 Electron），因此无法使用 CDP。此适配器使用 AppleScript 键盘模拟和剪贴板操作。
+
+## 前置条件
+
+1. 微信必须正在运行且已登录
+2. Terminal 需要 **辅助功能权限**（系统设置 → 隐私与安全性 → 辅助功能）
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `wechat status` | 检查微信是否在运行 |
+| `wechat send "消息"` | 发送消息（剪贴板粘贴 + 回车） |
+| `wechat read` | 读取当前聊天内容（Cmd+A → Cmd+C） |
+| `wechat search "关键词"` | 打开搜索并输入关键词（Cmd+F） |
+| `wechat chats` | 切换到聊天列表（Cmd+1） |
+| `wechat contacts` | 切换到通讯录（Cmd+2） |
+
+## 限制
+
+- **不支持 CDP** — 微信是原生 Cocoa 应用
+- `send` 需要先手动打开正确的会话
+- `read` 通过全选+复制来获取可见内容
+- `search` 可以输入关键词但无法自动点击结果

package/src/clis/wechat/chats.ts

@@ -0,0 +1,33 @@
+import { execSync } from 'node:child_process';
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const chatsCommand = cli({
+  site: 'wechat',
+  name: 'chats',
+  description: 'Open the WeChat chats panel (conversation list)',
+  domain: 'localhost',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [],
+  columns: ['Status'],
+  func: async (page: IPage | null) => {
+    try {
+      // Activate WeChat
+      execSync("osascript -e 'tell application \"WeChat\" to activate'");
+      execSync("osascript -e 'delay 0.3'");
+
+      // Cmd+1 switches to Chats tab in WeChat Mac
+      execSync(
+        "osascript " +
+        "-e 'tell application \"System Events\"' " +
+        "-e 'keystroke \"1\" using command down' " +
+        "-e 'end tell'"
+      );
+
+      return [{ Status: 'Chats panel opened (Cmd+1)' }];
+    } catch (err: any) {
+      return [{ Status: 'Error: ' + err.message }];
+    }
+  },
+});

package/src/clis/wechat/contacts.ts

@@ -0,0 +1,33 @@
+import { execSync } from 'node:child_process';
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const contactsCommand = cli({
+  site: 'wechat',
+  name: 'contacts',
+  description: 'Open the WeChat contacts panel',
+  domain: 'localhost',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [],
+  columns: ['Status'],
+  func: async (page: IPage | null) => {
+    try {
+      // Activate WeChat
+      execSync("osascript -e 'tell application \"WeChat\" to activate'");
+      execSync("osascript -e 'delay 0.3'");
+
+      // Cmd+2 switches to Contacts tab in WeChat Mac
+      execSync(
+        "osascript " +
+        "-e 'tell application \"System Events\"' " +
+        "-e 'keystroke \"2\" using command down' " +
+        "-e 'end tell'"
+      );
+
+      return [{ Status: 'Contacts panel opened (Cmd+2)' }];
+    } catch (err: any) {
+      return [{ Status: 'Error: ' + err.message }];
+    }
+  },
+});

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,
+      },
+    ];
+  },
+});