opencli

# OpenCLI OpenCLI 把任意网站、Electron 桌面应用和外部 CLI 收敛成一条 `opencli <site> <command>`， 再加一条 `opencli browser <session> <command>` 用来现场驱动浏览器。 它走的是**用户本机那个真实的、已登录的 Chrome**（浏览器扩展 + 本地守护进程）， 不是无痕实例、不是沙箱。这一个事实决定了本 Skill 里几乎所有规则。 本 Skill 面向的是我们自己维护的 fork（`yan-labs/OpenCLI`），和上游 `jackwener/opencli` 有差异，差异清单见 [`references/our-fork.md`](references/our-fork.md)。 --- ## 一、先判断：这件事该不该用浏览器 **动手之前先走这条阶梯，命中即停。** 每一级往下的唯一理由是「上一级确实不存在」， 不是「我对下一级更熟」。跳级的代价不是慢，是拿到看起来正常但内容不同的数据。 | 级 | 手段 | 什么时候用 | |---|---|---| | 1 | **现成脚本** | 项目里、兄弟 Skill 里已经有的 `.mjs`。直接跑，不要现写等价实现 | | 2 | **HTTP / REST API**（`curl` / `fetch`） | 没脚本但服务有 API。先用 API，跑通后固化成脚本 | | 3 | **`opencli <site> <command>` adapter** | 目标站已有 adapter。`opencli list \| grep -i <site>` 一眼就知道 | | 4 | **`opencli browser <session>` 现场驱动** | 没有 adapter，或 adapter 不覆盖这个动作 | | 5 | 写一个新 adapter | 这个动作以后还要重复做。见 [`references/adapters.md`](references/adapters.md) | ### 判据：无痕窗口打开，还是不是同一个东西？ 答案是「不是」，就**必须**走用户的真实浏览器（也就是 OpenCLI）。 需要身份的一切——第三方数据面板、Search Console、社区后台、聊天式 AI 工具—— 用运行环境自带的沙箱浏览器打开，要么直接跳登录页，要么以匿名身份返回**看起来正常 但内容不同**的结果（配额更低、字段更少、国家库不同）。这种失败会伪装成 「这个工具没有这项数据」，而正确的结论其实是「你没登录」。 反过来，**只是看一段公开文本就不要开浏览器**——先问有没有 `curl` 或公开 API。 三个 driver 的取舍（为什么默认是 OpenCLI 而不是 agent-browser 或 Claude in Chrome， 各自的实测泄漏数据）见 [`references/drivers.md`](references/drivers.md)。 ### 不在本 Skill 范围 - **找信息、做调研、搜某个话题** → 用 `agent-reach`，它已经负责多平台路由。 本 Skill 只管「怎么把浏览器开对、把数据取回来」。 --- ## 二、开工前：doctor ```bash opencli doctor ``` `doctor` 只诊断**浏览器桥**（守护进程 + 扩展 + Chrome 连线）。 `PUBL...