核心亮点
为什么选择 OpenCLI？
专为 AI Agent 工作流设计，支持浏览器、桌面应用和本地 CLI 的统一命令行接口
CLI All Electron
将任何 Electron 应用（如 Antigravity Ultra）变成 CLI 工具。AI 可以原生控制自己，无限玩法。
账户安全
复用 Chrome 登录态，凭证永不离开浏览器。无需 API Token，无密码泄露风险，零风控。
AI Agent 原生
explore 自动发现 API，synthesize 生成适配器，cascade 探测认证策略。内置 AI-first 工作流。
外部 CLI 枢纽
统一发现、自动安装、透传执行 gh、docker、kubectl、obsidian 等本地 CLI，零配置。
自修复配置
opencli setup 验证 Browser Bridge 连通性，opencli doctor 诊断 daemon、扩展和浏览器状态。
双引擎架构
支持 YAML 声明式数据管线和 TypeScript 浏览器运行时注入，最大化灵活性。
平台支持
40+ 平台，覆盖主流网站与应用
运行 opencli list 查看完整注册表
Twitter/X
浏览器
Bilibili
浏览器
知乎
浏览器
小红书
浏览器
Reddit
浏览器
YouTube
浏览器
Boss直聘
浏览器
Weread
浏览器
Cursor
桌面端
Notion
桌面端
ChatGPT
桌面端
Antigravity
桌面端
Discord
桌面端
HackerNews
公共API
ArXiv
公共API
Bloomberg
公共API
LinkedIn
浏览器
即刻
浏览器
V2EX
公共API
StackOverflow
公共API
快速开始
安装指南
只需几步，即可开始使用 OpenCLI
npm 全局安装（推荐）
bash
# 安装 OpenCLI
npm install -g @jackwener/opencli
快速上手
bash
opencli list # 查看所有命令
opencli list -f yaml # 以 YAML 列出所有命令
opencli hackernews top --limit 5 # 公共 API，无需浏览器
opencli bilibili hot --limit 5 # 浏览器命令
opencli zhihu hot -f json # JSON 输出
opencli zhihu hot -f yaml # YAML 输出
更新版本
bash
npm install -g @jackwener/opencli@latest
从源码安装（面向开发者）
bash
# 克隆仓库
git clone [email protected]:jackwener/opencli.git
cd opencli
# 安装依赖并构建
npm install
npm run build
# 链接到全局
npm link
# 开始使用
opencli list
Browser Bridge 扩展配置
OpenCLI 通过轻量化的 Browser Bridge Chrome 扩展与浏览器通信。运行任何浏览器命令时，微型 daemon 会自动启动。
方法一：下载预构建安装包（推荐）
1. 前往 GitHub Releases 页面下载 opencli-extension.zip 或 opencli-extension.crx
2. 打开 chrome://extensions，启用右上角的开发者模式
3. 将 .crx 文件或解压后的文件夹拖入扩展页面即可
方法二：加载源码（针对开发者）
1. 打开 chrome://extensions，启用开发者模式
2. 点击 加载已解压的扩展程序
3. 选择仓库中的 extension/ 目录
诊断工具
opencli doctor # 检查扩展和 daemon 连通性
opencli doctor --live # 额外测试浏览器命令
技术架构
双引擎架构设计
灵活应对不同复杂度的自动化场景
01
YAML 声明式管线
通过 YAML 文件定义数据处理流水线，适合简单的 fetch → parse → format 场景。无需编写代码，快速上手。
02
TypeScript 运行时注入
通过浏览器运行时脚本注入实现复杂交互，适合需要模拟用户操作、处理动态内容的场景。
03
Browser Bridge
Chrome 扩展 + 微 daemon 架构，通过 WebSocket 实现安全的浏览器通信，零配置自动启动。
04
动态加载器
只需将 .ts 或 .yaml 适配器放入 clis/ 文件夹，即可自动注册生效，无需修改核心代码。
使用示例
丰富的命令行交互
支持多种输出格式：table、json、yaml、md、csv
$
常用命令示例
opencli bilibili hot --limit 5获取 B站热门视频排行榜
opencli xiaohongshu search AI绘画 --limit 10搜索小红书相关内容
opencli zhihu hot -f json获取知乎热榜（JSON 格式）
opencli twitter trending查看 Twitter 热门话题
opencli weread shelf查看微信读书书架
opencli notion search "AI"搜索 Notion 笔记
opencli cursor screenshot获取 Cursor IDE 截图（桌面端）
opencli gh pr list --limit 5通过外部 CLI 枢纽调用 gh 查看 PR
桌面应用
Electron 桌面应用适配器
将常用桌面应用 CLI 化，AI 可以原生控制
Cursor
控制 Cursor IDE — Composer、对话、代码提取等
Codex
在后台驱动 OpenAI Codex CLI Agent
Antigravity
在终端控制 Antigravity Ultra，支持 watch/serve
ChatGPT
自动化操作 ChatGPT macOS 桌面客户端
ChatWise
多 LLM 客户端（GPT-4、Claude、Gemini）
Notion
搜索、读取、写入 Notion 页面
Discord
Discord 桌面版 — 消息、频道、服务器管理
AI 开发者指南
AI Agent 工作流
内置探索-合成-生成完整链路，AI 自动发现并创建适配器
1
Explore
opencli explore url
深度探索网站，拦截 API，发现能力
2
Synthesize
opencli synthesize
从探索结果生成 YAML 适配器
3
Generate
opencli generate url
一键完成探索→合成→注册
4
Cascade
opencli cascade url
自动降级探测认证策略
bash — 快速模式（单命令生成）
# 一键生成：只需 URL + 目标描述，4 步自动完成
opencli generate https://example.com --goal "hot"
# 深度探索模式：拦截网络请求，分析 API 能力
opencli explore https://example.com --site mysite
# 合成：从探索结果生成适配器
opencli synthesize mysite
# 自动探测认证策略：PUBLIC → COOKIE → HEADER
opencli cascade https://api.example.com/data
下载支持
多平台内容下载
支持从主流平台下载图片、视频和文章
bash — 下载示例
# 下载小红书笔记（图片/视频）
opencli xiaohongshu download --note-id abc123 --output ./xhs
# 下载 B站视频（需要 yt-dlp）
opencli bilibili download --bvid BV1xxx --output ./bilibili
opencli bilibili download --bvid BV1xxx --quality 1080p
# 下载 Twitter 媒体
opencli twitter download elonmusk --limit 20 --output ./twitter
# 导出知乎文章为 Markdown
opencli zhihu download "https://zhuanlan.zhihu.com/p/xxx" --output ./zhihu
opencli zhihu download "https://zhuanlan.zhihu.com/p/xxx" --download-images
外部 CLI 枢纽
统一管理本地命令行工具
零配置发现、自动安装、透传执行
gh — GitHub CLI
opencli gh pr list --limit 5obsidian — 笔记管理
opencli obsidian search query="AI"docker — 容器工具
opencli docker pskubectl — K8s 工具
opencli kubectl get pods
自动安装：如果目标 CLI 未安装，OpenCLI 会自动尝试通过系统包管理器安装，然后重试命令。
注册自定义 CLI：opencli register mycli — 将本地 CLI 添加到注册表，AI 即可自动发现。