jackwener/OpenCLI · 上手攻略

  • 仓库：jackwener/OpenCLI
  • 链接：https://github.com/jackwener/OpenCLI
  • 分类：agent · tool
  • 作者：Jay
  • 更新：2026-07-07

这是什么

OpenCLI 是一个把任意网站变成 CLI 命令的工具，同时支持在你的已登录浏览器上跑 Browser Use，让 AI Agent（Claude Code、Cursor 等）直接操作你浏览器里的网页。

三层核心能力： 1. 现成适配器：B站、知乎、小红书、Twitter/X、Reddit、HackerNews 等 100+ 站点，开箱即用的 CLI 命令 2. AI Agent Browser Use：安装 skill 后，Agent 能用你的已登录 Chrome 导航、点击、填表、抓取任意网页 3. 自定义适配器：用 opencli browser + opencli-adapter-author skill 从头写新站点的适配器

此外 OpenCLI 还是一个 CLI 枢纽：可以把 gh、docker、tg、discord 等本地工具注册到同一入口管理。

解决什么问题

  • 网站 CLI 化：不同网站要分别装不同的 CLI 工具，OpenCLI 统一入口
  • AI Agent 无法操作需要登录的网页：Agent 没有浏览器，用 API 又要处理 auth，OpenCLI 让 Agent 用你的登录态 Chrome 操作任意网页
  • Browser Use 难以获取登录态：传统 Browser Use 工具无法复用你已有的登录 Session，OpenCLI 通过 Browser Bridge 扩展直接使用你的 Chrome profile

快速安装

方式 A — OpenCLIApp（macOS / Windows 推荐）

  1. 下载安装包：https://opencli.info/download
  2. 安装后打开一次，在 System 页面安装/修复 opencli 命令
  3. 安装 Browser Bridge 扩展（见下方）

方式 B — npm 全局安装（纯 CLI / CI / 服务器）

要求：Node.js >= 20

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

安装 Browser Bridge 扩展（二选一）

方式 A — Chrome Web Store（推荐）： 在 Chrome Web Store 安装 OpenCLI 扩展。

方式 B — 手动安装： 1. 到 GitHub Releases 下载最新的 opencli-extension-v{version}.zip 2. 解压后打开 chrome://extensions，启用开发者模式 3. 点击加载已解压的扩展程序，选择解压目录

验证安装

opencli doctor

多 Profile 管理（如使用多个 Chrome profile）

opencli profile list
opencli profile rename <contextId> work
opencli profile use work
opencli --profile work browser main state

核心用法

人类用户：直接用现成适配器

# 查看所有可用命令
opencli list

# 跑第一个命令
opencli hackernews top --limit 5
opencli bilibili hot --limit 5
opencli zhihu hot --limit 5

AI Agent 用户：安装 skill

# 安装全部 skill
npx skills add jackwener/opencli

# 或只安装需要的 skill
npx skills add jackwener/opencli --skill opencli-browser
npx skills add jackwener/opencli --skill opencli-adapter-author
npx skills add jackwener/opencli --skill opencli-autofix

安装 opencli-browser skill 后，对 Agent 说自然语言即可：

  • "帮我看看小红书的通知"
  • "帮我填一下这个表单"
  • "用浏览器命令抓取这个页面"
  • "opencli zhihu hot 返回空了，修一下"

opencli browser 可用命令

命令 作用
open 导航到任意 URL
click 点击元素
type / fill 填写表单
select 选择下拉选项
keys 按键
wait 等待元素/文本/页面跳转
get 读取页面内容
find 查找元素
extract 提取数据或拦截网络 API 响应
screenshot 截图
scroll 滚动
back 返回上一页
eval 执行 JS
network 网络请求拦截
tab list/new/select/close 标签页管理
init / verify 初始化和验证
close 关闭浏览器

扩展 OpenCLI

需求 推荐方式
把个人网站命令放在自己的 Git repo opencli plugin create + opencli plugin install file://...
快速写一个本地私人 adapter opencli browser init <site>/<command>，放在 ~/.opencli/clis/
本地修改官方 adapter opencli adapter eject <site> + opencli adapter reset <site>
发布或安装第三方命令 opencli plugin install github:user/repo
包装已有本地 binary opencli external register <name>

内置命令站点（部分）

B站、小红书、知乎、Twitter/X、Reddit、HackerNews 等 100+ 站点，完整列表见 opencli list 输出。

OpenCLIApp 桌面端

OpenCLIApp 是配套的桌面应用（macOS / Windows），提供： - 系统托盘 UI - 环境诊断 - 更新管理 - 浏览器登录态保活 - 网页转 Markdown

推荐桌面用户优先使用 OpenCLIApp，它会自动维护 opencli 命令的安装状态。

典型适用场景

  • 内容创作者：用 CLI 命令抓取 B站、知乎、小红书数据
  • AI Agent 开发：让 Agent 操作需要登录的网页（社交媒体、数据后台）
  • 自动化工作流：把网页操作封装成确定性 CLI 命令
  • Browser Use 场景：复用登录态，无需每次重新认证
  • Electron 应用控制：通过适配器控制 Cursor、Trae CN、Codex 等桌面应用

坑与注意

  1. Node.js >= 20 是 npm 安装方式的硬性要求，低版本不兼容。
  2. Browser Bridge 扩展是必须的——没有它 opencli browser 命令无法连接 Chrome。
  3. Chrome 扩展需要你的登录态权限——仅限你自己信任的浏览器 profile，不要在共享机器上使用。
  4. browser 命令是给 AI Agent 用的，不是手动执行——如果你是人类用户，主要用 opencli <site> <command> 的现成适配器。
  5. 多 Chrome profile 时，没有默认 profile 会提示选择，可以用 opencli profile use <name> 设置默认。
  6. opencli doctor 是排查问题的第一步，遇到连接问题先跑这个。
  7. Skill 安装后 Agent 才知道如何使用 opencli browser 命令——没有 skill，Agent 不会自动调用。

与同类对比

工具 登录态复用 内置站点 AI Agent 友好 CLI 枢纽
OpenCLI ✅ Browser Bridge ✅ 100+ ✅ skill 安装 ✅
Playwright ❌ 需另处理 ❌ ⚠️ 需写代码 ❌
Puppeteer ❌ 需另处理 ❌ ⚠️ 需写代码 ❌
browser-use ❌ ❌ ⚠️ ❌
单一网站 CLI N/A 单一 ❌ ❌

核心差异：OpenCLI 是唯一同时做到"统一 CLI 入口 + 登录态复用 + AI Agent skill 化"的工具。

一句话推荐结论

如果你想让 AI Agent 操作需要登录的网页，或者想把多个网站的爬取/操作统一成一个 CLI 工具，OpenCLI 是目前最完整的方案——开箱即用的 100+ 适配器 + 零配置的 Browser Use + 自然的 Agent skill 集成。

相关资源

  • 官网下载：https://opencli.info/download
  • npm 包：https://www.npmjs.com/package/@jackwener/opencli
  • Chrome Web Store 扩展：https://chromewebstore.google.com/detail/opencli/ildkmabpimmkaediidaifkhjpohdnifk