AI开源社区

菜单

欣淇
发布于 2026-05-09 / 0 阅读
0
0

🛠 OpenCLI：19.4k Stars，把任何网站变成 CLI 命令，AI Agent 直接调用

🛠 OpenCLI：19.4k Stars，把任何网站变成 CLI 命令，AI Agent 直接调用

项目地址：jackwener/OpenCLI | ⭐ 19,400 Stars | 🛠 TypeScript | 作者：jackwener

老实说，每次想让 AI Agent 去操作某个网站，都特别折腾——要么写爬虫、要么接 Puppeteer、要么等网站出 API。

OpenCLI 的思路很直接：把任何网站、Electron 桌面应用、甚至本地二进制工具，都变成标准的 CLI 命令。 AI Agent 装上对应的 skill，就能直接调用，就像在终端敲命令一样。

19.4k Stars、1.9k Forks、1,097 Commits，还在高速迭代。

一、一句话概括

OpenCLI = 一个 CLI 命令中心，让你和 AI Agent 通过统一的方式操作各种网站和工具。

它的核心能力分三层：

| 层 | 说明 | 例子 |

|------|------|------|

| 内置适配器 | 100+ 网站预置命令，直接调用 | opencli hackernews top --limit 5 |

| AI Agent 浏览器控制 | Agent 通过 opencli browser 操作任意网页 | Agent 帮你刷小红书、查知乎 |

| CLI Hub | 把本地工具（gh、docker、obsidian）注册进来 | opencli gh pr list |

二、安装

前提条件

# Node.js >= 21
node --version

安装 OpenCLI

npm install -g @jackwener/opencli

安装浏览器桥接扩展

OpenCLI 通过 Chrome 扩展 + 本地守护进程连接你的浏览器。

方式一：Chrome Web Store 安装（推荐）

去 Chrome Web Store 安装 OpenCLI 扩展。

方式二：手动安装

# 1. 从 Releases 下载 opencli-extension-v{version}.zip
# 2. 解压
# 3. 打开 chrome://extensions，开启开发者模式
# 4. 点击"加载已解压的扩展程序"，选择解压后的文件夹

验证安装

opencli doctor

如果你的 Chrome 正在运行且登录了目标网站，恭喜你——已经可以用了。

三、开箱即用：100+ 预置命令

装完就能跑，不用配任何东西：

# HackerNews 热门
opencli hackernews top --limit 5

# B站热榜
opencli bilibili hot --limit 5

# 知乎热搜
opencli zhihu hot

# Reddit 热门
opencli reddit hot

# 小红书
opencli xiaohongshu search --keyword "AI 工具"
opencli xiaohongshu feed

# 微博热搜
opencli weibo hot

# Twitter/X
opencli twitter trending
opencli twitter timeline

# 亚马逊
opencli amazon bestsellers
opencli amazon search --keyword "mechanical keyboard"

# GitHub CLI（通过 CLI Hub 转发）
opencli gh pr list --limit 5
opencli gh issue view 42

# Docker
opencli docker ps
opencli docker images

完整列表：docs/adapters/index.md

全部命令：

| 平台 | 命令数 | 示例 |

|------|--------|------|

| xiaohongshu | 14 | search, note, comments, feed, publish, notifications |

| bilibili | 16 | hot, search, history, feed, ranking, download, comments |

| twitter/x | 27 | trending, search, timeline, post, like, follow, bookmark |

| reddit | 14 | hot, frontpage, search, subreddit, read, comment |

| zhihu | 9 | hot, search, question, answer, comment, follow |

| amazon | 7 | bestsellers, search, product, offer, discussion |

| 1688 | 5 | search, item, download, store |

| hackernews | 8 | top, new, best, ask, show, jobs, search, user |

| gemini | 4 | new, ask, image, deep-research |

| claude | 7 | ask, send, new, status, read, history, detail |

| spotify | 10 | play, pause, next, search, queue, shuffle |

| + 更多 | ... | 累计 100+ 网站表面 |

四、多 Chrome 用户配置管理

如果你有多个 Chrome 用户配置（工作号、个人号），OpenCLI 支持多配置管理：

# 查看已连接的配置
opencli profile list

# 给配置起别名
opencli profile rename <contextId> work
opencli profile rename <contextId> personal

# 切换使用哪个配置
opencli profile use work

# 指定配置执行命令
opencli --profile work browser state
opencli --profile personal browser state

五、AI Agent 集成

这才是 OpenCLI 的真正威力。给 AI Agent 装上 skill，让 Agent 直接操作网站。

安装 Skills

npx skills add jackwener/opencli

或者按需安装：

npx skills add jackwener/opencli --skill opencli-adapter-author
npx skills add jackwener/opencli --skill opencli-browser
npx skills add jackwener/opencli --skill opencli-autofix
npx skills add jackwener/opencli --skill opencli-usage
npx skills add jackwener/opencli --skill smart-search

Skills 功能对照

| Skill | 用途 | 给 Agent 的提示词示例 |

|-------|------|----------------------|

| opencli-adapter-author | 浏览器操作 + 编写新适配器 | "帮我看一下小红书通知" / "给抖音写一个适配器" |

| opencli-autofix | 修复坏的适配器 | "知乎热门返回空了，帮我修一下" |

| opencli-browser | 浏览器自动化参考 | "用 browser 命令抓取这个页面" |

| opencli-usage | 查询所有命令和网站 | "OpenCLI 有哪些 Twitter 命令？" |

| smart-search | 搜索 OpenCLI 能力 | "找一个 B 站热榜适配器" |

Agent 能做什么

装上 opencli-adapter-author skill 后，你的 AI Agent 可以：

  • 导航：用你的已登录浏览器打开任意 URL

    • 2. 读取：通过 DOM 快照读取页面结构化内容（不是截图OCR，是真正的 DOM）

    3. 交互：点击按钮、填写表单、选择选项、按键

    4. 提取：从页面提取数据，或拦截网络 API 响应

    5. 等待：等待元素加载、文本出现、页面跳转

    六、编写自己的适配器

    如果内置适配器没有你想要的网站，可以用 opencli-adapter-author skill 让 AI Agent 帮你写：

    流程（全自动，Agent 完成）：

  • 侦察：访问网站，分类模式（SPA / SSR / JSONP / Token / Streaming）

    • 2. 发现：找到正确的 API 端点（Network 检查、初始状态、token 追踪）

    3. 鉴权策略：决定 PUBLIC / COOKIE / INTERCEPT / UI / LOCAL

    4. 字段解码：解码响应字段，设计输出列

    5. 验证：opencli browser analyze → opencli browser init / → 写适配器 → opencli browser verify /

    6. 持久化：网站知识保存到 ~/.opencli/sites//

    七、Desktop App 控制

    OpenCLI 还能控制 Electron 桌面应用：

    | 应用 | 说明 |

    |------|------|

    | Cursor | AI 编辑器 |

    | Codex CLI | OpenAI 命令行 |

    | Antigravity | Google 内部工具 |

    | ChatGPT | 桌面版 ChatGPT |

    | Notion | 笔记应用 |

    通过 CDP（Chrome DevTools Protocol）直连 Electron 应用，像控制网页一样控制桌面软件。

    八、CLI Hub

    把本地工具统一注册到 OpenCLI 的发现系统：

    # 注册已有工具
opencli external register gh
opencli external register docker
opencli external register obsidian

# 使用
opencli gh pr list
opencli docker ps
opencli obsidian search query="AI"

# 如果工具没安装，OpenCLI 会自动 brew install

    九、环境变量配置

    | 变量 | 默认值 | 说明 |

    |------|--------|------|

    | OPENCLI_DAEMON_PORT | 19825 | 守护进程端口 |

    | OPENCLI_PROFILE | — | 多 Chrome 配置时指定使用哪个 |

    | OPENCLI_CDP_ENDPOINT | — | CDP 端点（远程浏览器/Electron 应用） |

    | OPENCLI_BROWSER_CONNECT_TIMEOUT | 30 | 浏览器连接超时(秒) |

    | OPENCLI_BROWSER_COMMAND_TIMEOUT | 60 | 单条命令超时(秒) |

    | OPENCLI_VERBOSE | false | 详细日志 |

    十、从源码构建

    git clone git@github.com:jackwener/opencli.git
cd opencli
npm install
npm run build
npm link

# 加载开发版扩展
# chrome://extensions → 加载已解压 → 选择 extension/ 目录

    十一、总结

  • 100+ 网站预置命令，开箱即用
  • AI Agent 通过 skill 直接操作浏览器，无需写爬虫
  • 支持多 Chrome 配置管理
  • Desktop App 控制（Cursor、ChatGPT 等 Electron 应用）
  • CLI Hub：统一管理 gh、docker、obsidian 等本地工具
  • 完全零 LLM 成本（运行时不消耗 Token）
  • 确定性输出（同命令同结果，适合 CI）
  • 19.4k Stars，1,097 Commits，社区活跃

    • 如果你需要一个工具让你和你的 AI Agent 能统一操作各种网站和桌面应用，OpenCLI 是目前最完整的方案。

    标签：#OpenCLI #CLI #AI #浏览器自动化 #开源

    NeuTTS5.8k Stars ...
    Chrome DevTools M...

    评论