browser

cexll 的头像作者 cexll

此技能应用于使用 Chrome DevTools 协议 (CDP) 的浏览器自动化任务。当用户需要启动 Chrome 进行远程调试、导航页面、在浏览器上下文中执行 JavaScript、捕获屏幕截图或交互式选择 DOM 元素时触发。无需 MCP 服务器。

📖 中文导读:此技能应用于使用 Chrome DevTools 协议 (CDP) 的浏览器自动化任务。当用户需要启动 Chrome 进行远程调试、导航页面、在浏览器上下文中执行 JavaScript、捕获屏幕截图或交互式选择 DOM 元素时触发。无需 MCP 服务器。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: browser description: This skill should be used for browser automation tasks using Chrome DevTools Protocol (CDP). Triggers when users need to launch Chrome with remote debugging, navigate pages, execute JavaScript in browser context, capture screenshots, or interactively select DOM elements. No MCP server required.

Browser Automation

Minimal Chrome DevTools Protocol (CDP) helpers for browser automation without MCP server setup.

Setup

Install dependencies before first use:

npm install --prefix ~/.claude/skills/browser/browser ws

Scripts

All scripts connect to Chrome on localhost:9222.

start.js - Launch Chrome

scripts/start.js              # Fresh profile
scripts/start.js --profile    # Use persistent profile (keeps cookies/auth)
scripts/nav.js https://example.com        # Navigate current tab
scripts/nav.js https://example.com --new  # Open in new tab

eval.js - Execute JavaScript

scripts/eval.js 'document.title'
scripts/eval.js '(() => { const x = 1; return x + 1; })()'

Use single expressions or IIFE for multiple statements.

screenshot.js - Capture Screenshot

scripts/screenshot.js

Returns { path, filename } of saved PNG in temp directory.

pick.js - Visual Element Picker

scripts/pick.js "Click the submit button"

Returns element metadata: tag, id, classes, text, href, selector, rect.

Workflow

  1. Launch Chrome: scripts/start.js --profile for authenticated sessions
  2. Navigate: scripts/nav.js <url>
  3. Inspect: scripts/eval.js 'document.querySelector(...)'
  4. Capture: scripts/screenshot.js or scripts/pick.js
  5. Return gathered data

Key Points

  • All operations run locally - credentials never leave the machine
  • Use --profile flag to preserve cookies and auth tokens
  • Scripts return structured JSON for agent consumption