browser-harness-js
通过CDP协议直接控制Chrome浏览器的JavaScript工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：browser-harness-js。 它的用途是：通过CDP协议直接控制Chrome浏览器的JavaScript工具 完整的 Skill 内容见：https://321skill.com/skills/browser-harness-js/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“打开GitHub，搜索‘browser-use’这个仓库。” AI会调用技能执行 `browser-harness-js 'await session.Page.navigate({url:"https://github.com"})'` 和 `browser-harness-js 'await session.Input.insertText({text:"browser-use"})'` 等命令，自动完成导航、搜索操作。
介绍
browser-harness-js 是一个专为AI Agent设计的浏览器自动化技能，它解决了在AI对话中难以直接、持久地控制Chrome浏览器的问题。传统方式需要用户手动编写复杂的Puppeteer或Playwright脚本，而这个技能通过一个持久的Bun HTTP服务器，将Chrome DevTools Protocol (CDP) 的所有方法封装成可直接调用的JavaScript接口，让AI能以单行命令的形式执行导航、截图、提取数据等操作。
使用方式非常直接：通过 browser-harness-js 命令行工具，传入JavaScript代码片段即可。首次调用会自动启动后台服务器并建立与Chrome的WebSocket长连接，后续所有调用都复用同一个会话和全局状态，支持多标签页操作，并可附加到现有或新启动的Chrome实例。
它适合需要自动化浏览器任务的开发者、测试工程师和数据分析师，尤其是在AI辅助编程（如Claude、Cursor）的场景下，AI可以即时调用此技能来完成网页交互，无需用户离开对话上下文去手动编写和运行独立脚本。
与Puppeteer或Playwright这类完整的浏览器自动化框架相比，browser-harness-js 的核心区别在于其“无状态调用”和“AI原生”设计。它不要求用户预先编写并维护一个完整的Node.js项目，而是通过一个轻量的CLI和持久化服务器，将浏览器控制能力暴露为可被AI随时调用的“技能”，更适合集成到AI工作流中，实现交互式的、步骤式的浏览器操作。
核心特点
核心区别在于其“持久化会话”和“AI原生CLI”设计。它通过一个长期运行的Bun服务器保持CDP连接，允许跨多次AI调用复用浏览器状态（如登录态、全局变量），而同类工具通常每次调用都是独立会话。其CLI输出经过优化，直接返回原始数据（如字符串、JSON），而非封装对象，更便于AI解析和后续处理。
注意事项
不适合需要复杂逻辑编排、高频并发或非Chrome浏览器（如Firefox、Safari）自动化的场景。
常见问题
如何安装browser-harness-js？
通过 `npx skills add` 添加技能后，需手动将技能目录下的CLI工具链接到系统PATH中。
它和Puppeteer有什么区别？
Puppeteer是完整的Node.js库，需编写脚本运行；而browser-harness-js通过CLI和持久服务器提供即时的CDP调用，更适合AI集成和交互式操作。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/browser-harness-js/raw/index.md 读取 browser-harness-js 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/browser-harness-js/raw/index.md（查看排版版本）