j
jackwener/opencli
Make Any Website & Tool Your CLI. A universal CLI Hub and AI-native runtime. Transform any website, Electron app, or local binary into a standardized command-line interface. Built for AI Agents to discover, learn, and execute tools seamlessly via a unified AGENT.md integration.
ai-agentai-agentsai-toolscli
TypeScriptApache-2.0创建于 2026/3/14更新于 今天
README
由 Gemini 翻译整理
OpenCLI
将任何网站、Electron 应用或本地工具转化为你的 CLI。 零风险 · 复用 Chrome 登录状态 · AI 驱动的自动发现 · 通用 CLI 中心
这是一个可以将任何网站、Electron 应用或本地 CLI 工具转换为命令行界面的工具。支持 Bilibili、知乎、小红书、Twitter/X、Reddit、YouTube、Antigravity、gh、docker 等更多内容，并基于浏览器会话复用和 AI 原生发现技术。
为 AI Agent 构建 — 在你的 AGENT.md 或 .cursorrules 中配置指令，通过 Bash 运行 opencli list。AI 将自动发现并调用所有可用工具。
CLI Hub — 注册任何本地 CLI（opencli register mycli），这样 AI Agent 就可以在调用内置命令的同时发现并调用它。它支持通过你的包管理器自动安装缺失的工具（例如，如果未安装 gh，opencli gh ... 会先执行 brew install gh，然后无缝重新执行）。
Electron 应用的 CLI — 将任何 Electron 应用程序变成 CLI 工具。从终端重新组合、脚本化并扩展像 Antigravity Ultra 这样的应用。现在 AI Agent 可以原生控制其他 AI 应用。
特性亮点
- CLI All Electron — 像 Antigravity Ultra 一样 CLI 化各种应用！现在 AI 可以原生控制自身。
- 账户安全 — 复用 Chrome 的登录状态；你的凭据永远不会离开浏览器。
- 内置反检测机制 — 自动修补
navigator.webdriver，存根window.chrome，伪造插件列表，清理 ChromeDriver/Playwright 全局变量，并从错误堆栈跟踪中剥离 CDP 帧。在每一层都内置了广泛的反指纹识别和风控规避措施。 - AI Agent 就绪 —
explore发现 API，synthesize生成适配器，cascade寻找认证策略。 - 外部 CLI Hub — 发现、自动安装并将命令透传到任何外部 CLI（gh、obsidian、docker 等）。零配置。
- 自愈式安装 —
opencli doctor可诊断并自动启动守护进程、扩展程序和实时浏览器连接。 - 动态加载器 — 只需将
.ts或.yaml适配器放入clis/文件夹即可自动注册。 - 双引擎架构 — 同时支持 YAML 声明式数据管道和强大的浏览器运行时 TypeScript 注入。
为什么选择 opencli？
市面上有许多出色的浏览器自动化工具，以下是选择 opencli 的场景：
| 你的需求 | 最佳工具 | 原因 |
|---|---|---|
| 从特定网站定时提取数据 | opencli | 预置适配器，确定性 JSON 输出，零 LLM 成本 |
| AI Agent 需要可靠的网站操作 | opencli | 数百个命令，结构化输出，快速且确定的响应 |
| 临时探索未知网站 | Browser-Use, Stagehand | LLM 驱动的通用浏览，适合一次性任务 |
| 大规模网页抓取 | Crawl4AI, Scrapy | 专为吞吐量和规模化设计 |
| 从终端控制桌面 Electron 应用 | opencli | CDP + AppleScript — 唯一能做到这一点的 CLI 工具 |
opencli 的独特之处：
- 零 LLM 成本 — 运行时不消耗 token。运行 10,000 次也无需付费。
- 确定性 — 相同的命令，每次都能获得相同的输出模式。可管道化、可脚本化，对 CI 友好。
- 覆盖面广 — 涵盖全球及中文平台（Bilibili、知乎、小红书、Reddit、HackerNews 等）超过 50 个站点，并通过 CDP 支持桌面 Electron 应用。
有关与 Browser-Use、Crawl4AI、Firecrawl 等工具的详细对比，请参阅对比指南。
快速开始
1. 安装 Browser Bridge 扩展
OpenCLI 通过轻量级的 Browser Bridge Chrome 扩展 + 微型守护进程（零配置，自动启动）连接到你的浏览器。
- 前往 GitHub Releases 页面 下载最新的
opencli-extension.zip。 - 解压文件，打开
chrome://extensions，开启右上角的开发者模式。 - 点击 加载已解压的扩展程序 并选择解压后的文件夹。
2. 安装 OpenCLI
通过 npm 安装（推荐）
npm install -g @jackwener/opencli
3. 验证与测试
opencli doctor # 检查扩展程序 + 守护进程的连接状态
立即尝试：
opencli list # 查看所有命令
opencli hackernews top --limit 5 # 公共 API，无需浏览器
opencli bilibili hot --limit 5 # 浏览器命令（需要扩展程序）
更新
npm install -g @jackwener/opencli@latest
开发者指南
从源码安装
git clone git@github.com:jackwener/opencli
cd opencli
npm install
npm run build