@jackwener/opencli 0.4.6 → 0.5.1

package/README.md

@@ -41,9 +41,9 @@ A CLI tool that turns **any website** into a command-line interface. **57 comman
 
 > **⚠️ 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 needs a way to communicate with your browser. We highly recommend configuring **both** of the following methods for maximum reliability.
+OpenCLI connects to your browser through the Playwright MCP Bridge extension.
 
-### Connection Method A: Playwright MCP Bridge Extension (Primary)
+### Playwright MCP Bridge Extension Setup
 
 1. Install **[Playwright MCP Bridge](https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm)** extension in Chrome.
 2. Obtain your token by clicking the extension icon in the browser toolbar or from the extension settings page.
@@ -72,15 +72,11 @@ And, so that `opencli` commands can use it directly in the terminal, export it i
 export PLAYWRIGHT_MCP_EXTENSION_TOKEN="<your-token-here>"
 ```
 
-### Connection Method B: Chrome 144+ Auto-Discovery (Fallback)
+After configuring, run `opencli doctor` to verify your token is correctly set up across all locations:
 
-No extensions needed. Just enable Chrome's built-in remote debugging:
-
-1. Open `chrome://inspect#remote-debugging` in Chrome
-2. Check **"Allow remote debugging for this browser instance"**
-3. Set `OPENCLI_USE_CDP=1` before running opencli
-
-*You can also manually specify an endpoint via `OPENCLI_CDP_ENDPOINT` env var.*
+```bash
+opencli doctor
+```
 
 ## Quick Start
 
@@ -184,8 +180,6 @@ Explore outputs to `.opencli/explore/<site>/` (manifest.json, endpoints.json, ca
 - **"Failed to connect to Playwright MCP Bridge"**
   - Ensure the Playwright MCP extension is installed and **enabled** in your running Chrome.
   - Restart the Chrome browser if you just installed the extension.
-- **"CDP command failed" or "boss search blocked"**
-  - Some sites (like BOSS Zhipin) actively block Chrome DevTools Protocol connections. OpenCLI falls back to cookie extraction, but ensure you didn't force `--chrome-mode` unnecessarily. 
 - **Empty data returns or 'Unauthorized' error**
   - Your login session in Chrome might have expired. Open a normal Chrome tab, navigate to the target site, and log in or refresh the page to prove you are human.
 - **Node API errors**

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 通过 Chrome 浏览器 + [Playwright MCP Bridge](https://github.com/nichochar/playwright-mcp) 扩展，将任何网站变成命令行工具。57个内置命令。不存密码、不泄 token，直接复用浏览器已登录状态。
+OpenCLI 将任何网站变成命令行工具。**57 个命令**覆盖 **17 个站点** — B站、知乎、小红书、Twitter、Reddit、雪球、GitHub、V2EX、Hacker News、BBC、微博、BOSS直聘、Yahoo Finance、路透社、什么值得买、携程、YouTube — 复用浏览器登录态，AI 驱动探索。
 
 ---
 
@@ -41,9 +41,9 @@ OpenCLI 通过 Chrome 浏览器 + [Playwright MCP Bridge](https://github.com/nic
 
 > **⚠️ 重要**：大多数命令复用你的 Chrome 登录状态。运行命令前，你必须已在 Chrome 中打开目标网站并完成登录。如果获取到空数据或报错，请先检查你的浏览器登录状态。
 
-为了让 OpenCLI 能够联通你的浏览器，你需要配置连接方式。**强烈建议以下两种方式都配置上**，互为后备：
+OpenCLI 通过 Playwright MCP Bridge 扩展与你的浏览器通信。
 
-### 连接方式 A：Playwright MCP Bridge 扩展（首选）
+### Playwright MCP Bridge 扩展配置
 
 1. 安装 **[Playwright MCP Bridge](https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm)** 扩展
 2. 在浏览器插件栏点击该插件，或者在插件设置页获取你的 Extension Token。
@@ -72,15 +72,11 @@ OpenCLI 通过 Chrome 浏览器 + [Playwright MCP Bridge](https://github.com/nic
 export PLAYWRIGHT_MCP_EXTENSION_TOKEN="<你的-token>"
 ```
 
-### 连接方式 B：Chrome 144+ CDP 自动发现（备选）
+配置完成后，运行 `opencli doctor` 检测你的 Token 是否在所有位置都正确配置：
 
-无需安装任何扩展。只需开启 Chrome 内置的远程调试：
-
-1. 在 Chrome 中打开 `chrome://inspect#remote-debugging`
-2. 勾选 **"允许对此浏览器实例进行远程调试" (Allow remote debugging for this browser instance)**
-3. 运行时设置环境变量 `OPENCLI_USE_CDP=1`
-
-*也可通过 `OPENCLI_CDP_ENDPOINT` 环境变量手动指定 CDP endpoint 地址。*
+```bash
+opencli doctor
+```
 
 ## 快速开始
 
@@ -184,8 +180,6 @@ opencli cascade https://api.example.com/data
 - **"Failed to connect to Playwright MCP Bridge"** 报错
   - 确保你当前的 Chrome 已安装且**开启了** Playwright MCP Bridge 浏览器插件。
   - 如果是刚装完插件，需要重启 Chrome 浏览器。
-- **"CDP command failed" / "被风控拦截"**
-  - 有些网站（例如 BOSS 直聘）会因为开了 DevTools 或者 CDP 端口拦截验证。OpenCLI 有 cookie 降级机制，通常不需要干预，不用去强行加上 CDP 标识参数即可。
 - **返回空数据，或者报错 "Unauthorized"**
   - Chrome 里的登录态可能已经过期（甚至被要求过滑动验证码）。请打开当前 Chrome 页面，在新标签页重新手工登录或刷新该页面。
 - **Node API 错误 (如 parseArgs, fs 等)**

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.4.0
+version: 0.5.0
 author: jackwener
 tags: [cli, browser, web, mcp, playwright, bilibili, zhihu, twitter, github, v2ex, hackernews, reddit, xiaohongshu, xueqiu, AI, agent]
 ---
@@ -34,8 +34,7 @@ npm update -g @jackwener/opencli
 
 Browser commands require:
 1. Chrome browser running **(logged into target sites)**
-2. [Playwright MCP Bridge](https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm) extension (default connection mode)
-3. **Alternative**: Chrome 144+ CDP auto-discovery — set `OPENCLI_USE_CDP=1` (no extension needed)
+2. [Playwright MCP Bridge](https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm) extension installed and configured
 
 > **Note**: You must be logged into the target website in Chrome before running commands. Tabs opened during command execution are auto-closed afterwards.
 
@@ -339,9 +338,6 @@ ${{ index + 1 }}
 | `OPENCLI_BROWSER_CONNECT_TIMEOUT` | 30 | Browser connection timeout (sec) |
 | `OPENCLI_BROWSER_COMMAND_TIMEOUT` | 45 | Command execution timeout (sec) |
 | `OPENCLI_BROWSER_EXPLORE_TIMEOUT` | 120 | Explore timeout (sec) |
-| `OPENCLI_CDP_ENDPOINT` | — | Manual CDP WebSocket endpoint (overrides auto-discovery) |
-| `OPENCLI_USE_CDP` | — | Set to `1` to use Chrome 144+ CDP auto-discovery instead of extension |
-| `OPENCLI_FORCE_EXTENSION` | — | Set to `1` to skip CDP and force extension mode |
 | `PLAYWRIGHT_MCP_EXTENSION_TOKEN` | — | Auto-approve extension connection |
 
 ## Troubleshooting
@@ -349,6 +345,6 @@ ${{ index + 1 }}
 | Issue | Solution |
 |-------|----------|
 | `npx not found` | Install Node.js: `brew install node` |
-| `Timed out connecting to browser` | 1) Chrome must be open 2) Enable remote debugging at `chrome://inspect#remote-debugging` or install MCP Bridge extension |
+| `Timed out connecting to browser` | 1) Chrome must be open 2) Install MCP Bridge extension and configure token |
 | `Target page context` error | Add `navigate:` step before `evaluate:` in YAML |
 | Empty table data | Check if evaluate returns JSON string (MCP parsing) or data path is wrong |

package/dist/browser.d.ts

@@ -1,21 +1,11 @@
 /**
- * Browser interaction via Chrome DevTools Protocol.
- * Connects to an existing Chrome browser through CDP auto-discovery or extension bridge.
+ * Browser interaction via Playwright MCP Bridge extension.
+ * Connects to an existing Chrome browser through the extension.
  */
-/**
- * Verify the CDP HTTP JSON API is functional.
- * Chrome's chrome://inspect#remote-debugging mode writes DevToolsActivePort
- * but doesn't expose the full CDP HTTP API (/json/version), which means
- * Playwright's connectOverCDP won't work properly (init succeeds but
- * all tool calls hang silently).
- */
-export declare function isCdpApiAvailable(port: number, host?: string, timeoutMs?: number): Promise<boolean>;
-export declare function discoverChromeEndpoint(): Promise<string | null>;
-type ConnectFailureKind = 'missing-token' | 'extension-timeout' | 'extension-not-installed' | 'cdp-timeout' | 'mcp-init' | 'process-exit' | 'unknown';
+type ConnectFailureKind = 'missing-token' | 'extension-timeout' | 'extension-not-installed' | 'mcp-init' | 'process-exit' | 'unknown';
 type PlaywrightMCPState = 'idle' | 'connecting' | 'connected' | 'closing' | 'closed';
 type ConnectFailureInput = {
     kind: ConnectFailureKind;
-    mode: 'extension' | 'cdp';
     timeout: number;
     hasExtensionToken: boolean;
     tokenFingerprint?: string | null;
@@ -81,7 +71,6 @@ export declare class PlaywrightMCP {
     private _initialTabIdentities;
     private _closingPromise;
     private _state;
-    private _mode;
     private _page;
     get state(): PlaywrightMCPState;
     private _sendRequest;
@@ -89,7 +78,6 @@ export declare class PlaywrightMCP {
     private _resetAfterFailedConnect;
     connect(opts?: {
         timeout?: number;
-        forceExtension?: boolean;
     }): Promise<Page>;
     close(): Promise<void>;
 }
@@ -109,6 +97,5 @@ export declare const __test__: {
     diffTabIndexes: typeof diffTabIndexes;
     appendLimited: typeof appendLimited;
     withTimeout: typeof withTimeout;
-    isCdpApiAvailable: typeof isCdpApiAvailable;
 };
 export {};

package/dist/browser.js

@@ -1,109 +1,14 @@
 /**
- * Browser interaction via Chrome DevTools Protocol.
- * Connects to an existing Chrome browser through CDP auto-discovery or extension bridge.
+ * Browser interaction via Playwright MCP Bridge extension.
+ * Connects to an existing Chrome browser through the extension.
  */
 import { spawn, execSync } from 'node:child_process';
 import { createHash } from 'node:crypto';
-import * as http from 'node:http';
-import * as net from 'node:net';
 import { fileURLToPath } from 'node:url';
 import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
 import { formatSnapshot } from './snapshotFormatter.js';
-/**
- * Chrome 144+ auto-discovery: read DevToolsActivePort file to get CDP endpoint.
- *
- * Starting with Chrome 144, users can enable remote debugging from
- * chrome://inspect#remote-debugging without any command-line flags.
- * Chrome writes the active port and browser GUID to a DevToolsActivePort file
- * in the user data directory, which we read to construct the WebSocket endpoint.
- *
- * Priority: OPENCLI_CDP_ENDPOINT env > DevToolsActivePort auto-discovery > --extension fallback
- */
-/** Quick TCP port probe to verify Chrome is actually listening */
-function isPortReachable(port, host = '127.0.0.1', timeoutMs = 800) {
-    return new Promise(resolve => {
-        const sock = net.createConnection({ port, host });
-        sock.setTimeout(timeoutMs);
-        sock.on('connect', () => { sock.destroy(); resolve(true); });
-        sock.on('error', () => resolve(false));
-        sock.on('timeout', () => { sock.destroy(); resolve(false); });
-    });
-}
-/**
- * Verify the CDP HTTP JSON API is functional.
- * Chrome's chrome://inspect#remote-debugging mode writes DevToolsActivePort
- * but doesn't expose the full CDP HTTP API (/json/version), which means
- * Playwright's connectOverCDP won't work properly (init succeeds but
- * all tool calls hang silently).
- */
-export function isCdpApiAvailable(port, host = '127.0.0.1', timeoutMs = 2000) {
-    return new Promise(resolve => {
-        const req = http.get(`http://${host}:${port}/json/version`, { timeout: timeoutMs }, (res) => {
-            let body = '';
-            res.on('data', (chunk) => { body += chunk.toString(); });
-            res.on('end', () => {
-                try {
-                    const data = JSON.parse(body);
-                    // A valid CDP endpoint returns { Browser, ... } with a webSocketDebuggerUrl
-                    resolve(!!data && typeof data === 'object' && !!data.Browser);
-                }
-                catch {
-                    resolve(false);
-                }
-            });
-        });
-        req.on('error', () => resolve(false));
-        req.on('timeout', () => { req.destroy(); resolve(false); });
-    });
-}
-export async function discoverChromeEndpoint() {
-    const candidates = [];
-    // User-specified Chrome data dir takes highest priority
-    if (process.env.CHROME_USER_DATA_DIR) {
-        candidates.push(path.join(process.env.CHROME_USER_DATA_DIR, 'DevToolsActivePort'));
-    }
-    // Standard Chrome/Edge user data dirs per platform
-    if (process.platform === 'win32') {
-        const localAppData = process.env.LOCALAPPDATA ?? path.join(os.homedir(), 'AppData', 'Local');
-        candidates.push(path.join(localAppData, 'Google', 'Chrome', 'User Data', 'DevToolsActivePort'));
-        candidates.push(path.join(localAppData, 'Microsoft', 'Edge', 'User Data', 'DevToolsActivePort'));
-    }
-    else if (process.platform === 'darwin') {
-        candidates.push(path.join(os.homedir(), 'Library', 'Application Support', 'Google', 'Chrome', 'DevToolsActivePort'));
-        candidates.push(path.join(os.homedir(), 'Library', 'Application Support', 'Microsoft Edge', 'DevToolsActivePort'));
-    }
-    else {
-        candidates.push(path.join(os.homedir(), '.config', 'google-chrome', 'DevToolsActivePort'));
-        candidates.push(path.join(os.homedir(), '.config', 'chromium', 'DevToolsActivePort'));
-        candidates.push(path.join(os.homedir(), '.config', 'microsoft-edge', 'DevToolsActivePort'));
-    }
-    for (const filePath of candidates) {
-        try {
-            const content = fs.readFileSync(filePath, 'utf-8').trim();
-            const lines = content.split('\n');
-            if (lines.length >= 2) {
-                const port = parseInt(lines[0], 10);
-                const browserPath = lines[1]; // e.g. /devtools/browser/<GUID>
-                if (port > 0 && browserPath.startsWith('/devtools/browser/')) {
-                    const endpoint = `ws://127.0.0.1:${port}${browserPath}`;
-                    // Verify the port is actually reachable (Chrome may have closed, leaving a stale file)
-                    if (await isPortReachable(port)) {
-                        // Verify CDP HTTP API is functional — chrome://inspect#remote-debugging
-                        // writes DevToolsActivePort but doesn't expose the full CDP API,
-                        // causing Playwright connectOverCDP to hang on all tool calls.
-                        if (await isCdpApiAvailable(port)) {
-                            return endpoint;
-                        }
-                    }
-                }
-            }
-        }
-        catch { }
-    }
-    return null;
-}
 // Read version from package.json (single source of truth)
 const __browser_dirname = path.dirname(fileURLToPath(import.meta.url));
 const PKG_VERSION = (() => { try {
@@ -115,7 +20,6 @@ catch {
 const CONNECT_TIMEOUT = parseInt(process.env.OPENCLI_BROWSER_CONNECT_TIMEOUT ?? '30', 10);
 const STDERR_BUFFER_LIMIT = 16 * 1024;
 const INITIAL_TABS_TIMEOUT_MS = 1500;
-const CDP_READINESS_PROBE_TIMEOUT_MS = 5000;
 const TAB_CLEANUP_TIMEOUT_MS = 2000;
 let _cachedMcpServerPath;
 export function getTokenFingerprint(token) {
@@ -127,31 +31,24 @@ export function formatBrowserConnectError(input) {
     const stderr = input.stderr?.trim();
     const suffix = stderr ? `\n\nMCP stderr:\n${stderr}` : '';
     const tokenHint = input.tokenFingerprint ? ` Token fingerprint: ${input.tokenFingerprint}.` : '';
-    if (input.mode === 'extension') {
-        if (input.kind === 'missing-token') {
-            return new Error('Failed to connect to Playwright MCP Bridge: PLAYWRIGHT_MCP_EXTENSION_TOKEN is not set.\n\n' +
-                'Without this token, Chrome will show a manual approval dialog for every new MCP connection. ' +
-                'Copy the token from the Playwright MCP Bridge extension and set it in BOTH your shell environment and MCP client config.' +
-                suffix);
-        }
-        if (input.kind === 'extension-not-installed') {
-            return new Error('Failed to connect to Playwright MCP Bridge: the browser extension did not attach.\n\n' +
-                'Make sure Chrome is running and the "Playwright MCP Bridge" extension is installed and enabled. ' +
-                'If Chrome shows an approval dialog, click Allow.' +
-                suffix);
-        }
-        if (input.kind === 'extension-timeout') {
-            const likelyCause = input.hasExtensionToken
-                ? `The most likely cause is that PLAYWRIGHT_MCP_EXTENSION_TOKEN does not match the token currently shown by the browser extension.${tokenHint} Re-copy the token from the extension and update BOTH your shell environment and MCP client config.`
-                : 'PLAYWRIGHT_MCP_EXTENSION_TOKEN is not configured, so the extension may be waiting for manual approval.';
-            return new Error(`Timed out connecting to Playwright MCP Bridge (${input.timeout}s).\n\n` +
-                `${likelyCause} If a browser prompt is visible, click Allow. You can also switch to Chrome remote debugging mode with OPENCLI_USE_CDP=1 as a fallback.` +
-                suffix);
-        }
+    if (input.kind === 'missing-token') {
+        return new Error('Failed to connect to Playwright MCP Bridge: PLAYWRIGHT_MCP_EXTENSION_TOKEN is not set.\n\n' +
+            'Without this token, Chrome will show a manual approval dialog for every new MCP connection. ' +
+            'Copy the token from the Playwright MCP Bridge extension and set it in BOTH your shell environment and MCP client config.' +
+            suffix);
+    }
+    if (input.kind === 'extension-not-installed') {
+        return new Error('Failed to connect to Playwright MCP Bridge: the browser extension did not attach.\n\n' +
+            'Make sure Chrome is running and the "Playwright MCP Bridge" extension is installed and enabled. ' +
+            'If Chrome shows an approval dialog, click Allow.' +
+            suffix);
     }
-    if (input.mode === 'cdp' && input.kind === 'cdp-timeout') {
-        return new Error(`Timed out connecting to browser via CDP (${input.timeout}s).\n\n` +
-            'Make sure Chrome is running and remote debugging is enabled at chrome://inspect#remote-debugging, or set OPENCLI_CDP_ENDPOINT explicitly.' +
+    if (input.kind === 'extension-timeout') {
+        const likelyCause = input.hasExtensionToken
+            ? `The most likely cause is that PLAYWRIGHT_MCP_EXTENSION_TOKEN does not match the token currently shown by the browser extension.${tokenHint} Re-copy the token from the extension and update BOTH your shell environment and MCP client config.`
+            : 'PLAYWRIGHT_MCP_EXTENSION_TOKEN is not configured, so the extension may be waiting for manual approval.';
+        return new Error(`Timed out connecting to Playwright MCP Bridge (${input.timeout}s).\n\n` +
+            `${likelyCause} If a browser prompt is visible, click Allow.` +
             suffix);
     }
     if (input.kind === 'mcp-init') {
@@ -165,7 +62,7 @@ export function formatBrowserConnectError(input) {
 }
 function inferConnectFailureKind(args) {
     const haystack = `${args.rawMessage ?? ''}\n${args.stderr}`.toLowerCase();
-    if (args.mode === 'extension' && !args.hasExtensionToken)
+    if (!args.hasExtensionToken)
         return 'missing-token';
     if (haystack.includes('extension connection timeout') || haystack.includes('playwright mcp bridge'))
         return 'extension-not-installed';
@@ -173,11 +70,7 @@ function inferConnectFailureKind(args) {
         return 'mcp-init';
     if (args.exited)
         return 'process-exit';
-    if (args.mode === 'extension')
-        return 'extension-timeout';
-    if (args.mode === 'cdp')
-        return 'cdp-timeout';
-    return 'unknown';
+    return 'extension-timeout';
 }
 // JSON-RPC helpers
 let _nextId = 1;
@@ -413,7 +306,6 @@ export class PlaywrightMCP {
     _initialTabIdentities = [];
     _closingPromise = null;
     _state = 'idle';
-    _mode = null;
     _page = null;
     get state() {
         return this._state;
@@ -445,7 +337,6 @@ export class PlaywrightMCP {
         this._page = null;
         this._proc = null;
         this._buffer = '';
-        this._mode = null;
         this._initialTabIdentities = [];
         this._rejectPendingRequests(new Error('Playwright MCP connect failed'));
         PlaywrightMCP._activeInsts.delete(this);
@@ -472,26 +363,9 @@ export class PlaywrightMCP {
         PlaywrightMCP._activeInsts.add(this);
         this._state = 'connecting';
         const timeout = opts.timeout ?? CONNECT_TIMEOUT;
-        // Connection priority:
-        // 1. OPENCLI_CDP_ENDPOINT env var → explicit CDP endpoint
-        // 2. OPENCLI_USE_CDP=1 → auto-discover via DevToolsActivePort
-        // 3. Default → --extension mode (Playwright MCP Bridge)
-        // Some anti-bot sites (e.g. BOSS Zhipin) detect CDP — use forceExtension to bypass.
-        const forceExt = opts.forceExtension || process.env.OPENCLI_FORCE_EXTENSION === '1';
-        let cdpEndpoint = null;
-        if (!forceExt) {
-            if (process.env.OPENCLI_CDP_ENDPOINT) {
-                cdpEndpoint = process.env.OPENCLI_CDP_ENDPOINT;
-            }
-            else if (process.env.OPENCLI_USE_CDP === '1') {
-                cdpEndpoint = await discoverChromeEndpoint();
-            }
-        }
         return new Promise((resolve, reject) => {
             const isDebug = process.env.DEBUG?.includes('opencli:mcp');
             const debugLog = (msg) => isDebug && console.error(`[opencli:mcp] ${msg}`);
-            const mode = cdpEndpoint ? 'cdp' : 'extension';
-            this._mode = mode;
             const extensionToken = process.env.PLAYWRIGHT_MCP_EXTENSION_TOKEN;
             const tokenFingerprint = getTokenFingerprint(extensionToken);
             let stderrBuffer = '';
@@ -505,7 +379,6 @@ export class PlaywrightMCP {
                 this._resetAfterFailedConnect();
                 reject(formatBrowserConnectError({
                     kind,
-                    mode,
                     timeout,
                     hasExtensionToken: !!extensionToken,
                     tokenFingerprint,
@@ -525,23 +398,13 @@ export class PlaywrightMCP {
             const timer = setTimeout(() => {
                 debugLog('Connection timed out');
                 settleError(inferConnectFailureKind({
-                    mode,
                     hasExtensionToken: !!extensionToken,
                     stderr: stderrBuffer,
                 }));
             }, timeout * 1000);
-            const mcpArgs = [mcpPath];
-            if (cdpEndpoint) {
-                mcpArgs.push('--cdp-endpoint', cdpEndpoint);
-            }
-            else {
-                mcpArgs.push('--extension');
-            }
+            const mcpArgs = [mcpPath, '--extension'];
             if (process.env.OPENCLI_VERBOSE) {
-                console.error(`[opencli] CDP mode: ${cdpEndpoint ? `auto-discovered ${cdpEndpoint}` : 'fallback to --extension'}`);
-                if (mode === 'extension') {
-                    console.error(`[opencli] Extension token: ${extensionToken ? `configured (fingerprint ${tokenFingerprint})` : 'missing'}`);
-                }
+                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);
@@ -595,7 +458,6 @@ export class PlaywrightMCP {
                 this._rejectPendingRequests(new Error(`Playwright MCP process exited before response${code == null ? '' : ` (code ${code})`}`));
                 if (!settled) {
                     settleError(inferConnectFailureKind({
-                        mode,
                         hasExtensionToken: !!extensionToken,
                         stderr: stderrBuffer,
                         exited: true,
@@ -612,7 +474,6 @@ export class PlaywrightMCP {
                 debugLog('Got initialize response');
                 if (resp.error) {
                     settleError(inferConnectFailureKind({
-                        mode,
                         hasExtensionToken: !!extensionToken,
                         stderr: stderrBuffer,
                         rawMessage: `MCP init failed: ${resp.error.message}`,
@@ -622,28 +483,7 @@ export class PlaywrightMCP {
                 const initializedMsg = JSON.stringify({ jsonrpc: '2.0', method: 'notifications/initialized' }) + '\n';
                 debugLog(`SEND: ${initializedMsg.trim()}`);
                 this._proc?.stdin?.write(initializedMsg);
-                if (mode === 'cdp') {
-                    // CDP readiness probe: verify tool calls actually work.
-                    // Some CDP endpoints (e.g. chrome://inspect mode) accept WebSocket
-                    // connections and respond to MCP init but silently drop tool calls.
-                    debugLog('CDP readiness probe (tabs)...');
-                    withTimeout(page.tabs(), CDP_READINESS_PROBE_TIMEOUT_MS, 'CDP readiness probe timed out')
-                        .then(() => {
-                        debugLog('CDP readiness probe succeeded');
-                        settleSuccess(page);
-                    })
-                        .catch((err) => {
-                        debugLog(`CDP readiness probe failed: ${err.message}`);
-                        settleError('cdp-timeout', {
-                            rawMessage: 'CDP endpoint connected but tool calls are unresponsive. ' +
-                                'This usually means Chrome was opened with chrome://inspect#remote-debugging ' +
-                                'which is not fully compatible. Launch Chrome with --remote-debugging-port=9222 instead, ' +
-                                'or use the Playwright MCP Bridge extension (default mode).',
-                        });
-                    });
-                    return;
-                }
-                // Extension mode uses tabs as a readiness probe and for tab cleanup bookkeeping.
+                // 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) => {
                     debugLog(`Tabs response: ${typeof tabs === 'string' ? tabs : JSON.stringify(tabs)}`);
@@ -668,7 +508,7 @@ export class PlaywrightMCP {
         this._closingPromise = (async () => {
             try {
                 // Extension mode opens bridge/session tabs that we can clean up best-effort.
-                if (this._mode === 'extension' && this._page && this._proc && !this._proc.killed) {
+                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 tabEntries = extractTabEntries(tabs);
@@ -707,7 +547,6 @@ export class PlaywrightMCP {
                 this._rejectPendingRequests(new Error('Playwright MCP session closed'));
                 this._page = null;
                 this._proc = null;
-                this._mode = null;
                 this._state = 'closed';
                 PlaywrightMCP._activeInsts.delete(this);
             }
@@ -733,13 +572,23 @@ function extractTabEntries(raw) {
             .map(line => line.trim())
             .filter(Boolean)
             .map(line => {
-            const match = line.match(/Tab\s+(\d+)\s*(.*)$/);
-            if (!match)
-                return null;
-            return {
-                index: parseInt(match[1], 10),
-                identity: match[2].trim() || `tab-${match[1]}`,
-            };
+            // Match actual Playwright MCP format: "- 0: (current) [title](url)"  or  "- 1: [title](url)"
+            const mcpMatch = line.match(/^-\s+(\d+):\s*(.*)$/);
+            if (mcpMatch) {
+                return {
+                    index: parseInt(mcpMatch[1], 10),
+                    identity: mcpMatch[2].trim() || `tab-${mcpMatch[1]}`,
+                };
+            }
+            // Legacy format: "Tab 0 ..."
+            const legacyMatch = line.match(/Tab\s+(\d+)\s*(.*)$/);
+            if (legacyMatch) {
+                return {
+                    index: parseInt(legacyMatch[1], 10),
+                    identity: legacyMatch[2].trim() || `tab-${legacyMatch[1]}`,
+                };
+            }
+            return null;
         })
             .filter((entry) => entry !== null);
     }
@@ -790,7 +639,6 @@ export const __test__ = {
     diffTabIndexes,
     appendLimited,
     withTimeout,
-    isCdpApiAvailable,
 };
 function findMcpServerPath() {
     if (_cachedMcpServerPath !== undefined)

package/dist/browser.test.js

@@ -15,6 +15,13 @@ describe('browser helpers', () => {
             { index: 1, identity: 'Chrome Extension' },
         ]);
     });
+    it('extracts tab entries from MCP markdown format', () => {
+        const entries = __test__.extractTabEntries('- 0: (current) [Playwright MCP extension](chrome-extension://abc/connect.html)\n- 1: [知乎 - 首页](https://www.zhihu.com/)');
+        expect(entries).toEqual([
+            { index: 0, identity: '(current) [Playwright MCP extension](chrome-extension://abc/connect.html)' },
+            { index: 1, identity: '[知乎 - 首页](https://www.zhihu.com/)' },
+        ]);
+    });
     it('closes only tabs that were opened during the session', () => {
         const tabsToClose = __test__.diffTabIndexes(['https://example.com', 'Chrome Extension'], [
             { index: 0, identity: 'https://example.com' },
@@ -53,10 +60,4 @@ describe('PlaywrightMCP state', () => {
         mcp._state = 'closing';
         await expect(mcp.connect()).rejects.toThrow('Playwright MCP is closing');
     });
-    it('tracks backend mode for lifecycle policy', async () => {
-        const mcp = new PlaywrightMCP();
-        expect(mcp._mode).toBeNull();
-        await mcp.close();
-        expect(mcp._mode).toBeNull();
-    });
 });

package/dist/clis/boss/search.js

@@ -67,7 +67,6 @@ cli({
     description: 'BOSS直聘搜索职位',
     domain: 'www.zhipin.com',
     strategy: Strategy.COOKIE,
-    forceExtension: true, // BOSS Zhipin detects CDP mode — must use extension bridge
     browser: true,
     args: [
         { name: 'query', required: true, help: 'Search keyword (e.g. AI agent, 前端)' },

package/dist/clis/v2ex/daily.js

@@ -9,7 +9,6 @@ cli({
     domain: 'www.v2ex.com',
     strategy: Strategy.COOKIE,
     browser: true,
-    forceExtension: true,
     args: [],
     columns: ['status', 'message'],
     func: async (page) => {

package/dist/clis/v2ex/me.js

@@ -9,7 +9,6 @@ cli({
     domain: 'www.v2ex.com',
     strategy: Strategy.COOKIE,
     browser: true,
-    forceExtension: true,
     args: [],
     columns: ['username', 'balance', 'unread_notifications', 'daily_reward_ready'],
     func: async (page) => {

package/dist/clis/v2ex/notifications.js

@@ -9,7 +9,6 @@ cli({
     domain: 'www.v2ex.com',
     strategy: Strategy.COOKIE,
     browser: true,
-    forceExtension: true,
     args: [
         { name: 'limit', type: 'int', default: 20, help: 'Number of notifications' }
     ],

package/dist/doctor.d.ts

@@ -28,11 +28,6 @@ export type DoctorReport = {
     envFingerprint: string | null;
     shellFiles: ShellFileStatus[];
     configs: McpConfigStatus[];
-    remoteDebuggingEnabled: boolean;
-    remoteDebuggingEndpoint: string | null;
-    cdpEnabled: boolean;
-    cdpToken: string | null;
-    cdpFingerprint: string | null;
     recommendedToken: string | null;
     recommendedFingerprint: string | null;
     warnings: string[];