@jackwener/opencli 0.5.1 → 0.6.0

package/README.md

@@ -9,7 +9,7 @@
 [![Node.js Version](https://img.shields.io/node/v/@jackwener/opencli?style=flat-square)](https://nodejs.org)
 [![License](https://img.shields.io/npm/l/@jackwener/opencli?style=flat-square)](./LICENSE)
 
-A CLI tool that turns **any website** into a command-line interface. **57 commands** across **17 sites** — bilibili, zhihu, xiaohongshu, twitter, reddit, xueqiu, github, v2ex, hackernews, bbc, weibo, boss, yahoo-finance, reuters, smzdm, ctrip, youtube — powered by browser session reuse and AI-native discovery.
+A CLI tool that turns **any website** into a command-line interface. **59 commands** across **18 sites** — bilibili, zhihu, xiaohongshu, twitter, reddit, xueqiu, github, v2ex, hackernews, bbc, weibo, boss, yahoo-finance, reuters, smzdm, ctrip, youtube, coupang — powered by browser session reuse and AI-native discovery.
 
 ---
 
@@ -126,13 +126,14 @@ npm install -g @jackwener/opencli@latest
 | **reddit** | `hot` `frontpage` `search` `subreddit` | 🔐 Browser |
 | **weibo** | `hot` | 🔐 Browser |
 | **boss** | `search` | 🔐 Browser |
+| **coupang** | `search` `add-to-cart` | 🔐 Browser |
 | **youtube** | `search` | 🔐 Browser |
 | **yahoo-finance** | `quote` | 🔐 Browser |
 | **reuters** | `search` | 🔐 Browser |
 | **smzdm** | `search` | 🔐 Browser |
 | **ctrip** | `search` | 🔐 Browser |
 | **github** | `search` | 🌐 Public |
-| **v2ex** | `hot` `latest` `topic` | 🌐 Public |
+| **v2ex** | `hot` `latest` `topic` `daily` `me` `notifications` | 🌐 Public / 🔐 Browser |
 | **hackernews** | `top` | 🌐 Public |
 | **bbc** | `news` | 🌐 Public |
 

package/README.zh-CN.md

@@ -9,7 +9,7 @@
 [![Node.js Version](https://img.shields.io/node/v/@jackwener/opencli?style=flat-square)](https://nodejs.org)
 [![License](https://img.shields.io/npm/l/@jackwener/opencli?style=flat-square)](./LICENSE)
 
-OpenCLI 将任何网站变成命令行工具。**57 个命令**覆盖 **17 个站点** — B站、知乎、小红书、Twitter、Reddit、雪球、GitHub、V2EX、Hacker News、BBC、微博、BOSS直聘、Yahoo Finance、路透社、什么值得买、携程、YouTube — 复用浏览器登录态，AI 驱动探索。
+OpenCLI 将任何网站变成命令行工具。**59 个命令**覆盖 **18 个站点** — B站、知乎、小红书、Twitter、Reddit、雪球、GitHub、V2EX、Hacker News、BBC、微博、BOSS直聘、Yahoo Finance、路透社、什么值得买、携程、YouTube、Coupang — 复用浏览器登录态，AI 驱动探索。
 
 ---
 
@@ -29,7 +29,7 @@ OpenCLI 将任何网站变成命令行工具。**57 个命令**覆盖 **17 个
 
 ## 亮点
 
-- **57 个命令，17 个站点** — B站、知乎、小红书、Twitter、Reddit、雪球(xueqiu)、GitHub、V2EX、Hacker News、BBC、微博、BOSS直聘、Yahoo Finance、路透社、什么值得买、携程、YouTube
+- **59 个命令，18 个站点** — B站、知乎、小红书、Twitter、Reddit、雪球(xueqiu)、GitHub、V2EX、Hacker News、BBC、微博、BOSS直聘、Yahoo Finance、路透社、什么值得买、携程、YouTube、Coupang
 - **零风控** — 复用 Chrome 登录态，无需存储任何凭证
 - **AI 原生** — `explore` 自动发现 API，`synthesize` 生成适配器，`cascade` 探测认证策略
 - **动态加载引擎** — 声明式的 `.yaml` 或者底层定制的 `.ts` 适配器，放入 `clis/` 文件夹即可自动注册生效
@@ -126,13 +126,14 @@ npm install -g @jackwener/opencli@latest
 | **reddit** | `hot` `frontpage` `search` `subreddit` | 🔐 浏览器 |
 | **weibo** | `hot` | 🔐 浏览器 |
 | **boss** | `search` | 🔐 浏览器 |
+| **coupang** | `search` `add-to-cart` | 🔐 浏览器 |
 | **youtube** | `search` | 🔐 浏览器 |
 | **yahoo-finance** | `quote` | 🔐 浏览器 |
 | **reuters** | `search` | 🔐 浏览器 |
 | **smzdm** | `search` | 🔐 浏览器 |
 | **ctrip** | `search` | 🔐 浏览器 |
 | **github** | `search` | 🌐 公共 API |
-| **v2ex** | `hot` `latest` `topic` | 🌐 公共 API |
+| **v2ex** | `hot` `latest` `topic` `daily` `me` `notifications` | 🌐 公共 API / 🔐 浏览器 |
 | **hackernews** | `top` | 🌐 公共 API |
 | **bbc** | `news` | 🌐 公共 API |
 

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: opencli
 description: "OpenCLI — Make any website your CLI. Zero risk, AI-powered, reuse Chrome login."
-version: 0.5.0
+version: 0.5.1
 author: jackwener
 tags: [cli, browser, web, mcp, playwright, bilibili, zhihu, twitter, github, v2ex, hackernews, reddit, xiaohongshu, xueqiu, AI, agent]
 ---
@@ -95,10 +95,13 @@ opencli reddit frontpage --limit 10      # 首页
 opencli reddit search --keyword "AI"     # 搜索
 opencli reddit subreddit --name rust     # 子版块浏览
 
-# V2EX (public)
+# V2EX (public + browser)
 opencli v2ex hot --limit 10              # 热门话题
 opencli v2ex latest --limit 10           # 最新话题
 opencli v2ex topic --id 1024             # 主题详情
+opencli v2ex daily                       # 每日签到 (browser)
+opencli v2ex me                          # 我的信息 (browser)
+opencli v2ex notifications --limit 10    # 通知 (browser)
 
 # Hacker News (public)
 opencli hackernews top --limit 10        # Top stories
@@ -156,8 +159,8 @@ opencli cascade <api-url>
 # Explore with interactive fuzzing (click buttons to trigger lazy APIs)
 opencli explore <url> --auto --click "字幕,CC,评论"
 
-# Verify: smoke-test a generated adapter
-opencli verify <site/name> --smoke
+# Verify: validate adapter definitions
+opencli verify
 ```
 
 ## Output Formats

package/dist/browser.d.ts

@@ -2,6 +2,7 @@
  * Browser interaction via Playwright MCP Bridge extension.
  * Connects to an existing Chrome browser through the extension.
  */
+import { withTimeoutMs } from './runtime.js';
 type ConnectFailureKind = 'missing-token' | 'extension-timeout' | 'extension-not-installed' | 'mcp-init' | 'process-exit' | 'unknown';
 type PlaywrightMCPState = 'idle' | 'connecting' | 'connected' | 'closing' | 'closed';
 type ConnectFailureInput = {
@@ -29,7 +30,6 @@ export declare class Page implements IPage {
     call(method: string, params?: Record<string, any>): Promise<any>;
     goto(url: string): Promise<void>;
     evaluate(js: string): Promise<any>;
-    private normalizeEval;
     snapshot(opts?: {
         interactive?: boolean;
         compact?: boolean;
@@ -90,12 +90,16 @@ declare function diffTabIndexes(initialIdentities: string[], currentTabs: Array<
     identity: string;
 }>): number[];
 declare function appendLimited(current: string, chunk: string, limit: number): string;
-declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, message: string): Promise<T>;
+declare function buildMcpArgs(input: {
+    mcpPath: string;
+    executablePath?: string | null;
+}): string[];
 export declare const __test__: {
     createJsonRpcRequest: typeof createJsonRpcRequest;
     extractTabEntries: typeof extractTabEntries;
     diffTabIndexes: typeof diffTabIndexes;
     appendLimited: typeof appendLimited;
-    withTimeout: typeof withTimeout;
+    buildMcpArgs: typeof buildMcpArgs;
+    withTimeoutMs: typeof withTimeoutMs;
 };
 export {};

package/dist/browser.js

@@ -9,14 +9,10 @@ import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
 import { formatSnapshot } from './snapshotFormatter.js';
-// Read version from package.json (single source of truth)
-const __browser_dirname = path.dirname(fileURLToPath(import.meta.url));
-const PKG_VERSION = (() => { try {
-    return JSON.parse(fs.readFileSync(path.resolve(__browser_dirname, '..', 'package.json'), 'utf-8')).version;
-}
-catch {
-    return '0.0.0';
-} })();
+import { PKG_VERSION } from './version.js';
+import { normalizeEvaluateSource } from './pipeline/template.js';
+import { generateInterceptorJs, generateReadInterceptedJs } from './interceptor.js';
+import { withTimeoutMs } from './runtime.js';
 const CONNECT_TIMEOUT = parseInt(process.env.OPENCLI_BROWSER_CONNECT_TIMEOUT ?? '30', 10);
 const STDERR_BUFFER_LIMIT = 16 * 1024;
 const INITIAL_TABS_TIMEOUT_MS = 1500;
@@ -126,26 +122,9 @@ export class Page {
     }
     async evaluate(js) {
         // Normalize IIFE format to function format expected by MCP browser_evaluate
-        const normalized = this.normalizeEval(js);
+        const normalized = normalizeEvaluateSource(js);
         return this.call('tools/call', { name: 'browser_evaluate', arguments: { function: normalized } });
     }
-    normalizeEval(source) {
-        const s = source.trim();
-        if (!s)
-            return '() => undefined';
-        // IIFE: (async () => {...})()  →  wrap as () => (...)
-        if (s.startsWith('(') && s.endsWith(')()'))
-            return `() => (${s})`;
-        // Already a function/arrow
-        if (/^(async\s+)?\([^)]*\)\s*=>/.test(s))
-            return s;
-        if (/^(async\s+)?[A-Za-z_][A-Za-z0-9_]*\s*=>/.test(s))
-            return s;
-        if (s.startsWith('function ') || s.startsWith('async function '))
-            return s;
-        // Raw expression → wrap
-        return `() => (${s})`;
-    }
     async snapshot(opts = {}) {
         const raw = await this.call('tools/call', { name: 'browser_snapshot', arguments: {} });
         if (opts.raw)
@@ -224,56 +203,14 @@ export class Page {
         await this.evaluate(js);
     }
     async installInterceptor(pattern) {
-        const js = `
-      () => {
-        window.__opencli_xhr = window.__opencli_xhr || [];
-        window.__opencli_patterns = window.__opencli_patterns || [];
-        if (!window.__opencli_patterns.includes('${pattern}')) {
-          window.__opencli_patterns.push('${pattern}');
-        }
-        
-        if (!window.__patched_xhr) {
-          const checkMatch = (url) => window.__opencli_patterns.some(p => url.includes(p));
-
-          const XHR = XMLHttpRequest.prototype;
-          const open = XHR.open;
-          const send = XHR.send;
-          XHR.open = function(method, url) {
-            this._url = url;
-            return open.call(this, method, url, ...Array.prototype.slice.call(arguments, 2));
-          };
-          XHR.send = function() {
-            this.addEventListener('load', function() {
-              if (checkMatch(this._url)) {
-                try { window.__opencli_xhr.push({url: this._url, data: JSON.parse(this.responseText)}); } catch(e){}
-              }
-            });
-            return send.apply(this, arguments);
-          };
-
-          const origFetch = window.fetch;
-          window.fetch = async function(...args) {
-            let u = typeof args[0] === 'string' ? args[0] : (args[0] && args[0].url) || '';
-            const res = await origFetch.apply(this, args);
-            setTimeout(async () => {
-              try {
-                if (checkMatch(u)) {
-                  const clone = res.clone();
-                  const j = await clone.json();
-                  window.__opencli_xhr.push({url: u, data: j});
-                }
-              } catch(e) {}
-            }, 0);
-            return res;
-          };
-          window.__patched_xhr = true;
-        }
-      }
-    `;
-        await this.evaluate(js);
+        await this.evaluate(generateInterceptorJs(JSON.stringify(pattern), {
+            arrayName: '__opencli_xhr',
+            patchGuard: '__opencli_interceptor_patched',
+        }));
     }
     async getInterceptedRequests() {
-        return (await this.evaluate('() => window.__opencli_xhr')) || [];
+        const result = await this.evaluate(generateReadInterceptedJs('__opencli_xhr'));
+        return result || [];
     }
 }
 /**
@@ -402,13 +339,13 @@ export class PlaywrightMCP {
                     stderr: stderrBuffer,
                 }));
             }, timeout * 1000);
-            const mcpArgs = [mcpPath, '--extension'];
+            const mcpArgs = buildMcpArgs({
+                mcpPath,
+                executablePath: process.env.OPENCLI_BROWSER_EXECUTABLE_PATH,
+            });
             if (process.env.OPENCLI_VERBOSE) {
                 console.error(`[opencli] Extension token: ${extensionToken ? `configured (fingerprint ${tokenFingerprint})` : 'missing'}`);
             }
-            if (process.env.OPENCLI_BROWSER_EXECUTABLE_PATH) {
-                mcpArgs.push('--executablePath', process.env.OPENCLI_BROWSER_EXECUTABLE_PATH);
-            }
             debugLog(`Spawning node ${mcpArgs.join(' ')}`);
             this._proc = spawn('node', mcpArgs, {
                 stdio: ['pipe', 'pipe', 'pipe'],
@@ -485,7 +422,7 @@ export class PlaywrightMCP {
                 this._proc?.stdin?.write(initializedMsg);
                 // Use tabs as a readiness probe and for tab cleanup bookkeeping.
                 debugLog('Fetching initial tabs count...');
-                withTimeout(page.tabs(), INITIAL_TABS_TIMEOUT_MS, 'Timed out fetching initial tabs').then((tabs) => {
+                withTimeoutMs(page.tabs(), INITIAL_TABS_TIMEOUT_MS, 'Timed out fetching initial tabs').then((tabs) => {
                     debugLog(`Tabs response: ${typeof tabs === 'string' ? tabs : JSON.stringify(tabs)}`);
                     this._initialTabIdentities = extractTabIdentities(tabs);
                     settleSuccess(page);
@@ -510,7 +447,7 @@ export class PlaywrightMCP {
                 // Extension mode opens bridge/session tabs that we can clean up best-effort.
                 if (this._page && this._proc && !this._proc.killed) {
                     try {
-                        const tabs = await withTimeout(this._page.tabs(), TAB_CLEANUP_TIMEOUT_MS, 'Timed out fetching tabs during cleanup');
+                        const tabs = await withTimeoutMs(this._page.tabs(), TAB_CLEANUP_TIMEOUT_MS, 'Timed out fetching tabs during cleanup');
                         const tabEntries = extractTabEntries(tabs);
                         const tabsToClose = diffTabIndexes(this._initialTabIdentities, tabEntries);
                         for (const index of tabsToClose) {
@@ -621,24 +558,20 @@ function appendLimited(current, chunk, limit) {
         return next;
     return next.slice(-limit);
 }
-function withTimeout(promise, timeoutMs, message) {
-    return new Promise((resolve, reject) => {
-        const timer = setTimeout(() => reject(new Error(message)), timeoutMs);
-        promise.then((value) => {
-            clearTimeout(timer);
-            resolve(value);
-        }, (error) => {
-            clearTimeout(timer);
-            reject(error);
-        });
-    });
+function buildMcpArgs(input) {
+    const args = [input.mcpPath, '--extension'];
+    if (input.executablePath) {
+        args.push('--executable-path', input.executablePath);
+    }
+    return args;
 }
 export const __test__ = {
     createJsonRpcRequest,
     extractTabEntries,
     diffTabIndexes,
     appendLimited,
-    withTimeout,
+    buildMcpArgs,
+    withTimeoutMs,
 };
 function findMcpServerPath() {
     if (_cachedMcpServerPath !== undefined)

package/dist/browser.test.js

@@ -34,8 +34,25 @@ describe('browser helpers', () => {
     it('keeps only the tail of stderr buffers', () => {
         expect(__test__.appendLimited('12345', '67890', 8)).toBe('34567890');
     });
+    it('builds Playwright MCP args with kebab-case executable path', () => {
+        expect(__test__.buildMcpArgs({
+            mcpPath: '/tmp/cli.js',
+            executablePath: '/mnt/c/Program Files/Google/Chrome/Application/chrome.exe',
+        })).toEqual([
+            '/tmp/cli.js',
+            '--extension',
+            '--executable-path',
+            '/mnt/c/Program Files/Google/Chrome/Application/chrome.exe',
+        ]);
+        expect(__test__.buildMcpArgs({
+            mcpPath: '/tmp/cli.js',
+        })).toEqual([
+            '/tmp/cli.js',
+            '--extension',
+        ]);
+    });
     it('times out slow promises', async () => {
-        await expect(__test__.withTimeout(new Promise(() => { }), 10, 'timeout')).rejects.toThrow('timeout');
+        await expect(__test__.withTimeoutMs(new Promise(() => { }), 10, 'timeout')).rejects.toThrow('timeout');
     });
 });
 describe('PlaywrightMCP state', () => {

package/dist/cascade.d.ts

@@ -28,7 +28,7 @@ interface CascadeResult {
  * Probe an endpoint with a specific strategy.
  * Returns whether the probe succeeded and basic response info.
  */
-export declare function probeEndpoint(page: IPage, url: string, strategy: Strategy, opts?: {
+export declare function probeEndpoint(page: IPage, url: string, strategy: Strategy, _opts?: {
     timeout?: number;
 }): Promise<ProbeResult>;
 /**

package/dist/cascade.js

@@ -18,34 +18,54 @@ const CASCADE_ORDER = [
     Strategy.INTERCEPT,
     Strategy.UI,
 ];
+/**
+ * Build the JavaScript source for a fetch probe.
+ * Shared logic for PUBLIC, COOKIE, and HEADER strategies.
+ */
+function buildFetchProbeJs(url, opts) {
+    const credentialsLine = opts.credentials ? `credentials: 'include',` : '';
+    const headerSetup = opts.extractCsrf
+        ? `
+      const cookies = document.cookie.split(';').map(c => c.trim());
+      const csrf = cookies.find(c => c.startsWith('ct0=') || c.startsWith('csrf_token=') || c.startsWith('_csrf='))?.split('=').slice(1).join('=');
+      const headers = {};
+      if (csrf) { headers['X-Csrf-Token'] = csrf; headers['X-XSRF-Token'] = csrf; }
+    `
+        : 'const headers = {};';
+    return `
+    async () => {
+      try {
+        ${headerSetup}
+        const resp = await fetch(${JSON.stringify(url)}, {
+          ${credentialsLine}
+          headers
+        });
+        const status = resp.status;
+        if (!resp.ok) return { status, ok: false };
+        const text = await resp.text();
+        let hasData = false;
+        try {
+          const json = JSON.parse(text);
+          hasData = !!json && (Array.isArray(json) ? json.length > 0 :
+            typeof json === 'object' && Object.keys(json).length > 0);
+          // Check for API-level error codes (common in Chinese sites)
+          if (json.code !== undefined && json.code !== 0) hasData = false;
+        } catch {}
+        return { status, ok: true, hasData, preview: text.slice(0, 200) };
+      } catch (e) { return { ok: false, error: e.message }; }
+    }
+  `;
+}
 /**
  * Probe an endpoint with a specific strategy.
  * Returns whether the probe succeeded and basic response info.
  */
-export async function probeEndpoint(page, url, strategy, opts = {}) {
+export async function probeEndpoint(page, url, strategy, _opts = {}) {
     const result = { strategy, success: false };
     try {
         switch (strategy) {
             case Strategy.PUBLIC: {
-                // Try direct fetch without browser (no credentials)
-                const js = `
-          async () => {
-            try {
-              const resp = await fetch(${JSON.stringify(url)});
-              const status = resp.status;
-              if (!resp.ok) return { status, ok: false };
-              const text = await resp.text();
-              let hasData = false;
-              try {
-                const json = JSON.parse(text);
-                hasData = !!json && (Array.isArray(json) ? json.length > 0 :
-                  typeof json === 'object' && Object.keys(json).length > 0);
-              } catch {}
-              return { status, ok: true, hasData, preview: text.slice(0, 200) };
-            } catch (e) { return { ok: false, error: e.message }; }
-          }
-        `;
-                const resp = await page.evaluate(js);
+                const resp = await page.evaluate(buildFetchProbeJs(url, {}));
                 result.statusCode = resp?.status;
                 result.success = resp?.ok && resp?.hasData;
                 result.hasData = resp?.hasData;
@@ -53,27 +73,7 @@ export async function probeEndpoint(page, url, strategy, opts = {}) {
                 break;
             }
             case Strategy.COOKIE: {
-                // Fetch with credentials: 'include' (uses browser cookies)
-                const js = `
-          async () => {
-            try {
-              const resp = await fetch(${JSON.stringify(url)}, { credentials: 'include' });
-              const status = resp.status;
-              if (!resp.ok) return { status, ok: false };
-              const text = await resp.text();
-              let hasData = false;
-              try {
-                const json = JSON.parse(text);
-                hasData = !!json && (Array.isArray(json) ? json.length > 0 :
-                  typeof json === 'object' && Object.keys(json).length > 0);
-                // Check for API-level error codes (common in Chinese sites)
-                if (json.code !== undefined && json.code !== 0) hasData = false;
-              } catch {}
-              return { status, ok: true, hasData, preview: text.slice(0, 200) };
-            } catch (e) { return { ok: false, error: e.message }; }
-          }
-        `;
-                const resp = await page.evaluate(js);
+                const resp = await page.evaluate(buildFetchProbeJs(url, { credentials: true }));
                 result.statusCode = resp?.status;
                 result.success = resp?.ok && resp?.hasData;
                 result.hasData = resp?.hasData;
@@ -81,39 +81,7 @@ export async function probeEndpoint(page, url, strategy, opts = {}) {
                 break;
             }
             case Strategy.HEADER: {
-                // Fetch with credentials + try to extract common auth headers
-                const js = `
-          async () => {
-            try {
-              // Try to extract CSRF tokens from cookies
-              const cookies = document.cookie.split(';').map(c => c.trim());
-              const csrf = cookies.find(c => c.startsWith('ct0=') || c.startsWith('csrf_token=') || c.startsWith('_csrf='))?.split('=').slice(1).join('=');
-              
-              const headers = {};
-              if (csrf) {
-                headers['X-Csrf-Token'] = csrf;
-                headers['X-XSRF-Token'] = csrf;
-              }
-              
-              const resp = await fetch(${JSON.stringify(url)}, {
-                credentials: 'include',
-                headers
-              });
-              const status = resp.status;
-              if (!resp.ok) return { status, ok: false };
-              const text = await resp.text();
-              let hasData = false;
-              try {
-                const json = JSON.parse(text);
-                hasData = !!json && (Array.isArray(json) ? json.length > 0 :
-                  typeof json === 'object' && Object.keys(json).length > 0);
-                if (json.code !== undefined && json.code !== 0) hasData = false;
-              } catch {}
-              return { status, ok: true, hasData, preview: text.slice(0, 200) };
-            } catch (e) { return { ok: false, error: e.message }; }
-          }
-        `;
-                const resp = await page.evaluate(js);
+                const resp = await page.evaluate(buildFetchProbeJs(url, { credentials: true, extractCsrf: true }));
                 result.statusCode = resp?.status;
                 result.success = resp?.ok && resp?.hasData;
                 result.hasData = resp?.hasData;
@@ -123,7 +91,6 @@ export async function probeEndpoint(page, url, strategy, opts = {}) {
             case Strategy.INTERCEPT:
             case Strategy.UI:
                 // These require specific implementation per-site
-                // Mark as needing manual implementation
                 result.success = false;
                 result.error = `Strategy ${strategy} requires site-specific implementation`;
                 break;

package/dist/cli-manifest.json

@@ -470,6 +470,86 @@
       "url"
     ]
   },
+  {
+    "site": "coupang",
+    "name": "add-to-cart",
+    "description": "Add a Coupang product to cart using logged-in browser session",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "productId",
+        "type": "str",
+        "required": false,
+        "help": "Coupang product ID"
+      },
+      {
+        "name": "url",
+        "type": "str",
+        "required": false,
+        "help": "Canonical product URL"
+      }
+    ],
+    "type": "ts",
+    "modulePath": "coupang/add-to-cart.js",
+    "domain": "www.coupang.com",
+    "columns": [
+      "ok",
+      "product_id",
+      "url",
+      "message"
+    ]
+  },
+  {
+    "site": "coupang",
+    "name": "search",
+    "description": "Search Coupang products with logged-in browser session",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "query",
+        "type": "str",
+        "required": true,
+        "help": "Search keyword"
+      },
+      {
+        "name": "page",
+        "type": "int",
+        "default": 1,
+        "required": false,
+        "help": "Search result page number"
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "help": "Max results (max 50)"
+      },
+      {
+        "name": "filter",
+        "type": "str",
+        "required": false,
+        "help": "Optional search filter (currently supports: rocket)"
+      }
+    ],
+    "type": "ts",
+    "modulePath": "coupang/search.js",
+    "domain": "www.coupang.com",
+    "columns": [
+      "rank",
+      "title",
+      "price",
+      "unit_price",
+      "rating",
+      "review_count",
+      "rocket",
+      "delivery_type",
+      "delivery_promise",
+      "url"
+    ]
+  },
   {
     "site": "ctrip",
     "name": "search",

package/dist/clis/coupang/add-to-cart.d.ts

@@ -0,0 +1 @@
+export {};