OpenCLI Skill
Make any website, Electron App, or local tool your CLI.
Zero risk, Reuse Chrome login, AI-powered discovery, Universal CLI Hub.
安装与验证
# 安装
npm install -g @jackwener/opencli@latest
# 验证
opencli --version
opencli list # 查看所有可用命令
opencli doctor # 检查扩展 + daemon 连通性
前提条件
- Node.js >= 20.0.0
- Chrome 浏览器(需登录目标网站)
- Browser Bridge 扩展(从 GitHub Releases 下载 opencli-extension.zip → chrome://extensions → 开发者模式 → 加载已解压的扩展)
常用命令速查
无需浏览器的 Public API 命令
opencli hackernews top --limit 5 # HackerNews 热榜
opencli v2ex hot --limit 5 # V2EX 热帖
opencli arxiv search "quantum" # arXiv 论文搜索
opencli stackoverflow questions "rust" # StackOverflow
opencli producthunt today # Product Hunt
需要浏览器登录的命令
# Bilibili
opencli bilibili hot --limit 5 # 热榜
opencli bilibili search "AI" # 搜索
opencli bilibili download BV1xxx # 下载视频
# Twitter/X
opencli twitter trending # 趋势
opencli twitter search "DeFi" # 搜索
opencli twitter timeline --limit 10 # 时间线
# Reddit
opencli reddit hot --limit 5 # 热帖
opencli reddit search "ethereum" # 搜索
# 小红书
opencli xiaohongshu search "美食" # 搜索
opencli xiaohongshu note abc123 # 笔记详情
# GitHub (via gh CLI)
opencli gh pr list --limit 5 # GitHub PR 列表
opencli gh issue list # Issue 列表
输出格式
opencli bilibili hot -f json # JSON 格式(适合管道/LLM)
opencli bilibili hot -f csv # CSV 格式(适合表格)
opencli bilibili hot -f yaml # YAML 格式
opencli bilibili hot -f md # Markdown 格式
opencli bilibili hot -v # Verbose 调试
外部 CLI 注册(CLI Hub)
opencli register mycli # 注册本地 CLI,AI Agent 可通过 opencli list 发现
opencli gh pr list # 自动检测并安装缺失工具
AI Agent 开发新适配器
快速模式(单命令 4 步)
browser_navigate → 打开目标 URL
browser_network_requests → 筛选 JSON API
browser_evaluate → 用 fetch 验证接口
- 写 YAML/TS adapter → build → test
认证层级
| 层级 | 条件 | 方案 |
|---|
| Tier 1 | fetch(url) 直接能拿 | Public API (YAML, browser: false) |
| Tier 2 | 加 credentials:'include' | Cookie (YAML) |
| Tier 3 | 需 Bearer/CSRF header | Header (TS) |
| Tier 4 | 页面能请求但 fetch 不行 | Intercept (TS, installInterceptor) |
自动探索
opencli explore https://example.com --site mysite # 发现 API
opencli synthesize mysite # 生成 YAML 适配器
opencli generate https://example.com --goal "hot" # 一键生成
opencli cascade https://api.example.com/data # 自动探测认证策略
退出码
| 码 | 含义 |
|---|
| 0 | 成功 |
| 66 | 空结果 |
| 69 | Browser Bridge 未连接 |
| 77 | 需要登录 |
故障排除
- "Extension not connected" → 安装 Browser Bridge 扩展到 chrome://extensions
- 空数据/Unauthorized → Chrome 中重新登录目标网站
- Daemon 问题 →
curl localhost:19825/status 检查