OpenCLI

把任何网站、本地工具、Electron 应用变成能够让 AI 调用的命令行！
零风控 · 复用 Chrome 登录 · AI 自动发现接口 · 全能 CLI 枢纽

OpenCLI 将任何网站、本地 CLI 或 Electron 应用（如 Antigravity）变成命令行工具 — B站、知乎、小红书、Twitter/X、Reddit、YouTube，以及 gh、docker 等多种站点与工具 — 复用浏览器登录态，AI 驱动探索。

专为 AI Agent 打造：只需在全局 .cursorrules 或 AGENT.md 中配置简单指令，引导 AI 通过 Bash 执行 opencli list 来检索可用的 CLI 工具及其用法。随后，将你常用的 CLI 列表整合注册进去（opencli register mycli），AI 便能瞬间学会自动调用相应的本地工具！

opencli 支持 CLI 化所有 electron 应用！最强大更新来袭！ CLI all electron！现在支持把所有 electron 应用 CLI 化，从而组合出各种神奇的能力。 如果你在使用诸如 Antigravity Ultra 等工具时觉得不够灵活或难以扩展，现在通过 OpenCLI 把他 CLI 化，轻松打破界限。 现在，AI 可以自己控制自己！结合 cc/openclaw 就可以远程控制任何 electron 应用！无限玩法！！

亮点

• CLI All Electron — 支持把所有 electron 应用（如 Antigravity Ultra）CLI 化，让 AI 控制自己！
• 多站点覆盖 — 覆盖 B站、知乎、小红书、Twitter、Reddit，以及多种桌面应用
• 零风控 — 复用 Chrome 登录态，无需存储任何凭证
• 外部 CLI 枢纽 — 统一发现、自动安装、透传执行 gh、docker 等本地 CLI
• 自修复配置 — opencli doctor 自动启动 daemon，诊断扩展和浏览器连接状态
• AI 原生 — explore 自动发现 API，synthesize 生成适配器，cascade 探测认证策略
• 动态加载引擎 — 声明式的 .yaml 或者底层定制的 .ts 适配器，放入 clis/ 文件夹即可自动注册生效

为什么选 opencli？

浏览器自动化工具很多，opencli 适合什么场景？

| 你的需求 | 最佳工具 | 原因 | |----------|----------|------| | 定时从特定站点提取结构化数据 | opencli | 预定义适配器，确定性 JSON 输出，零 LLM 成本 | | AI Agent 需要可靠的站点操作 | opencli | 数百条命令，结构化输出，快速确定性响应 | | 临时探索未知网站 | Browser-Use、Stagehand | LLM 驱动的通用浏览，适合一次性任务 | | 大规模网页爬取 | Crawl4AI、Scrapy | 专为吞吐量和规模设计 | | 从终端控制桌面 Electron 应用 | opencli | CDP + AppleScript，目前唯一能做到这一点的 CLI 工具 |

opencli 的核心差异：

• 零 LLM 成本 — 运行时不消耗任何 token，跑一万次不花一分钱
• 确定性 — 同一命令永远返回同一结构，可管道化、可脚本化、CI 友好
• 覆盖广泛 — 50+ 站点，横跨全球与中国平台（B站、知乎、小红书、Reddit、HackerNews 等），并支持通过 CDP 控制桌面 Electron 应用

与 Browser-Use、Crawl4AI、Firecrawl 等工具的详细对比，请查看 Comparison Guide。

前置要求

• Node.js: >= 20.0.0
• Chrome 浏览器正在运行，且已登录目标网站（如 bilibili.com、zhihu.com、xiaohongshu.com）

⚠️ 重要：大多数命令复用你的 Chrome 登录状态。运行命令前，你必须已在 Chrome 中打开目标网站并完成登录。如果获取到空数据或报错，请先检查你的浏览器登录状态。

OpenCLI 通过轻量化的 Browser Bridge Chrome 扩展 + 微型 daemon 与浏览器通信（零配置，自动启动）。

Browser Bridge 扩展配置

你可以选择以下任一方式安装扩展：

方式一：下载构建好的安装包（推荐）

1. 到 GitHub Releases 页面 下载最新的 opencli-extension.zip。
2. 解压后打开 Chrome 的 chrome://extensions，启用右上角的 开发者模式。
3. 点击 加载已解压的扩展程序，选择解压后的文件夹。

方式二：加载源码（针对开发者）

1. 同样在 chrome://extensions 开启 开发者模式。
2. 点击 加载已解压的扩展程序，选择本仓库代码树中的 extension/ 文件夹。

完成！运行任何 opencli 浏览器命令时，后台微型 daemon 会自动启动与浏览器通信。无需配 API Token，零代码配置。

Tip：后续诊断用 opencli doctor：

opencli doctor            # 检查扩展和 daemon 连通性

快速开始

npm 全局安装（推荐）

npm install -g @jackwener/opencli

直接使用：

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 输出

从源码安装（面向开发者）

git clone [email protected]:jackwener/opencli.git
cd opencli 
npm install
npm run build
npm link      # 链接到全局环境
opencli list  # 可以在任何地方使用了！

更新

npm install -g @jackwener/opencli@latest

内置命令

运行 opencli list 查看完整注册表。

| 站点 | 命令 | 模式 | |------|------|------| | twitter | trending bookmarks profile search timeline thread following followers notifications post reply delete like article follow unfollow bookmark unbookmark download accept reply-dm block unblock hide-reply | 浏览器 | | reddit | hot frontpage popular search subreddit read user user-posts user-comments upvote save comment subscribe saved upvoted | 浏览器 | | cursor | status send read new dump composer model extract-code ask screenshot history export | 桌面端 | | bilibili | hot search me favorite history feed subtitle dynamic ranking following user-videos download | 浏览器 | | codex | status send read new dump extract-diff model ask screenshot history export | 桌面端 | | chatwise | status new send read ask model history export screenshot | 桌面端 | | doubao | status new send read ask | 浏览器 | | doubao-app | status new send read ask screenshot dump | 桌面端 | | notion | status search read new write sidebar favorites export | 桌面端 | | discord-app | status send read channels servers search members | 桌面端 | | v2ex | hot latest topic node user member replies nodes daily me notifications | 公开 / 浏览器 | | xueqiu | feed hot-stock hot search stock watchlist earnings-date fund-holdings fund-snapshot | 浏览器 | | antigravity | status send read new dump extract-code model watch | 桌面端 | | chatgpt | status new send read ask model | 桌面端 | | xiaohongshu | search notifications feed user download publish creator-notes creator-note-detail creator-notes-summary creator-profile creator-stats | 浏览器 | | apple-podcasts | search episodes top | 公开 | | xiaoyuzhou | podcast podcast-episodes episode | 公开 | | zhihu | hot search question download | 浏览器 | | weixin | download | 浏览器 | | youtube | search video transcript | 浏览器 | | boss | search detail recommend joblist greet batchgreet send chatlist chatmsg invite mark exchange resume stats | 浏览器 | | coupang | search add-to-cart | 浏览器 | | bbc | news | 公共 API | | bloomberg | main markets economics industries tech politics businessweek opinions feeds news | 公共 API / 浏览器 | | ctrip | search | 浏览器 | | devto | top tag user | 公开 | | dictionary | search synonyms examples | 公开 | | arxiv | search paper | 公开 | | paperreview | submit review feedback | 公开 | | wikipedia | search summary random trending | 公开 | | hackernews | top new best ask show jobs search user | 公共 API | | jd | item | 浏览器 | | linkedin | search timeline | 浏览器 | | reuters | search | 浏览器 | | smzdm | search | 浏览器 | | web | read | 浏览器 | | weibo | hot search | 浏览器 | | yahoo-finance | quote | 浏览器 | | sinafinance | news | 🌐 公开 | | barchart | quote options greeks flow | 浏览器 | | chaoxing | assignments exams | 浏览器 | | grok | ask | 浏览器 | | hf | top | 公开 | | jike | feed search create like comment repost notifications post topic user | 浏览器 | | jimeng | generate history | 浏览器 | | yollomi | generate video edit upload models remove-bg upscale face-swap restore try-on background object-remover | 浏览器 | | linux-do | feed categories tags search topic user-topics user-posts | 浏览器 | | stackoverflow | hot search bounties unanswered | 公开 | | steam | top-sellers | 公开 | | weread | shelf search book highlights notes notebooks ranking | 浏览器 | | douban | search top250 subject photos download marks reviews movie-hot book-hot | 浏览器 | | facebook | feed profile search friends groups events notifications memories add-friend join-group | 浏览器 | | google | news search suggest trends | 公开 | | 36kr | news hot search article | 公开 / 浏览器 | | imdb | search title top trending person reviews | 公开 | | producthunt | posts today hot browse | 公开 / 浏览器 | | instagram | explore profile search user followers following follow unfollow like unlike comment save unsave saved | 浏览器 | | lobsters | hot newest active tag | 公开 | | medium | feed search user | 浏览器 | | sinablog | hot search article user | 浏览器 | | substack | feed search publication | 浏览器 | | pixiv | ranking search user illusts detail download | 浏览器 | | tiktok | explore search profile user following follow unfollow like unlike comment save unsave live notifications friends | 浏览器 |

外部 CLI 枢纽

OpenCLI 也可以作为你现有命令行工具的统一入口，负责发现、自动安装和纯透传执行。

| 外部 CLI | 描述 | 示例 | |----------|------|------| | gh | GitHub CLI | opencli gh pr list --limit 5 | | obsidian | Obsidian 仓库管理 | opencli obsidian search query="AI" | | docker | Docker 命令行工具 | opencli docker ps | | readwise | Readwise / Reader CLI | opencli readwise login | | gws | Google Workspace CLI — Docs, Sheets, Drive, Gmail, Calendar | opencli gws docs list |

零配置透传：OpenCLI 会把你的输入原样转发给底层二进制，保留原生 stdout / stderr 行为。

自动安装：如果你运行 opencli gh ... 时系统中还没有 gh，OpenCLI 会优先尝试通过系统包管理器安装，然后自动重试命令。

注册自定义本地 CLI：

opencli register mycli

桌面应用适配器

每个桌面适配器都有自己详细的文档说明，包括命令参考、启动配置与使用示例：

| 应用 | 描述 | 文档 | |-----|-------------|-----| | Cursor | 控制 Cursor IDE — Composer、对话、代码提取等 | Doc | | Codex | 在后台（无头）驱动 OpenAI Codex CLI Agent | Doc | | Antigravity | 在终端直接控制 Antigravity Ultra | Doc | | ChatGPT | 自动化操作 ChatGPT macOS 桌面客户端 | Doc | | ChatWise | 多 LLM 客户端（GPT-4、Claude、Gemini） | Doc | | Notion | 搜索、读取、写入 Notion 页面 | Doc | | Discord | Discord 桌面版 — 消息、频道、服务器 | Doc | | Doubao | 通过 CDP 控制豆包桌面应用 | Doc |

下载支持

OpenCLI 支持从各平台下载图片、视频和文章。

支持的平台

| 平台 | 内容类型 | 说明 | |------|----------|------| | 小红书 | 图片、视频 | 下载笔记中的所有媒体文件 | | B站 | 视频 | 需要安装 yt-dlp | | Twitter/X | 图片、视频 | 从用户媒体页或单条推文下载 | | Pixiv | 图片 | 下载原始画质插画，支持多页作品 | | 知乎 | 文章（Markdown） | 导出文章，可选下载图片到本地 | | 微信公众号 | 文章（Markdown） | 导出微信公众号文章为 Markdown | | 豆瓣 | 图片 | 下载电影条目的海报 / 剧照图片 |

前置依赖

下载流媒体平台的视频需要安装 yt-dlp：

# 安装 yt-dlp
pip install yt-dlp
# 或者
brew install yt-dlp

使用示例

# 下载小红书笔记中的图片/视频
opencli xiaohongshu download abc123 --output ./xhs

# 下载B站视频（需要 yt-dlp）
opencli bilibili download BV1xxx --output ./bilibili
opencli bilibili download BV1xxx --quality 1080p  # 指定画质

# 下载 Twitter 用户的媒体
opencli twitter download elonmusk --limit 20 --output ./twitter

# 下载单条推文的媒体
opencli twitter download --tweet-url "https://x.com/user/status/123" --output ./twitter

# 下载豆瓣电影海报 / 剧照
opencli douban download 30382501 --output ./douban

# 导出知乎文章为 Markdown
opencli zhihu download "https://zhuanlan.zhihu.com/p/xxx" --output ./zhihu

# 导出并下载图片
opencli zhihu download "https://zhuanlan.zhihu.com/p/xxx" --download-images

# 导出微信公众号文章为 Markdown
opencli weixin download --url "https://mp.weixin.qq.com/s/xxx" --output ./weixin

输出格式

所有内置命令都支持 --format / -f，可选值为 table、json、yaml、md、csv。 list 命令也支持同样的格式参数，同时继续兼容 --json。

opencli list -f yaml            # 用 YAML 列出命令注册表
opencli bilibili hot -f table   # 默认：富文本表格
opencli bilibili hot -f json    # JSON（适合传给 jq 或者各类 AI Agent）
opencli bilibili hot -f yaml    # YAML（更适合人类直接阅读）
opencli bilibili hot -f md      # Markdown
opencli bilibili hot -f csv     # CSV
opencli bilibili hot -v         # 详细模式：展示管线执行步骤调试信息

插件

通过社区贡献的插件扩展 OpenCLI。插件使用与内置命令相同的 YAML/TS 格式，启动时自动发现。

opencli plugin install github:user/opencli-plugin-my-tool  # 安装
opencli plugin list                                         # 查看已安装
opencli plugin update my-tool                               # 更新到最新
opencli plugin update --all                                 # 更新全部已安装插件
opencli plugin uninstall my-tool                            # 卸载

当 plugin 的版本被记录到 ~/.opencli/plugins.lock.json 后，opencli plugin list 也会显示对应的短 commit hash。

| 插件 | 类型 | 描述 | |------|------|------| | opencli-plugin-github-trending | YAML | GitHub Trending 仓库 | | opencli-plugin-hot-digest | TS | 多平台热榜聚合 | | opencli-plugin-juejin | YAML | 稀土掘金热门文章 |

详见 插件指南 了解如何创建自己的插件。

致 AI Agent（开发者指南）

如果你是一个被要求查阅代码并编写新 opencli 适配器的 AI，请遵守以下工作流。

快速模式：只想为某个页面快速生成一个命令？看 CLI-ONESHOT.md — 给一个 URL + 一句话描述，4 步搞定。

完整模式：在编写任何新代码前，先阅读 CLI-EXPLORER.md。它包含完整的适配器探索开发指南、API 探测流程、5级认证策略以及常见陷阱。

# 1. Deep Explore — 网络拦截 → 响应分析 → 能力推理 → 框架检测
opencli explore https://example.com --site mysite

# 2. Synthesize — 从探索成果物生成 evaluate-based YAML 适配器
opencli synthesize mysite

# 3. Generate — 一键完成：探索 → 合成 → 注册
opencli generate https://example.com --goal "hot"

# 4. Strategy Cascade — 自动降级探测：PUBLIC → COOKIE → HEADER
opencli cascade https://api.example.com/data

探索结果输出到 .opencli/explore/<site>/。

常见问题排查

• "Extension not connected" 报错
  • 确保你当前的 Chrome 已安装且开启了 opencli Browser Bridge 扩展（在 chrome://extensions 中检查）。
• "attach failed: Cannot access a chrome-extension:// URL" 报错
  • 其他 Chrome 扩展（如 youmind、New Tab Override 或 AI 助手类扩展）可能产生冲突。请尝试暂时禁用其他扩展后重试。
• 返回空数据，或者报错 "Unauthorized"
  • Chrome 里的登录态可能已经过期。请打开当前 Chrome 页面，在新标签页重新手工登录或刷新该页面。
• Node API 错误 (如 parseArgs, fs 等)
  • 确保 Node.js 版本 >= 20。
• Daemon 问题
  • 检查 daemon 状态：curl localhost:19825/status
  • 查看扩展日志：curl localhost:19825/logs

Star History

License

Apache-2.0