chrome-cdp-cli 1.0.2 → 1.2.0

package/dist/handlers/InstallCursorCommandHandler.js

@@ -0,0 +1,280 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallCursorCommandHandler = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const logger_1 = require("../utils/logger");
+class InstallCursorCommandHandler {
+    constructor() {
+        this.name = 'install_cursor_command';
+    }
+    async execute(_client, args) {
+        try {
+            const targetDir = args.targetDirectory || '.cursor/commands';
+            if (!args.targetDirectory && targetDir === '.cursor/commands' && !args.force) {
+                const cursorDirExists = await this.checkDirectoryExists('.cursor');
+                if (!cursorDirExists) {
+                    return {
+                        success: false,
+                        error: `Warning: No .cursor directory found in current directory. This may not be a Cursor project root directory.
+
+To install Cursor commands:
+1. Navigate to your Cursor project root directory (where .cursor folder should be)
+2. Run the command again, or
+3. Use --target-directory to specify a custom location, or
+4. Use --force to install anyway
+
+Examples:
+  chrome-cdp-cli install-cursor-command --target-directory /path/to/.cursor/commands
+  chrome-cdp-cli install-cursor-command --force`
+                    };
+                }
+            }
+            await this.ensureDirectory(targetDir);
+            const commands = this.generateCursorCommands();
+            const createdFiles = [];
+            for (const command of commands) {
+                const filePath = path.join(targetDir, `${command.name}.md`);
+                const content = this.generateCommandMarkdown(command);
+                await fs.writeFile(filePath, content, 'utf8');
+                createdFiles.push(filePath);
+                logger_1.logger.info(`Created Cursor command: ${filePath}`);
+            }
+            return {
+                success: true,
+                data: {
+                    installed: commands.length,
+                    directory: targetDir,
+                    commands: commands.map(c => c.name),
+                    files: createdFiles
+                }
+            };
+        }
+        catch (error) {
+            logger_1.logger.error('Failed to install Cursor commands:', error);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error occurred'
+            };
+        }
+    }
+    async checkDirectoryExists(dirPath) {
+        try {
+            await fs.access(dirPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async ensureDirectory(dirPath) {
+        try {
+            await fs.access(dirPath);
+        }
+        catch {
+            await fs.mkdir(dirPath, { recursive: true });
+            logger_1.logger.info(`Created directory: ${dirPath}`);
+        }
+    }
+    generateCursorCommands() {
+        return [
+            {
+                name: 'cdp-cli',
+                description: 'Chrome DevTools Protocol CLI 工具',
+                instructions: `通过 Chrome DevTools Protocol 控制 Chrome 浏览器，支持多种自动化操作。
+
+## 功能列表
+
+### 1. JavaScript 执行 (eval)
+执行 JavaScript 代码并返回结果，支持异步代码和 Promise。
+
+**用途：**
+- 获取页面信息（标题、URL、元素等）
+- 修改页面内容和样式
+- 执行复杂的 JavaScript 逻辑
+- 与页面元素交互
+
+**示例：**
+- \`chrome-cdp-cli eval "document.title"\`
+- \`chrome-cdp-cli eval "window.location.href"\`
+- \`chrome-cdp-cli eval "document.querySelector('#button').click()"\`
+- \`chrome-cdp-cli eval "fetch('/api/data').then(r => r.json())"\`
+
+### 2. 页面截图 (screenshot)
+捕获当前页面的截图并保存到指定文件。
+
+**功能：**
+- 指定文件名和路径
+- 全页面截图或视口截图
+- 自定义图片质量和格式
+- 输出 PNG 格式文件
+
+**示例：**
+- \`chrome-cdp-cli screenshot --filename screenshot.png\`
+- \`chrome-cdp-cli screenshot --filename fullpage.png --full-page\`
+- \`chrome-cdp-cli screenshot --filename reports/page-capture.png\`
+
+### 3. DOM 快照 (snapshot)
+捕获包含 DOM 结构、样式和布局信息的完整快照。
+
+**包含内容：**
+- 完整的 DOM 树结构
+- 计算后的 CSS 样式
+- 元素布局信息
+- 元素属性和文本内容
+
+**示例：**
+- \`chrome-cdp-cli snapshot --filename dom-snapshot.json\`
+- \`chrome-cdp-cli snapshot --filename page-structure.json\`
+
+### 4. 控制台监控 (console)
+获取浏览器控制台的消息，包括日志、警告和错误。
+
+**功能：**
+- 获取最新的控制台消息
+- 列出所有控制台消息
+- 按类型过滤消息（log、warn、error）
+- 调试和监控页面运行状态
+
+**示例：**
+- \`chrome-cdp-cli get_console_message\`
+- \`chrome-cdp-cli list_console_messages --type error\`
+
+### 5. 网络请求监控 (network)
+监控和获取页面的网络请求信息。
+
+**功能：**
+- 获取最新的网络请求
+- 列出所有网络请求
+- 按方法过滤请求（GET、POST 等）
+- 查看请求和响应详情
+- 分析页面的网络行为和 API 调用
+
+**示例：**
+- \`chrome-cdp-cli get_network_request\`
+- \`chrome-cdp-cli list_network_requests --method POST\`
+
+命令会自动连接到运行在 localhost:9222 的 Chrome 实例。`,
+                examples: [
+                    'chrome-cdp-cli eval "document.title"',
+                    'chrome-cdp-cli screenshot --filename page.png',
+                    'chrome-cdp-cli snapshot --filename dom.json',
+                    'chrome-cdp-cli get_console_message',
+                    'chrome-cdp-cli list_network_requests'
+                ]
+            }
+        ];
+    }
+    generateCommandMarkdown(command) {
+        const examples = command.examples.map(example => `- ${example}`).join('\n');
+        return `# ${command.description}
+
+${command.instructions}
+
+## 使用示例
+
+${examples}
+
+## 前置条件
+
+确保 Chrome 浏览器已启动并开启了远程调试：
+
+\`\`\`bash
+chrome --remote-debugging-port=9222
+\`\`\`
+
+或者在 macOS 上：
+
+\`\`\`bash
+/Applications/Google\\ Chrome.app/Contents/MacOS/Google\\ Chrome --remote-debugging-port=9222
+\`\`\`
+
+## 全局选项
+
+所有命令都支持以下全局选项：
+
+- \`--host <hostname>\`: Chrome DevTools 主机地址 (默认: localhost)
+- \`--port <number>\`: Chrome DevTools 端口 (默认: 9222)
+- \`--format <json|text>\`: 输出格式 (默认: json)
+- \`--verbose\`: 启用详细日志
+- \`--quiet\`: 静默模式
+- \`--timeout <ms>\`: 命令超时时间
+
+## 常用工作流程
+
+### 网页自动化测试
+\`\`\`bash
+# 1. 导航到页面并截图
+chrome-cdp-cli eval "window.location.href = 'https://example.com'"
+chrome-cdp-cli screenshot --filename before.png
+
+# 2. 填写表单
+chrome-cdp-cli eval "document.querySelector('#email').value = 'test@example.com'"
+chrome-cdp-cli eval "document.querySelector('#password').value = 'password123'"
+
+# 3. 提交并检查结果
+chrome-cdp-cli eval "document.querySelector('#submit').click()"
+chrome-cdp-cli screenshot --filename after.png
+chrome-cdp-cli list_console_messages --type error
+\`\`\`
+
+### API 调用监控
+\`\`\`bash
+# 1. 开始监控网络请求
+chrome-cdp-cli eval "fetch('/api/users').then(r => r.json())"
+
+# 2. 查看网络请求
+chrome-cdp-cli list_network_requests --method POST
+
+# 3. 获取最新请求详情
+chrome-cdp-cli get_network_request
+\`\`\`
+
+### 页面分析
+\`\`\`bash
+# 1. 获取页面基本信息
+chrome-cdp-cli eval "({title: document.title, url: location.href, links: document.querySelectorAll('a').length})"
+
+# 2. 捕获完整页面结构
+chrome-cdp-cli snapshot --filename page-analysis.json
+
+# 3. 检查控制台错误
+chrome-cdp-cli list_console_messages --type error
+\`\`\`
+`;
+    }
+}
+exports.InstallCursorCommandHandler = InstallCursorCommandHandler;

package/dist/handlers/ListConsoleMessagesHandler.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListConsoleMessagesHandler = void 0;
+const ConsoleMonitor_1 = require("../monitors/ConsoleMonitor");
+class ListConsoleMessagesHandler {
+    constructor() {
+        this.name = 'list_console_messages';
+        this.consoleMonitor = null;
+    }
+    async execute(client, args) {
+        try {
+            const params = args;
+            if (!this.consoleMonitor) {
+                this.consoleMonitor = new ConsoleMonitor_1.ConsoleMonitor(client);
+            }
+            if (params.startMonitoring || !this.consoleMonitor.isActive()) {
+                await this.consoleMonitor.startMonitoring();
+            }
+            const filter = {};
+            if (params.types && params.types.length > 0) {
+                filter.types = params.types;
+            }
+            if (params.textPattern) {
+                filter.textPattern = params.textPattern;
+            }
+            if (params.maxMessages && params.maxMessages > 0) {
+                filter.maxMessages = params.maxMessages;
+            }
+            if (params.startTime) {
+                filter.startTime = params.startTime;
+            }
+            if (params.endTime) {
+                filter.endTime = params.endTime;
+            }
+            const messages = this.consoleMonitor.getMessages(filter);
+            return {
+                success: true,
+                data: {
+                    messages: messages.map(msg => ({
+                        type: msg.type,
+                        text: msg.text,
+                        args: msg.args,
+                        timestamp: msg.timestamp,
+                        stackTrace: msg.stackTrace
+                    })),
+                    totalCount: messages.length,
+                    isMonitoring: this.consoleMonitor.isActive()
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error occurred'
+            };
+        }
+    }
+    validateArgs(args) {
+        if (!args || typeof args !== 'object') {
+            return true;
+        }
+        const params = args;
+        if (params.types !== undefined) {
+            if (!Array.isArray(params.types)) {
+                return false;
+            }
+            const validTypes = ['log', 'info', 'warn', 'error', 'debug'];
+            for (const type of params.types) {
+                if (typeof type !== 'string' || !validTypes.includes(type)) {
+                    return false;
+                }
+            }
+        }
+        if (params.textPattern !== undefined && typeof params.textPattern !== 'string') {
+            return false;
+        }
+        if (params.maxMessages !== undefined) {
+            if (typeof params.maxMessages !== 'number' || params.maxMessages <= 0) {
+                return false;
+            }
+        }
+        if (params.startTime !== undefined && typeof params.startTime !== 'number') {
+            return false;
+        }
+        if (params.endTime !== undefined && typeof params.endTime !== 'number') {
+            return false;
+        }
+        if (params.startMonitoring !== undefined && typeof params.startMonitoring !== 'boolean') {
+            return false;
+        }
+        return true;
+    }
+    getHelp() {
+        return `list_console_messages - List all captured console messages
+    
+Usage:
+  list_console_messages [options]
+  
+Options:
+  --types <types>         Filter by message types (comma-separated: log,info,warn,error,debug)
+  --textPattern <pattern> Filter by text pattern (regex)
+  --maxMessages <count>   Maximum number of messages to return
+  --startTime <timestamp> Filter messages after this timestamp
+  --endTime <timestamp>   Filter messages before this timestamp
+  --startMonitoring       Start monitoring if not already active
+  
+Examples:
+  list_console_messages
+  list_console_messages --types error,warn
+  list_console_messages --textPattern "API" --maxMessages 10
+  list_console_messages --startTime 1640995200000`;
+    }
+}
+exports.ListConsoleMessagesHandler = ListConsoleMessagesHandler;

package/dist/handlers/ListNetworkRequestsHandler.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListNetworkRequestsHandler = void 0;
+const NetworkMonitor_1 = require("../monitors/NetworkMonitor");
+class ListNetworkRequestsHandler {
+    constructor() {
+        this.name = 'list_network_requests';
+        this.networkMonitor = null;
+    }
+    async execute(client, args) {
+        try {
+            const params = args;
+            if (!this.networkMonitor) {
+                this.networkMonitor = new NetworkMonitor_1.NetworkMonitor(client);
+            }
+            if (!this.networkMonitor.isActive()) {
+                await this.networkMonitor.startMonitoring();
+            }
+            const filter = params.filter ? {
+                methods: params.filter.methods,
+                urlPattern: params.filter.urlPattern,
+                statusCodes: params.filter.statusCodes,
+                maxRequests: params.filter.maxRequests,
+                startTime: params.filter.startTime,
+                endTime: params.filter.endTime,
+            } : undefined;
+            const requests = this.networkMonitor.getRequests(filter);
+            return {
+                success: true,
+                data: {
+                    requests,
+                    count: requests.length,
+                    isMonitoring: this.networkMonitor.isActive()
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error occurred'
+            };
+        }
+    }
+    getNetworkMonitor() {
+        return this.networkMonitor;
+    }
+    setNetworkMonitor(monitor) {
+        this.networkMonitor = monitor;
+    }
+}
+exports.ListNetworkRequestsHandler = ListNetworkRequestsHandler;

package/dist/handlers/index.js

@@ -17,3 +17,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./EvaluateScriptHandler"), exports);
 __exportStar(require("./TakeScreenshotHandler"), exports);
 __exportStar(require("./TakeSnapshotHandler"), exports);
+__exportStar(require("./GetConsoleMessageHandler"), exports);
+__exportStar(require("./ListConsoleMessagesHandler"), exports);
+__exportStar(require("./GetNetworkRequestHandler"), exports);
+__exportStar(require("./ListNetworkRequestsHandler"), exports);
+__exportStar(require("./InstallCursorCommandHandler"), exports);
+__exportStar(require("./InstallClaudeSkillHandler"), exports);

package/dist/monitors/ConsoleMonitor.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleMonitor = void 0;
+class ConsoleMonitor {
+    constructor(client) {
+        this.messages = [];
+        this.isMonitoring = false;
+        this.messageHandler = null;
+        this.client = client;
+    }
+    async startMonitoring() {
+        if (this.isMonitoring) {
+            return;
+        }
+        await this.client.send('Runtime.enable');
+        this.messageHandler = (params) => {
+            this.handleConsoleMessage(params);
+        };
+        this.client.on('Runtime.consoleAPICalled', this.messageHandler);
+        this.isMonitoring = true;
+    }
+    async stopMonitoring() {
+        if (!this.isMonitoring || !this.messageHandler) {
+            return;
+        }
+        this.client.off('Runtime.consoleAPICalled', this.messageHandler);
+        this.messageHandler = null;
+        this.isMonitoring = false;
+    }
+    getMessages(filter) {
+        let filteredMessages = [...this.messages];
+        if (filter) {
+            if (filter.types && filter.types.length > 0) {
+                filteredMessages = filteredMessages.filter(msg => filter.types.includes(msg.type));
+            }
+            if (filter.textPattern) {
+                const pattern = new RegExp(filter.textPattern, 'i');
+                filteredMessages = filteredMessages.filter(msg => pattern.test(msg.text));
+            }
+            if (filter.startTime) {
+                filteredMessages = filteredMessages.filter(msg => msg.timestamp >= filter.startTime);
+            }
+            if (filter.endTime) {
+                filteredMessages = filteredMessages.filter(msg => msg.timestamp <= filter.endTime);
+            }
+            if (filter.maxMessages && filter.maxMessages > 0) {
+                filteredMessages = filteredMessages.slice(-filter.maxMessages);
+            }
+        }
+        return filteredMessages;
+    }
+    getLatestMessage(filter) {
+        const messages = this.getMessages(filter);
+        return messages.length > 0 ? messages[messages.length - 1] : null;
+    }
+    clearMessages() {
+        this.messages = [];
+    }
+    getMessageCount(filter) {
+        return this.getMessages(filter).length;
+    }
+    isActive() {
+        return this.isMonitoring;
+    }
+    handleConsoleMessage(params) {
+        try {
+            const consoleParams = params;
+            const message = {
+                type: this.mapConsoleType(consoleParams.type),
+                text: this.formatConsoleArgs(consoleParams.args),
+                args: consoleParams.args.map(arg => arg.value || arg.description || ''),
+                timestamp: consoleParams.timestamp,
+                stackTrace: consoleParams.stackTrace ?
+                    this.convertStackTrace(consoleParams.stackTrace.callFrames) : undefined
+            };
+            this.messages.push(message);
+            if (this.messages.length > 1000) {
+                this.messages = this.messages.slice(-1000);
+            }
+        }
+        catch (error) {
+            console.error('Error handling console message:', error);
+        }
+    }
+    mapConsoleType(cdpType) {
+        switch (cdpType) {
+            case 'log':
+                return 'log';
+            case 'info':
+                return 'info';
+            case 'warning':
+                return 'warn';
+            case 'error':
+                return 'error';
+            case 'debug':
+                return 'debug';
+            default:
+                return 'log';
+        }
+    }
+    formatConsoleArgs(args) {
+        return args.map(arg => {
+            if (arg.value !== undefined) {
+                if (typeof arg.value === 'string') {
+                    return arg.value;
+                }
+                return JSON.stringify(arg.value);
+            }
+            return arg.description || '';
+        }).join(' ');
+    }
+    convertStackTrace(callFrames) {
+        return callFrames.map(frame => ({
+            functionName: frame.functionName || '<anonymous>',
+            url: frame.url,
+            lineNumber: frame.lineNumber,
+            columnNumber: frame.columnNumber
+        }));
+    }
+}
+exports.ConsoleMonitor = ConsoleMonitor;