@jackwener/opencli 0.7.10 → 0.7.11

package/.github/workflows/pkg-pr-new.yml

@@ -0,0 +1,30 @@
+name: Publish Any Commit
+
+on:
+  push:
+    branches: [main, dev]
+  pull_request:
+    branches: [main, dev]
+
+permissions: {}
+
+jobs:
+  publish:
+    if: ${{ vars.PKG_PR_NEW_ENABLED == 'true' }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish to pkg.pr.new
+        run: npx pkg-pr-new publish

package/README.md

@@ -44,6 +44,7 @@ A CLI tool that turns **any website** into a command-line interface — Bilibili
 > **⚠️ Important**: Browser commands reuse your Chrome login session. You must be logged into the target website in Chrome before running commands. If you get empty data or errors, check your login status first.
 
 OpenCLI connects to your browser through the Playwright MCP Bridge extension.
+It prefers an existing local/global `@playwright/mcp` install and falls back to `npx -y @playwright/mcp@latest` automatically when no local MCP server is found.
 
 ### Playwright MCP Bridge Extension Setup
 

package/README.zh-CN.md

@@ -43,6 +43,7 @@ OpenCLI 将任何网站变成命令行工具 — B站、知乎、小红书、Twi
 > **⚠️ 重要**：大多数命令复用你的 Chrome 登录状态。运行命令前，你必须已在 Chrome 中打开目标网站并完成登录。如果获取到空数据或报错，请先检查你的浏览器登录状态。
 
 OpenCLI 通过 Playwright MCP Bridge 扩展与你的浏览器通信。
+它会优先复用本地或全局已安装的 `@playwright/mcp`，如果没有嗅探到可用 MCP server，则会自动回退到 `npx -y @playwright/mcp@latest` 启动。
 
 ### Playwright MCP Bridge 扩展配置
 

package/dist/browser/discover.d.ts

@@ -1,8 +1,23 @@
 /**
  * MCP server path discovery and argument building.
  */
+import { execSync } from 'node:child_process';
+import * as fs from 'node:fs';
+export declare function resetMcpServerPathCache(): void;
+export declare function setMcpDiscoveryTestHooks(input?: {
+    existsSync?: typeof fs.existsSync;
+    execSync?: typeof execSync;
+}): void;
 export declare function findMcpServerPath(): string | null;
 export declare function buildMcpArgs(input: {
     mcpPath: string;
     executablePath?: string | null;
 }): string[];
+export declare function buildMcpLaunchSpec(input: {
+    mcpPath?: string | null;
+    executablePath?: string | null;
+}): {
+    command: string;
+    args: string[];
+    usedNpxFallback: boolean;
+};

package/dist/browser/discover.js

@@ -7,27 +7,57 @@ import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
 let _cachedMcpServerPath;
+let _existsSync = fs.existsSync;
+let _execSync = execSync;
+export function resetMcpServerPathCache() {
+    _cachedMcpServerPath = undefined;
+}
+export function setMcpDiscoveryTestHooks(input) {
+    _existsSync = input?.existsSync ?? fs.existsSync;
+    _execSync = input?.execSync ?? execSync;
+}
 export function findMcpServerPath() {
     if (_cachedMcpServerPath !== undefined)
         return _cachedMcpServerPath;
     const envMcp = process.env.OPENCLI_MCP_SERVER_PATH;
-    if (envMcp && fs.existsSync(envMcp)) {
+    if (envMcp && _existsSync(envMcp)) {
         _cachedMcpServerPath = envMcp;
         return _cachedMcpServerPath;
     }
     // Check local node_modules first (@playwright/mcp is the modern package)
     const localMcp = path.resolve('node_modules', '@playwright', 'mcp', 'cli.js');
-    if (fs.existsSync(localMcp)) {
+    if (_existsSync(localMcp)) {
         _cachedMcpServerPath = localMcp;
         return _cachedMcpServerPath;
     }
     // Check project-relative path
     const __dirname2 = path.dirname(fileURLToPath(import.meta.url));
     const projectMcp = path.resolve(__dirname2, '..', '..', 'node_modules', '@playwright', 'mcp', 'cli.js');
-    if (fs.existsSync(projectMcp)) {
+    if (_existsSync(projectMcp)) {
         _cachedMcpServerPath = projectMcp;
         return _cachedMcpServerPath;
     }
+    // Check global npm/yarn locations derived from current Node runtime.
+    const nodePrefix = path.resolve(path.dirname(process.execPath), '..');
+    const globalNodeModules = path.join(nodePrefix, 'lib', 'node_modules');
+    const globalMcp = path.join(globalNodeModules, '@playwright', 'mcp', 'cli.js');
+    if (_existsSync(globalMcp)) {
+        _cachedMcpServerPath = globalMcp;
+        return _cachedMcpServerPath;
+    }
+    // Check npm global root directly.
+    try {
+        const npmRootGlobal = _execSync('npm root -g 2>/dev/null', {
+            encoding: 'utf-8',
+            timeout: 5000,
+        }).trim();
+        const npmGlobalMcp = path.join(npmRootGlobal, '@playwright', 'mcp', 'cli.js');
+        if (npmRootGlobal && _existsSync(npmGlobalMcp)) {
+            _cachedMcpServerPath = npmGlobalMcp;
+            return _cachedMcpServerPath;
+        }
+    }
+    catch { }
     // Check common locations
     const candidates = [
         path.join(os.homedir(), '.npm', '_npx'),
@@ -36,8 +66,8 @@ export function findMcpServerPath() {
     ];
     // Try npx resolution (legacy package name)
     try {
-        const result = execSync('npx -y --package=@playwright/mcp which mcp-server-playwright 2>/dev/null', { encoding: 'utf-8', timeout: 10000 }).trim();
-        if (result && fs.existsSync(result)) {
+        const result = _execSync('npx -y --package=@playwright/mcp which mcp-server-playwright 2>/dev/null', { encoding: 'utf-8', timeout: 10000 }).trim();
+        if (result && _existsSync(result)) {
             _cachedMcpServerPath = result;
             return _cachedMcpServerPath;
         }
@@ -45,8 +75,8 @@ export function findMcpServerPath() {
     catch { }
     // Try which
     try {
-        const result = execSync('which mcp-server-playwright 2>/dev/null', { encoding: 'utf-8', timeout: 5000 }).trim();
-        if (result && fs.existsSync(result)) {
+        const result = _execSync('which mcp-server-playwright 2>/dev/null', { encoding: 'utf-8', timeout: 5000 }).trim();
+        if (result && _existsSync(result)) {
             _cachedMcpServerPath = result;
             return _cachedMcpServerPath;
         }
@@ -54,10 +84,10 @@ export function findMcpServerPath() {
     catch { }
     // Search in common npx cache
     for (const base of candidates) {
-        if (!fs.existsSync(base))
+        if (!_existsSync(base))
             continue;
         try {
-            const found = execSync(`find "${base}" -name "cli.js" -path "*playwright*mcp*" 2>/dev/null | head -1`, { encoding: 'utf-8', timeout: 5000 }).trim();
+            const found = _execSync(`find "${base}" -name "cli.js" -path "*playwright*mcp*" 2>/dev/null | head -1`, { encoding: 'utf-8', timeout: 5000 }).trim();
             if (found) {
                 _cachedMcpServerPath = found;
                 return _cachedMcpServerPath;
@@ -68,16 +98,34 @@ export function findMcpServerPath() {
     _cachedMcpServerPath = null;
     return _cachedMcpServerPath;
 }
-export function buildMcpArgs(input) {
-    const args = [input.mcpPath];
+function buildRuntimeArgs(input) {
+    const args = [];
     if (!process.env.CI) {
         // Local: always connect to user's running Chrome via MCP Bridge extension
         args.push('--extension');
     }
     // CI: standalone mode — @playwright/mcp launches its own browser (headed by default).
     // xvfb provides a virtual display for headed mode in GitHub Actions.
-    if (input.executablePath) {
+    if (input?.executablePath) {
         args.push('--executable-path', input.executablePath);
     }
     return args;
 }
+export function buildMcpArgs(input) {
+    return [input.mcpPath, ...buildRuntimeArgs(input)];
+}
+export function buildMcpLaunchSpec(input) {
+    const runtimeArgs = buildRuntimeArgs(input);
+    if (input.mcpPath) {
+        return {
+            command: 'node',
+            args: [input.mcpPath, ...runtimeArgs],
+            usedNpxFallback: false,
+        };
+    }
+    return {
+        command: 'npx',
+        args: ['-y', '@playwright/mcp@latest', ...runtimeArgs],
+        usedNpxFallback: true,
+    };
+}

package/dist/browser/index.d.ts

@@ -10,7 +10,7 @@ export { getTokenFingerprint, formatBrowserConnectError } from './errors.js';
 export type { ConnectFailureKind, ConnectFailureInput } from './errors.js';
 import { createJsonRpcRequest } from './mcp.js';
 import { extractTabEntries, diffTabIndexes, appendLimited } from './tabs.js';
-import { buildMcpArgs } from './discover.js';
+import { buildMcpArgs, buildMcpLaunchSpec, findMcpServerPath, resetMcpServerPathCache, setMcpDiscoveryTestHooks } from './discover.js';
 import { withTimeoutMs } from '../runtime.js';
 export declare const __test__: {
     createJsonRpcRequest: typeof createJsonRpcRequest;
@@ -18,5 +18,9 @@ export declare const __test__: {
     diffTabIndexes: typeof diffTabIndexes;
     appendLimited: typeof appendLimited;
     buildMcpArgs: typeof buildMcpArgs;
+    buildMcpLaunchSpec: typeof buildMcpLaunchSpec;
+    findMcpServerPath: typeof findMcpServerPath;
+    resetMcpServerPathCache: typeof resetMcpServerPathCache;
+    setMcpDiscoveryTestHooks: typeof setMcpDiscoveryTestHooks;
     withTimeoutMs: typeof withTimeoutMs;
 };

package/dist/browser/index.js

@@ -10,7 +10,7 @@ export { getTokenFingerprint, formatBrowserConnectError } from './errors.js';
 // Test-only helpers — exposed for unit tests
 import { createJsonRpcRequest } from './mcp.js';
 import { extractTabEntries, diffTabIndexes, appendLimited } from './tabs.js';
-import { buildMcpArgs } from './discover.js';
+import { buildMcpArgs, buildMcpLaunchSpec, findMcpServerPath, resetMcpServerPathCache, setMcpDiscoveryTestHooks } from './discover.js';
 import { withTimeoutMs } from '../runtime.js';
 export const __test__ = {
     createJsonRpcRequest,
@@ -18,5 +18,9 @@ export const __test__ = {
     diffTabIndexes,
     appendLimited,
     buildMcpArgs,
+    buildMcpLaunchSpec,
+    findMcpServerPath,
+    resetMcpServerPathCache,
+    setMcpDiscoveryTestHooks,
     withTimeoutMs,
 };

package/dist/browser/mcp.js

@@ -7,7 +7,7 @@ import { withTimeoutMs, DEFAULT_BROWSER_CONNECT_TIMEOUT } from '../runtime.js';
 import { PKG_VERSION } from '../version.js';
 import { Page } from './page.js';
 import { getTokenFingerprint, formatBrowserConnectError, inferConnectFailureKind } from './errors.js';
-import { findMcpServerPath, buildMcpArgs } from './discover.js';
+import { findMcpServerPath, buildMcpLaunchSpec } from './discover.js';
 import { extractTabIdentities, extractTabEntries, diffTabIndexes, appendLimited } from './tabs.js';
 const STDERR_BUFFER_LIMIT = 16 * 1024;
 const INITIAL_TABS_TIMEOUT_MS = 1500;
@@ -102,8 +102,6 @@ export class PlaywrightMCP {
         if (this._state === 'closed')
             throw new Error('Playwright MCP session is closed');
         const mcpPath = findMcpServerPath();
-        if (!mcpPath)
-            throw new Error('Playwright MCP server not found. Install: npm install -D @playwright/mcp');
         PlaywrightMCP._registerGlobalCleanup();
         PlaywrightMCP._activeInsts.add(this);
         this._state = 'connecting';
@@ -148,7 +146,7 @@ export class PlaywrightMCP {
                     stderr: stderrBuffer,
                 }));
             }, timeout * 1000);
-            const mcpArgs = buildMcpArgs({
+            const launchSpec = buildMcpLaunchSpec({
                 mcpPath,
                 executablePath: process.env.OPENCLI_BROWSER_EXECUTABLE_PATH,
             });
@@ -156,9 +154,12 @@ export class PlaywrightMCP {
                 console.error(`[opencli] Mode: ${useExtension ? 'extension' : 'standalone'}`);
                 if (useExtension)
                     console.error(`[opencli] Extension token: fingerprint ${tokenFingerprint}`);
+                if (launchSpec.usedNpxFallback) {
+                    console.error('[opencli] Playwright MCP not found locally; bootstrapping via npx @playwright/mcp@latest');
+                }
             }
-            debugLog(`Spawning node ${mcpArgs.join(' ')}`);
-            this._proc = spawn('node', mcpArgs, {
+            debugLog(`Spawning ${launchSpec.command} ${launchSpec.args.join(' ')}`);
+            this._proc = spawn(launchSpec.command, launchSpec.args, {
                 stdio: ['pipe', 'pipe', 'pipe'],
                 env: { ...process.env },
             });

package/dist/browser.test.js

@@ -1,5 +1,10 @@
-import { describe, it, expect } from 'vitest';
+import { afterEach, describe, it, expect, vi } from 'vitest';
 import { PlaywrightMCP, __test__ } from './browser/index.js';
+afterEach(() => {
+    __test__.resetMcpServerPathCache();
+    __test__.setMcpDiscoveryTestHooks();
+    delete process.env.OPENCLI_MCP_SERVER_PATH;
+});
 describe('browser helpers', () => {
     it('creates JSON-RPC requests with unique ids', () => {
         const first = __test__.createJsonRpcRequest('tools/call', { name: 'browser_tabs' });
@@ -91,9 +96,138 @@ describe('browser helpers', () => {
             }
         }
     });
+    it('builds a direct node launch spec when a local MCP path is available', () => {
+        const savedCI = process.env.CI;
+        delete process.env.CI;
+        try {
+            expect(__test__.buildMcpLaunchSpec({
+                mcpPath: '/tmp/cli.js',
+                executablePath: '/usr/bin/google-chrome',
+            })).toEqual({
+                command: 'node',
+                args: ['/tmp/cli.js', '--extension', '--executable-path', '/usr/bin/google-chrome'],
+                usedNpxFallback: false,
+            });
+        }
+        finally {
+            if (savedCI !== undefined) {
+                process.env.CI = savedCI;
+            }
+            else {
+                delete process.env.CI;
+            }
+        }
+    });
+    it('falls back to npx bootstrap when no MCP path is available', () => {
+        const savedCI = process.env.CI;
+        delete process.env.CI;
+        try {
+            expect(__test__.buildMcpLaunchSpec({
+                mcpPath: null,
+            })).toEqual({
+                command: 'npx',
+                args: ['-y', '@playwright/mcp@latest', '--extension'],
+                usedNpxFallback: true,
+            });
+        }
+        finally {
+            if (savedCI !== undefined) {
+                process.env.CI = savedCI;
+            }
+            else {
+                delete process.env.CI;
+            }
+        }
+    });
     it('times out slow promises', async () => {
         await expect(__test__.withTimeoutMs(new Promise(() => { }), 10, 'timeout')).rejects.toThrow('timeout');
     });
+    it('prefers OPENCLI_MCP_SERVER_PATH over discovered locations', () => {
+        process.env.OPENCLI_MCP_SERVER_PATH = '/env/mcp/cli.js';
+        const existsSync = vi.fn((candidate) => candidate === '/env/mcp/cli.js');
+        const execSync = vi.fn();
+        __test__.setMcpDiscoveryTestHooks({ existsSync, execSync: execSync });
+        expect(__test__.findMcpServerPath()).toBe('/env/mcp/cli.js');
+        expect(execSync).not.toHaveBeenCalled();
+        expect(existsSync).toHaveBeenCalledWith('/env/mcp/cli.js');
+    });
+    it('discovers global @playwright/mcp from the current Node runtime prefix', () => {
+        const originalExecPath = process.execPath;
+        const runtimeExecPath = '/opt/homebrew/Cellar/node/25.2.1/bin/node';
+        const runtimeGlobalMcp = '/opt/homebrew/Cellar/node/25.2.1/lib/node_modules/@playwright/mcp/cli.js';
+        Object.defineProperty(process, 'execPath', {
+            value: runtimeExecPath,
+            configurable: true,
+        });
+        const existsSync = vi.fn((candidate) => candidate === runtimeGlobalMcp);
+        const execSync = vi.fn();
+        __test__.setMcpDiscoveryTestHooks({ existsSync, execSync: execSync });
+        try {
+            expect(__test__.findMcpServerPath()).toBe(runtimeGlobalMcp);
+            expect(execSync).not.toHaveBeenCalled();
+            expect(existsSync).toHaveBeenCalledWith(runtimeGlobalMcp);
+        }
+        finally {
+            Object.defineProperty(process, 'execPath', {
+                value: originalExecPath,
+                configurable: true,
+            });
+        }
+    });
+    it('falls back to npm root -g when runtime prefix lookup misses', () => {
+        const originalExecPath = process.execPath;
+        const runtimeExecPath = '/opt/homebrew/Cellar/node/25.2.1/bin/node';
+        const runtimeGlobalMcp = '/opt/homebrew/Cellar/node/25.2.1/lib/node_modules/@playwright/mcp/cli.js';
+        const npmRootGlobal = '/Users/jakevin/.nvm/versions/node/v22.14.0/lib/node_modules';
+        const npmGlobalMcp = '/Users/jakevin/.nvm/versions/node/v22.14.0/lib/node_modules/@playwright/mcp/cli.js';
+        Object.defineProperty(process, 'execPath', {
+            value: runtimeExecPath,
+            configurable: true,
+        });
+        const existsSync = vi.fn((candidate) => candidate === npmGlobalMcp);
+        const execSync = vi.fn((command) => {
+            if (String(command).includes('npm root -g'))
+                return `${npmRootGlobal}\n`;
+            throw new Error(`unexpected command: ${String(command)}`);
+        });
+        __test__.setMcpDiscoveryTestHooks({ existsSync, execSync: execSync });
+        try {
+            expect(__test__.findMcpServerPath()).toBe(npmGlobalMcp);
+            expect(execSync).toHaveBeenCalledOnce();
+            expect(existsSync).toHaveBeenCalledWith(runtimeGlobalMcp);
+            expect(existsSync).toHaveBeenCalledWith(npmGlobalMcp);
+        }
+        finally {
+            Object.defineProperty(process, 'execPath', {
+                value: originalExecPath,
+                configurable: true,
+            });
+        }
+    });
+    it('returns null when new global discovery paths are unavailable', () => {
+        const originalExecPath = process.execPath;
+        const runtimeExecPath = '/opt/homebrew/Cellar/node/25.2.1/bin/node';
+        Object.defineProperty(process, 'execPath', {
+            value: runtimeExecPath,
+            configurable: true,
+        });
+        const existsSync = vi.fn(() => false);
+        const execSync = vi.fn((command) => {
+            if (String(command).includes('npm root -g'))
+                return '/missing/global/node_modules\n';
+            throw new Error(`missing command: ${String(command)}`);
+        });
+        __test__.setMcpDiscoveryTestHooks({ existsSync, execSync: execSync });
+        try {
+            expect(__test__.findMcpServerPath()).toBeNull();
+        }
+        finally {
+            Object.defineProperty(process, 'execPath', {
+                value: originalExecPath,
+                configurable: true,
+            });
+        }
+    });
 });
 describe('PlaywrightMCP state', () => {
     it('transitions to closed after close()', async () => {

package/dist/cli-manifest.json

@@ -1,4 +1,167 @@
 [
+  {
+    "site": "barchart",
+    "name": "flow",
+    "description": "Barchart unusual options activity / options flow",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "type",
+        "type": "str",
+        "default": "all",
+        "required": false,
+        "help": "Filter: all, call, or put"
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "help": "Number of results"
+      }
+    ],
+    "type": "ts",
+    "modulePath": "barchart/flow.js",
+    "domain": "www.barchart.com",
+    "columns": [
+      "symbol",
+      "type",
+      "strike",
+      "expiration",
+      "last",
+      "volume",
+      "openInterest",
+      "volOiRatio",
+      "iv"
+    ]
+  },
+  {
+    "site": "barchart",
+    "name": "greeks",
+    "description": "Barchart options greeks overview (IV, delta, gamma, theta, vega)",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "symbol",
+        "type": "str",
+        "required": true,
+        "help": "Stock ticker (e.g. AAPL)"
+      },
+      {
+        "name": "expiration",
+        "type": "str",
+        "required": false,
+        "help": "Expiration date (YYYY-MM-DD). Defaults to the nearest available expiration."
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 10,
+        "required": false,
+        "help": "Number of near-the-money strikes per type"
+      }
+    ],
+    "type": "ts",
+    "modulePath": "barchart/greeks.js",
+    "domain": "www.barchart.com",
+    "columns": [
+      "type",
+      "strike",
+      "last",
+      "iv",
+      "delta",
+      "gamma",
+      "theta",
+      "vega",
+      "rho",
+      "volume",
+      "openInterest",
+      "expiration"
+    ]
+  },
+  {
+    "site": "barchart",
+    "name": "options",
+    "description": "Barchart options chain with greeks, IV, volume, and open interest",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "symbol",
+        "type": "str",
+        "required": true,
+        "help": "Stock ticker (e.g. AAPL)"
+      },
+      {
+        "name": "type",
+        "type": "str",
+        "default": "Call",
+        "required": false,
+        "help": "Option type: Call or Put"
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "help": "Max number of strikes to return"
+      }
+    ],
+    "type": "ts",
+    "modulePath": "barchart/options.js",
+    "domain": "www.barchart.com",
+    "columns": [
+      "strike",
+      "bid",
+      "ask",
+      "last",
+      "change",
+      "volume",
+      "openInterest",
+      "iv",
+      "delta",
+      "gamma",
+      "theta",
+      "vega",
+      "expiration"
+    ]
+  },
+  {
+    "site": "barchart",
+    "name": "quote",
+    "description": "Barchart stock quote with price, volume, and key metrics",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "symbol",
+        "type": "str",
+        "required": true,
+        "help": "Stock ticker (e.g. AAPL, MSFT, TSLA)"
+      }
+    ],
+    "type": "ts",
+    "modulePath": "barchart/quote.js",
+    "domain": "www.barchart.com",
+    "columns": [
+      "symbol",
+      "name",
+      "price",
+      "change",
+      "changePct",
+      "open",
+      "high",
+      "low",
+      "prevClose",
+      "volume",
+      "avgVolume",
+      "marketCap",
+      "peRatio",
+      "eps"
+    ]
+  },
   {
     "site": "bbc",
     "name": "news",

package/dist/clis/barchart/flow.d.ts

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