夜雨聆风把网站、浏览器会话、Electron 应用和本地工具，统一变成适合人类与 AI Agent 使用的确定性接口。
如果你经常需要：
在不同网站之间抓数据、做自动化操作 让 AI Agent 帮你操控浏览器完成任务 把高频操作封装成可复用的命令
那么 OpenCLI 可能正是你需要的工具。
今天来详细聊聊这个项目。
01 OpenCLI 能做什么？
简单来说，OpenCLI 是一个命令行枢纽，可以用同一套 CLI 做三类事情：
1️⃣ 直接使用现成适配器
100+ 热门网站开箱即用，包括：
B 站、知乎、小红书 Twitter/X、Reddit、HackerNews 抖音、豆包、即刻 Notion、Cursor、ChatGPT 等桌面应用
# 查看 HackerNews 热门opencli hackernews top --limit 5# 查看 B 站热门opencli bilibili hot --limit 5# 查看小红书搜索结果opencli xiaohongshu search "关键词"2️⃣ 让 AI Agent 操作任意网站
在 AI Agent（Claude Code、Cursor 等）中安装 skill，Agent 就能用你的已登录浏览器：
导航到任意 URL 点击按钮、填写表单 提取页面内容 截取屏幕截图
你只需要用自然语言描述想做的事，Agent 会自动处理所有浏览器操作。
3️⃣ 把新网站写成 CLI
如果需要的网站还没覆盖，OpenCLI 提供了完整流程：
侦察站点类型（SPA / SSR / API） 发现目标 endpoint 编写适配器 验证命令可用性
02 核心亮点
🔐 账号安全
复用 Chrome/Chromium 登录态，凭证永远不会离开浏览器。
不需要额外配置账号密码，直接用你已有的登录状态。
🤖 面向 AI Agent 设计
一个 skill 带你走完：
站点侦察 API 发现 字段解码 适配器编写 验证
零 LLM 成本——运行时不消耗模型 token，跑 10,000 次也不花一分钱。
📊 确定性输出
相同命令，相同输出结构，每次一致。
可管道、可脚本、CI 友好。
🎯 CLI 枢纽
统一发现、自动安装、纯透传任何外部 CLI：
gh（GitHub CLI） docker lark-cli（飞书 CLI） wecom-cli（企业微信 CLI） tg-cli（Telegram CLI） discord-cli wx-cli（微信本地数据 CLI）
03 快速开始
第一步：安装
# 检查 Node.js 版本（需要 >= 21）node --version# 安装 OpenCLInpm install -g @jackwener/opencli第二步：安装浏览器扩展
OpenCLI 通过 Browser Bridge 扩展与 Chrome 通信。
方式 A — Chrome Web Store（推荐）直接在 Chrome Web Store 安装 OpenCLI 扩展。
方式 B — 手动安装
到 GitHub Releases 下载最新版 zip 打开 chrome://extensions，启用开发者模式点击加载已解压的扩展程序，选择解压目录
第三步：验证
opencli doctor第四步：运行第一个命令
# 查看所有可用命令opencli list# 试试 HackerNewsopencli hackernews top --limit 5# 试试 B 站opencli bilibili hot --limit 504 给 AI Agent 用的 Skill
OpenCLI 的浏览器命令是给 AI Agent 用的，不需要你手动执行。
安装 skill 到你的 Agent：
# 完整安装npx skills add jackwener/opencli# 或者只安装需要的 skillnpx skills add jackwener/opencli --skill opencli-adapter-author如何选择 Skill？
工作原理
安装 skill 后，你的 AI Agent 可以：
使用你的已登录浏览器导航到任意 URL 通过结构化 DOM 快照读取页面内容（不是截图） 点击按钮、填写表单、选择选项、按键 提取页面数据或拦截网络 API 响应 等待元素、文本或页面跳转
你只需用自然语言描述想做的事，Agent 会自动调用底层命令。
05 内置适配器列表
OpenCLI 已支持 100+ 站点，涵盖：
社交平台
视频/内容平台
桌面应用
更多平台
B 站、知乎、小红书、即刻、微博、即刻、脉脉、牛客网、36kr、Medium、Substack、微信、Discord、Telegram...
06 下载功能
OpenCLI 支持从各平台下载内容：
使用示例
# 下载小红书图片/视频opencli xiaohongshu download"https://xhslink.com/..."--output ./xhs# 下载 B 站视频opencli bilibili download BV1xxx --output ./bilibili# 导出知乎文章为 Markdownopencli zhihu download"https://zhuanlan.zhihu.com/p/xxx"--output ./zhihu# 导出微信公众号文章opencli weixin download --url"https://mp.weixin.qq.com/s/xxx"--output ./weixin
07 输出格式
所有内置命令都支持多种输出格式：
opencli bilibili hot -f table# 默认：富文本表格opencli bilibili hot -f json# JSON（适合传给 jq）opencli bilibili hot -f yaml# YAML（更适合人类阅读）opencli bilibili hot -f md# Markdownopencli bilibili hot -f csv# CSV
08 常见问题排查
"Extension not connected" 报错
确保已从 Chrome Web Store 安装 OpenCLI 扩展，且在 chrome://extensions 中已启用。
返回空数据或 "Unauthorized"
Chrome 里的登录态可能已过期。请打开目标网站，重新手工登录或刷新页面。
Node API 错误 / 旧 Node 启动即崩
OpenCLI 要求 Node.js >= 21。先执行 node --version，如果版本过低先升级。
Daemon 问题
# 检查 daemon 状态curl localhost:19825/status# 查看扩展日志curl localhost:19825/logs
09 更新
# 更新 OpenCLInpm install -g @jackwener/opencli@latest# 同时更新 skillsnpx skills add jackwener/opencli
总结
OpenCLI 适合以下场景：
✅ 需要自动化操作多个网站 ✅ 想让 AI Agent 帮你完成浏览器任务 ✅ 想把高频操作封装成可复用命令 ✅ 需要统一管理本地 CLI 工具
GitHub 地址：
https://github.com/jackwener/opencli
如果有任何问题，欢迎在评论区留言交流。
更多阅读：
