OpenCLI

将任何网站转换为 CLI，并在已登录的 Chrome 浏览器中运行 Browser Use。 将网站、浏览器会话、Electron 应用和本地工具转化为人类与 AI Agent 可用的确定性接口。或者针对任何页面运行 Browser Use —— 进行导航、填写表单、点击、提取数据和自动化操作。

OpenCLI 为三种不同的自动化需求提供了一个统一的平台：

使用内置适配器：支持 Bilibili、知乎、小红书、Reddit、HackerNews、Twitter/X 等更多网站。
让 AI Agent 操作任何网站：在你的 AI Agent（Claude Code, Cursor 等）中安装 opencli-browser 技能，它可以通过 opencli browser 原语，利用你已登录的浏览器完成导航、点击、输入/填表、提取和检查页面等操作。
编写新的适配器：通过 opencli browser + opencli-adapter-author 技能进行端到端的开发。该技能会引导你完成从初步调研到字段解码、编写代码，再到 opencli browser verify 的全过程。

它还可以作为本地工具的 CLI 中心，例如 gh、docker、longbridge、tg、discord、wx、ntn (Notion) 以及你自己注册的其他二进制程序。此外，它还支持 Cursor、Trae CN、Codex、Antigravity、ChatGPT 和 Trae SOLO 等 Electron 应用的桌面端适配器。

快速开始

1. 安装 OpenCLI

OpenCLI 要求 Node.js >= 20。

node --version
npm install -g @jackwener/opencli

2. 安装浏览器桥接插件 (Browser Bridge Extension)

OpenCLI 通过一个轻量级的浏览器桥接插件和一个小型本地守护进程连接到 Chrome/Chromium。守护进程会在需要时自动启动。

选项 A — Chrome 应用商店（推荐）： 从 Chrome Web Store 安装 OpenCLI。

选项 B — 手动安装：

从 GitHub Releases 页面下载最新的 opencli-extension-v{version}.zip。
解压文件，打开 chrome://extensions，并开启 开发者模式 (Developer mode)。
点击 加载已解压的扩展程序 (Load unpacked) 并选择解压后的文件夹。

3. 验证安装

opencli doctor

4. 可选：命名你的 Chrome 配置文件

每个 Chrome 配置文件都会运行自己的 OpenCLI 扩展实例。如果你使用多个 Chrome 配置文件，可以列出已连接的配置文件并分配本地别名：

opencli profile list
opencli profile rename <ID> work
opencli profile use work
opencli --profile work browser state

如果只连接了一个配置文件，OpenCLI 会自动使用它。如果连接了多个配置文件且未设置默认值，OpenCLI 会要求你进行选择，而不是进行猜测。

5. 运行你的第一个命令

opencli list
opencli hackernews top --limit 5
opencli bilibili hot --limit 5

面向用户

当你需要一个可靠的命令而不是实时的浏览器会话时，直接使用 OpenCLI：

opencli list：显示所有已注册的命令。
opencli <name>：运行内置或生成的适配器。
opencli external register mycli：通过统一的发现接口暴露本地 CLI。
opencli doctor：帮助诊断浏览器连接问题。

扩展 OpenCLI

如果你想添加自己的命令，请从扩展 OpenCLI 指南开始。本文档仅作简要说明；指南涵盖了目录结构、源代码控制模型和安装命令。

需求	推荐路径
在自己的 Git 仓库中维护个人网站命令	`opencli plugin create` + `opencli plugin install file://...`
快速草拟一个私有本地适配器	在 `~/.opencli/clis/` 中使用 `opencli browser init /`
在本地修改官方适配器	`opencli adapter eject <name>` + `opencli adapter reset <name>`
发布或安装第三方命令	`opencli plugin install github:user/repo`
封装现有的本地二进制文件	`opencli external register <path>`

面向 AI Agent

OpenCLI 的浏览器命令旨在供 AI Agent 使用，而非手动运行。在你的 AI Agent（Claude Code, Cursor 等）中安装技能，Agent 就可以使用你已登录的 Chrome 会话代表你操作网站。

安装技能（也会刷新现有的安装）

npx skills add jackwener/opencli

或者仅安装你需要的部分：

npx skills add jackwener/opencli --skill opencli-adapter-author
npx skills add jackwener/opencli --skill opencli-autofix
npx skills add jackwener/opencli --skill opencli-browser
npx skills add jackwener/opencli --skill opencli-browser-sitemap
npx skills add jackwener/opencli --skill opencli-sitemap-author

jackwener/OpenCLI