@jackwener/opencli 1.0.6 → 1.1.1

package/src/clis/boss/mark.ts

@@ -0,0 +1,155 @@
+/**
+ * BOSS直聘 mark — label/mark a candidate.
+ *
+ * Uses /wapi/zprelation/friend/label/addMark to add a label to a candidate,
+ * and /wapi/zprelation/friend/label/deleteMark to remove one.
+ *
+ * Available labels (from /wapi/zprelation/friend/label/get):
+ *   1=新招呼, 2=沟通中, 3=已约面, 4=已获取简历, 5=已交换电话,
+ *   6=已交换微信, 7=不合适, 8=牛人发起, 11=收藏
+ */
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+const LABEL_MAP: Record<string, number> = {
+  '新招呼': 1, '沟通中': 2, '已约面': 3, '已获取简历': 4,
+  '已交换电话': 5, '已交换微信': 6, '不合适': 7, '牛人发起': 8, '收藏': 11,
+};
+
+cli({
+  site: 'boss',
+  name: 'mark',
+  description: 'BOSS直聘给候选人添加标签',
+  domain: 'www.zhipin.com',
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    { name: 'uid', required: true, help: 'Encrypted UID of the candidate' },
+    { name: 'label', required: true, help: 'Label name (新招呼/沟通中/已约面/已获取简历/已交换电话/已交换微信/不合适/收藏) or label ID' },
+    { name: 'remove', type: 'boolean', default: false, help: 'Remove the label instead of adding' },
+  ],
+  columns: ['status', 'detail'],
+  func: async (page: IPage | null, kwargs) => {
+    if (!page) throw new Error('Browser page required');
+
+    const uid = kwargs.uid;
+    const labelInput = kwargs.label;
+    const remove = kwargs.remove || false;
+
+    // Resolve label to ID
+    let labelId: number;
+    if (LABEL_MAP[labelInput]) {
+      labelId = LABEL_MAP[labelInput];
+    } else if (!isNaN(Number(labelInput))) {
+      labelId = Number(labelInput);
+    } else {
+      // Try partial match
+      const entry = Object.entries(LABEL_MAP).find(([k]) => k.includes(labelInput));
+      if (entry) {
+        labelId = entry[1];
+      } else {
+        throw new Error(`未知标签: ${labelInput}。可用标签: ${Object.keys(LABEL_MAP).join(', ')}`);
+      }
+    }
+
+    if (process.env.OPENCLI_VERBOSE) {
+      console.error(`[opencli:boss] ${remove ? 'Removing' : 'Adding'} label ${labelId} for ${uid}...`);
+    }
+
+    await page.goto('https://www.zhipin.com/web/chat/index');
+    await page.wait({ time: 2 });
+
+    // First get numeric UID from friend list
+    const friendData: any = await page.evaluate(`
+      async () => {
+        return new Promise((resolve, reject) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('GET', 'https://www.zhipin.com/wapi/zprelation/friend/getBossFriendListV2.json?page=1&status=0&jobId=0', true);
+          xhr.withCredentials = true;
+          xhr.timeout = 15000;
+          xhr.setRequestHeader('Accept', 'application/json');
+          xhr.onload = () => { try { resolve(JSON.parse(xhr.responseText)); } catch(e) { reject(e); } };
+          xhr.onerror = () => reject(new Error('Network Error'));
+          xhr.send();
+        });
+      }
+    `);
+
+    if (friendData.code !== 0) {
+      if (friendData.code === 7 || friendData.code === 37) {
+        throw new Error('Cookie 已过期！请在当前 Chrome 浏览器中重新登录 BOSS 直聘。');
+      }
+      throw new Error(`获取好友列表失败: ${friendData.message}`);
+    }
+
+    // Find in friend list (check multiple pages)
+    let friend: any = null;
+    let allFriends = friendData.zpData?.friendList || [];
+    friend = allFriends.find((f: any) => f.encryptUid === uid);
+
+    if (!friend) {
+      // Also check greetRecSortList
+      const greetData: any = await page.evaluate(`
+        async () => {
+          return new Promise((resolve, reject) => {
+            const xhr = new XMLHttpRequest();
+            xhr.open('GET', 'https://www.zhipin.com/wapi/zprelation/friend/greetRecSortList', true);
+            xhr.withCredentials = true;
+            xhr.timeout = 15000;
+            xhr.setRequestHeader('Accept', 'application/json');
+            xhr.onload = () => { try { resolve(JSON.parse(xhr.responseText)); } catch(e) { reject(e); } };
+            xhr.onerror = () => reject(new Error('Network Error'));
+            xhr.send();
+          });
+        }
+      `);
+      if (greetData.code === 0) {
+        friend = (greetData.zpData?.friendList || []).find((f: any) => f.encryptUid === uid);
+      }
+    }
+
+    if (!friend) {
+      throw new Error('未找到该候选人');
+    }
+
+    const numericUid = friend.uid;
+    const friendName = friend.name || '候选人';
+    const friendSource = friend.friendSource ?? 0;
+
+    const action = remove ? 'deleteMark' : 'addMark';
+    const targetUrl = `https://www.zhipin.com/wapi/zprelation/friend/label/${action}`;
+
+    // The API uses friendId + friendSource + labelId (discovered from JS bundles)
+    const params = new URLSearchParams({
+      friendId: String(numericUid),
+      friendSource: String(friendSource),
+      labelId: String(labelId),
+    });
+
+    // Try GET first (the N() wrapper in boss JS uses GET with query params)
+    const data: any = await page.evaluate(`
+      async () => {
+        return new Promise((resolve, reject) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('GET', '${targetUrl}?${params.toString()}', true);
+          xhr.withCredentials = true;
+          xhr.timeout = 15000;
+          xhr.setRequestHeader('Accept', 'application/json');
+          xhr.onload = () => { try { resolve(JSON.parse(xhr.responseText)); } catch(e) { reject(new Error('JSON parse failed')); } };
+          xhr.onerror = () => reject(new Error('Network Error'));
+          xhr.send();
+        });
+      }
+    `);
+
+    if (data.code !== 0) {
+      throw new Error(`标签操作失败: ${data.message} (code=${data.code})`);
+    }
+
+    const labelName = Object.entries(LABEL_MAP).find(([, v]) => v === labelId)?.[0] || String(labelId);
+    return [{
+      status: remove ? '✅ 标签已移除' : '✅ 标签已添加',
+      detail: `${friendName}: ${remove ? '移除' : '添加'}标签「${labelName}」`,
+    }];
+  },
+});

package/src/clis/boss/recommend.ts

@@ -0,0 +1,94 @@
+/**
+ * BOSS直聘 recommend — view recommended candidates (新招呼/greet sort list).
+ *
+ * Uses /wapi/zprelation/friend/greetRecSortList to get system-recommended candidates.
+ * These are candidates who have greeted or been recommended by the system.
+ */
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+cli({
+  site: 'boss',
+  name: 'recommend',
+  description: 'BOSS直聘查看推荐候选人（新招呼列表）',
+  domain: 'www.zhipin.com',
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: 'Number of results to return' },
+  ],
+  columns: ['name', 'job_name', 'last_time', 'labels', 'encrypt_uid', 'security_id', 'encrypt_job_id'],
+  func: async (page: IPage | null, kwargs) => {
+    if (!page) throw new Error('Browser page required');
+
+    const limit = kwargs.limit || 20;
+
+    if (process.env.OPENCLI_VERBOSE) {
+      console.error('[opencli:boss] Fetching recommended candidates...');
+    }
+
+    await page.goto('https://www.zhipin.com/web/chat/index');
+    await page.wait({ time: 2 });
+
+    // Get label definitions for mapping
+    const labelData: any = await page.evaluate(`
+      async () => {
+        return new Promise((resolve, reject) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('GET', 'https://www.zhipin.com/wapi/zprelation/friend/label/get', true);
+          xhr.withCredentials = true;
+          xhr.timeout = 10000;
+          xhr.setRequestHeader('Accept', 'application/json');
+          xhr.onload = () => { try { resolve(JSON.parse(xhr.responseText)); } catch(e) { resolve({}); } };
+          xhr.onerror = () => resolve({});
+          xhr.send();
+        });
+      }
+    `);
+
+    const labelMap: Record<number, string> = {};
+    if (labelData.code === 0 && labelData.zpData?.labels) {
+      for (const l of labelData.zpData.labels) {
+        labelMap[l.labelId] = l.label;
+      }
+    }
+
+    // Get recommended candidates
+    const targetUrl = 'https://www.zhipin.com/wapi/zprelation/friend/greetRecSortList';
+
+    const data: any = await page.evaluate(`
+      async () => {
+        return new Promise((resolve, reject) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('GET', '${targetUrl}', true);
+          xhr.withCredentials = true;
+          xhr.timeout = 15000;
+          xhr.setRequestHeader('Accept', 'application/json');
+          xhr.onload = () => { try { resolve(JSON.parse(xhr.responseText)); } catch(e) { reject(new Error('JSON parse failed')); } };
+          xhr.onerror = () => reject(new Error('Network Error'));
+          xhr.ontimeout = () => reject(new Error('Timeout'));
+          xhr.send();
+        });
+      }
+    `);
+
+    if (data.code !== 0) {
+      if (data.code === 7 || data.code === 37) {
+        throw new Error('Cookie 已过期！请在当前 Chrome 浏览器中重新登录 BOSS 直聘。');
+      }
+      throw new Error(`API error: ${data.message} (code=${data.code})`);
+    }
+
+    const friends = (data.zpData?.friendList || []).slice(0, limit);
+
+    return friends.map((f: any) => ({
+      name: f.name || '',
+      job_name: f.jobName || '',
+      last_time: f.lastTime || '',
+      labels: (f.relationLabelList || []).map((id: number) => labelMap[id] || String(id)).join(', '),
+      encrypt_uid: f.encryptUid || '',
+      security_id: f.securityId || '',
+      encrypt_job_id: f.encryptJobId || '',
+    }));
+  },
+});

package/src/clis/boss/search.ts

@@ -72,7 +72,7 @@ cli({
 
   browser: true,
   args: [
-    { name: 'query', required: true, help: 'Search keyword (e.g. AI agent, 前端)' },
+    { name: 'query', required: true, positional: true, help: 'Search keyword (e.g. AI agent, 前端)' },
     { name: 'city', default: '北京', help: 'City name or code (e.g. 杭州, 上海, 101010100)' },
     { name: 'experience', default: '', help: 'Experience: 应届/1年以内/1-3年/3-5年/5-10年/10年以上' },
     { name: 'degree', default: '', help: 'Degree: 大专/本科/硕士/博士' },

package/src/clis/boss/send.ts

@@ -17,7 +17,7 @@ cli({
   browser: true,
   args: [
     { name: 'uid', required: true, help: 'Encrypted UID of the candidate (from chatlist)' },
-    { name: 'text', required: true, help: 'Message text to send' },
+    { name: 'text', required: true, positional: true, help: 'Message text to send' },
   ],
   columns: ['status', 'detail'],
   func: async (page: IPage | null, kwargs) => {

package/src/clis/boss/stats.ts

@@ -0,0 +1,130 @@
+/**
+ * BOSS直聘 stats — job statistics overview.
+ *
+ * Uses /wapi/zpchat/chatHelper/statistics for total friend count,
+ * and /wapi/zpjob/job/chatted/jobList for per-job info.
+ * Since BOSS doesn't expose detailed per-job stats via API,
+ * we show what's available: job status, chat info, and total stats.
+ */
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+cli({
+  site: 'boss',
+  name: 'stats',
+  description: 'BOSS直聘职位数据统计',
+  domain: 'www.zhipin.com',
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    { name: 'job-id', default: '', help: 'Encrypted job ID (show all if empty)' },
+  ],
+  columns: ['job_name', 'salary', 'city', 'status', 'total_chats', 'encrypt_job_id'],
+  func: async (page: IPage | null, kwargs) => {
+    if (!page) throw new Error('Browser page required');
+
+    const filterJobId = kwargs['job-id'] || '';
+
+    if (process.env.OPENCLI_VERBOSE) {
+      console.error('[opencli:boss] Fetching job statistics...');
+    }
+
+    await page.goto('https://www.zhipin.com/web/chat/index');
+    await page.wait({ time: 2 });
+
+    // Get job list
+    const jobData: any = await page.evaluate(`
+      async () => {
+        return new Promise((resolve, reject) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('GET', 'https://www.zhipin.com/wapi/zpjob/job/chatted/jobList', true);
+          xhr.withCredentials = true;
+          xhr.timeout = 15000;
+          xhr.setRequestHeader('Accept', 'application/json');
+          xhr.onload = () => { try { resolve(JSON.parse(xhr.responseText)); } catch(e) { reject(new Error('JSON parse failed')); } };
+          xhr.onerror = () => reject(new Error('Network Error'));
+          xhr.ontimeout = () => reject(new Error('Timeout'));
+          xhr.send();
+        });
+      }
+    `);
+
+    if (jobData.code !== 0) {
+      if (jobData.code === 7 || jobData.code === 37) {
+        throw new Error('Cookie 已过期！请在当前 Chrome 浏览器中重新登录 BOSS 直聘。');
+      }
+      throw new Error(`API error: ${jobData.message} (code=${jobData.code})`);
+    }
+
+    // Get total chat stats
+    const chatStats: any = await page.evaluate(`
+      async () => {
+        return new Promise((resolve, reject) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('GET', 'https://www.zhipin.com/wapi/zpchat/chatHelper/statistics', true);
+          xhr.withCredentials = true;
+          xhr.timeout = 10000;
+          xhr.setRequestHeader('Accept', 'application/json');
+          xhr.onload = () => { try { resolve(JSON.parse(xhr.responseText)); } catch(e) { resolve({}); } };
+          xhr.onerror = () => resolve({});
+          xhr.send();
+        });
+      }
+    `);
+
+    const totalFriends = chatStats.zpData?.totalFriendCount || 0;
+
+    // Get per-job chat counts from friend list
+    const friendData: any = await page.evaluate(`
+      async () => {
+        return new Promise((resolve, reject) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('GET', 'https://www.zhipin.com/wapi/zprelation/friend/getBossFriendListV2.json?page=1&status=0&jobId=0', true);
+          xhr.withCredentials = true;
+          xhr.timeout = 15000;
+          xhr.setRequestHeader('Accept', 'application/json');
+          xhr.onload = () => { try { resolve(JSON.parse(xhr.responseText)); } catch(e) { resolve({}); } };
+          xhr.onerror = () => resolve({});
+          xhr.send();
+        });
+      }
+    `);
+
+    // Count chats per job
+    const jobChatCounts: Record<string, number> = {};
+    if (friendData.code === 0) {
+      for (const f of (friendData.zpData?.friendList || [])) {
+        const jobName = f.jobName || 'unknown';
+        jobChatCounts[jobName] = (jobChatCounts[jobName] || 0) + 1;
+      }
+    }
+
+    let jobs = jobData.zpData || [];
+    if (filterJobId) {
+      jobs = jobs.filter((j: any) => j.encryptJobId === filterJobId);
+    }
+
+    const results = jobs.map((j: any) => ({
+      job_name: j.jobName || '',
+      salary: j.salaryDesc || '',
+      city: j.address || '',
+      status: j.jobOnlineStatus === 1 ? '在线' : '已关闭',
+      total_chats: String(jobChatCounts[j.jobName] || 0),
+      encrypt_job_id: j.encryptJobId || '',
+    }));
+
+    // Add summary row
+    if (!filterJobId && results.length > 0) {
+      results.push({
+        job_name: '--- 总计 ---',
+        salary: '',
+        city: '',
+        status: `${jobs.length} 个职位`,
+        total_chats: String(totalFriends),
+        encrypt_job_id: '',
+      });
+    }
+
+    return results;
+  },
+});

package/src/clis/chaoxing/assignments.ts

@@ -3,7 +3,7 @@ import {
   getCourses, initSession, enterCourse, getTabIframeUrl,
   parseAssignmentsFromDom, sleep,
   type AssignmentRow,
-} from '../../chaoxing.js';
+} from './utils.js';
 
 cli({
   site: 'chaoxing',

package/src/clis/chaoxing/exams.ts

@@ -3,7 +3,7 @@ import {
   getCourses, initSession, enterCourse, getTabIframeUrl,
   parseExamsFromDom, sleep,
   type ExamRow,
-} from '../../chaoxing.js';
+} from './utils.js';
 
 cli({
   site: 'chaoxing',

package/src/{chaoxing.test.ts → clis/chaoxing/utils.test.ts}

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { formatTimestamp, workStatusLabel } from './chaoxing.js';
+import { formatTimestamp, workStatusLabel } from './utils.js';
 
 function localDatePrefixFromMillis(ts: number): string {
   const d = new Date(ts);

package/src/{chaoxing.ts → clis/chaoxing/utils.ts}

@@ -6,7 +6,7 @@
  * course pages loaded as iframes.
  */
 
-import type { IPage } from './types.js';
+import type { IPage } from '../../types.js';
 
 // ── Utilities ────────────────────────────────────────────────────────
 
@@ -96,7 +96,6 @@ export async function getCourses(page: IPage): Promise<ChaoxingCourse[]> {
 /** Navigate to the interaction page to establish a Chaoxing session. */
 export async function initSession(page: IPage): Promise<void> {
   await page.goto('https://mooc2-ans.chaoxing.com/mooc2-ans/visit/interaction');
-  await page.wait(3);
 }
 
 /**
@@ -108,7 +107,6 @@ export async function enterCourse(page: IPage, course: ChaoxingCourse): Promise<
     `https://mooc1.chaoxing.com/visit/stucoursemiddle` +
     `?courseid=${course.courseId}&clazzid=${course.classId}&cpi=${course.cpi}&ismooc2=1&v=2`;
   await page.goto(url);
-  await page.wait(3);
 }
 
 /**

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

@@ -14,7 +14,7 @@
 - `opencli chatgpt status`：检查 ChatGPT 应用是否在运行。
 - `opencli chatgpt new`：激活 ChatGPT 并按 `Cmd+N` 开始新对话。
 - `opencli chatgpt send "消息"`：将消息复制到剪贴板，激活 ChatGPT，粘贴并提交。
-- `opencli chatgpt read`：通过 `Cmd+Shift+C` 复制最后一条 AI 回复并返回文本。
+- `opencli chatgpt read`：通过当前聚焦 ChatGPT 窗口的辅助功能树读取最后一条可见消息并返回文本。
 
 ## 方式二：CDP（高级，Electron 调试模式）
 
@@ -34,11 +34,11 @@ export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9224"
 
 ## 工作原理
 
-- **AppleScript 模式**：使用 `osascript` 和 `pbcopy`/`pbpaste` 进行剪贴板文本传输，无需远程调试端口。
+- **AppleScript 模式**：使用 `osascript` 控制 ChatGPT，发送消息时借助 `pbcopy`/`pbpaste` 粘贴文本，读取消息时通过 macOS 辅助功能树获取当前可见聊天内容。
 - **CDP 模式**：通过 Chrome DevTools Protocol 连接到 Electron 渲染进程，直接操作 DOM。
 
 ## 限制
 
 - 仅支持 macOS（AppleScript 依赖）
 - AppleScript 模式需要辅助功能权限
-- `read` 命令复制最后一条回复，更早的消息需手动滚动
+- `read` 返回的是当前聚焦 ChatGPT 窗口里的最后一条可见消息；如果目标消息不在可见区域，需先手动滚动

package/src/clis/chatgpt/read.ts

@@ -6,7 +6,7 @@ import { getVisibleChatMessages } from './ax.js';
 export const readCommand = cli({
   site: 'chatgpt',
   name: 'read',
-  description: 'Copy the most recent ChatGPT Desktop App response to clipboard and read it',
+  description: 'Read the last visible message from the focused ChatGPT Desktop window',
   domain: 'localhost',
   strategy: Strategy.PUBLIC,
   browser: false,

package/src/clis/chatwise/export.ts

@@ -10,7 +10,7 @@ export const exportCommand = cli({
   strategy: Strategy.UI,
   browser: true,
   args: [
-    { name: 'output', required: false, positional: true, help: 'Output file (default: /tmp/chatwise-export.md)' },
+    { name: 'output', required: false,  help: 'Output file (default: /tmp/chatwise-export.md)' },
   ],
   columns: ['Status', 'File', 'Messages'],
   func: async (page: IPage, kwargs: any) => {

package/src/clis/chatwise/model.ts

@@ -9,11 +9,11 @@ export const modelCommand = cli({
   strategy: Strategy.UI,
   browser: true,
   args: [
-    { name: 'model_name', required: false, positional: true, help: 'Model to switch to (e.g. gpt-4, claude-3)' },
+    { name: 'model-name', required: false, positional: true, help: 'Model to switch to (e.g. gpt-4, claude-3)' },
   ],
   columns: ['Status', 'Model'],
   func: async (page: IPage, kwargs: any) => {
-    const desiredModel = kwargs.model_name as string | undefined;
+    const desiredModel = kwargs['model-name'] as string | undefined;
 
     if (!desiredModel) {
       // Read current model

package/src/clis/chatwise/screenshot.ts

@@ -10,7 +10,7 @@ export const screenshotCommand = cli({
   strategy: Strategy.UI,
   browser: true,
   args: [
-    { name: 'output', required: false, positional: true, help: 'Output file path (default: /tmp/chatwise-snapshot)' },
+    { name: 'output', required: false,  help: 'Output file path (default: /tmp/chatwise-snapshot)' },
   ],
   columns: ['Status', 'File'],
   func: async (page: IPage, kwargs: any) => {

package/src/clis/codex/export.ts

@@ -10,7 +10,7 @@ export const exportCommand = cli({
   strategy: Strategy.UI,
   browser: true,
   args: [
-    { name: 'output', required: false, positional: true, help: 'Output file (default: /tmp/codex-export.md)' },
+    { name: 'output', required: false,  help: 'Output file (default: /tmp/codex-export.md)' },
   ],
   columns: ['Status', 'File', 'Messages'],
   func: async (page: IPage, kwargs: any) => {

package/src/clis/codex/model.ts

@@ -9,11 +9,11 @@ export const modelCommand = cli({
   strategy: Strategy.UI,
   browser: true,
   args: [
-    { name: 'model_name', required: false, positional: true, help: 'The ID of the model to switch to (e.g. gpt-4)' }
+    { name: 'model-name', required: false, positional: true, help: 'The ID of the model to switch to (e.g. gpt-4)' }
   ],
   columns: ['Status', 'Model'],
   func: async (page: IPage, kwargs: any) => {
-    const desiredModel = kwargs.model_name as string | undefined;
+    const desiredModel = kwargs['model-name'] as string | undefined;
 
     if (!desiredModel) {
       // Just read the current model. We traverse iframes/webviews if needed.

package/src/clis/codex/screenshot.ts

@@ -10,7 +10,7 @@ export const screenshotCommand = cli({
   strategy: Strategy.UI,
   browser: true,
   args: [
-    { name: 'output', required: false, positional: true, help: 'Output file path (default: /tmp/codex-snapshot.txt)' },
+    { name: 'output', required: false,  help: 'Output file path (default: /tmp/codex-snapshot.txt)' },
   ],
   columns: ['Status', 'File'],
   func: async (page: IPage, kwargs: any) => {

package/src/clis/coupang/add-to-cart.ts

@@ -1,5 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
-import { canonicalizeProductUrl, normalizeProductId } from '../../coupang.js';
+import { canonicalizeProductUrl, normalizeProductId } from './utils.js';
 
 function escapeJsString(value: string): string {
   return JSON.stringify(value);
@@ -102,12 +102,12 @@ cli({
   strategy: Strategy.COOKIE,
   browser: true,
   args: [
-    { name: 'productId', required: false, help: 'Coupang product ID' },
+    { name: 'product-id', required: false, help: 'Coupang product ID' },
     { name: 'url', required: false, help: 'Canonical product URL' },
   ],
   columns: ['ok', 'product_id', 'url', 'message'],
   func: async (page, kwargs) => {
-    const rawProductId = kwargs.productId ?? kwargs.product_id;
+    const rawProductId = kwargs['product-id'] ?? kwargs['product-id'];
     const productId = normalizeProductId(rawProductId);
     const targetUrl = canonicalizeProductUrl(kwargs.url, productId);
 
@@ -117,7 +117,6 @@ cli({
 
     const finalUrl = targetUrl || canonicalizeProductUrl('', productId);
     await page.goto(finalUrl);
-    await page.wait(3);
 
     const result = await page.evaluate(buildAddToCartEvaluate(productId));
     const loginHints = result?.loginHints ?? {};

package/src/clis/coupang/search.ts

@@ -1,5 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
-import { mergeSearchItems, normalizeSearchItem, sanitizeSearchItems } from '../../coupang.js';
+import { mergeSearchItems, normalizeSearchItem, sanitizeSearchItems } from './utils.js';
 
 function escapeJsString(value: string): string {
   return JSON.stringify(value);
@@ -409,7 +409,7 @@ cli({
   strategy: Strategy.COOKIE,
   browser: true,
   args: [
-    { name: 'query', required: true, help: 'Search keyword' },
+    { name: 'query', required: true, positional: true, help: 'Search keyword' },
     { name: 'page', type: 'int', default: 1, help: 'Search result page number' },
     { name: 'limit', type: 'int', default: 20, help: 'Max results (max 50)' },
     { name: 'filter', required: false, help: 'Optional search filter (currently supports: rocket)' },
@@ -425,7 +425,6 @@ cli({
     const initialPage = filter ? 1 : pageNumber;
     const url = `https://www.coupang.com/np/search?q=${encodeURIComponent(query)}&channel=user&page=${initialPage}`;
     await page.goto(url);
-    await page.wait(3);
     if (filter) {
       const filterResult = await page.evaluate(buildApplyFilterEvaluate(filter));
       if (!filterResult?.ok) {
@@ -437,7 +436,6 @@ cli({
         const filteredUrl = new URL(locationInfo?.href || url);
         filteredUrl.searchParams.set('page', String(pageNumber));
         await page.goto(filteredUrl.toString());
-        await page.wait(3);
       }
     }
     await page.autoScroll({ times: filter ? 3 : 2, delayMs: 1500 });

package/src/{coupang.test.ts → clis/coupang/utils.test.ts}

@@ -5,7 +5,7 @@ import {
   normalizeProductId,
   normalizeSearchItem,
   sanitizeSearchItems,
-} from './coupang.js';
+} from './utils.js';
 
 describe('normalizeProductId', () => {
   it('extracts product id from canonical path', () => {

package/src/clis/ctrip/search.ts

@@ -11,7 +11,7 @@ cli({
   domain: 'www.ctrip.com',
   strategy: Strategy.COOKIE,
   args: [
-    { name: 'query', required: true, help: 'Search keyword (city or attraction)' },
+    { name: 'query', required: true, positional: true, help: 'Search keyword (city or attraction)' },
     { name: 'limit', type: 'int', default: 15, help: 'Number of results' },
   ],
   columns: ['rank', 'name', 'type', 'score', 'price', 'url'],

package/src/clis/cursor/export.ts

@@ -11,7 +11,7 @@ function makeExportCommand(site: string, readSelector: string) {
     strategy: Strategy.UI,
     browser: true,
     args: [
-      { name: 'output', required: false, positional: true, help: `Output file (default: /tmp/${site}-export.md)` },
+      { name: 'output', required: false,  help: `Output file (default: /tmp/${site}-export.md)` },
     ],
     columns: ['Status', 'File', 'Messages'],
     func: async (page: IPage, kwargs: any) => {