正文内容
OpenCLI Skill
借助 OpenCLI 工具,AI Agent 可访问并操作 30+ 个网站、桌面应用及外部 CLI 工具。
核心能力
1. 网站数据获取
支持复用 Chrome 浏览器登录状态,从以下平台抓取结构化数据:
- 社交媒体: Twitter/X, Reddit, 微博, 即刻
- 视频平台: Bilibili, YouTube, 小红书
- 问答社区: 知乎, V2EX, StackOverflow, Linux-Do
- 新闻资讯: BBC, Bloomberg, Reuters, HackerNews, Dev.to
- 求职招聘: Boss直聘, LinkedIn
- 电商购物: Coupang, 什么值得买
- 金融财经: 雪球, Yahoo Finance, Barchart
- 其他: 微信读书, 携程, Wikipedia, arXiv, Steam
2. 桌面应用控制
可控制本地已安装且正在运行的桌面应用:
- Cursor: 控制 Composer、提取代码、访问历史记录
- Codex: 驱动 OpenAI Codex CLI
- ChatGPT: 自动化 ChatGPT macOS 应用
- ChatWise: 多 LLM 客户端控制
- Notion: 搜索、读取、写入 Notion 页面
- Discord: 消息发送/读取、频道与服务器管理
- Antigravity: 通过终端控制 Antigravity Ultra
- Grok: Grok 桌面应用
3. 外部 CLI Hub
自动发现、安装并转发命令至外部 CLI 工具:
-
gh— GitHub CLI -
docker— Docker 命令行工具 -
kubectl— Kubernetes 命令行工具 -
obsidian— Obsidian vault 管理 CLI -
readwise— Readwise & Reader CLI
4. 媒体下载
支持图片、视频与文章内容下载:
- 小红书: 图片、视频
- Bilibili: 视频(依赖 yt-dlp)
- Twitter: 图片、视频
- 知乎: 文章(导出为 Markdown 格式)
使用前准备
安装 OpenCLI
npm install -g @jackwener/opencli
安装 Browser Bridge 扩展
- 访问 [GitHub Releases 页面](https://github.com/jackwener/opencli/releases) 下载最新版扩展包
- 在 Chrome 中打开
chrome://extensions - 启用右上角「开发者模式」
- 将
.crx文件或解压后的文件夹拖入页面完成安装
验证安装
opencli list # 列出所有可用命令
opencli doctor # 检查 Browser Bridge 扩展与守护进程连接状态
opencli doctor --live # 执行实时浏览器命令连通性测试
命令格式
基本格式
opencli [options]
# 示例
opencli bilibili hot --limit 10
opencli zhihu search --keyword "AI"
opencli twitter trending --limit 5
输出格式
支持多种结构化输出格式:
opencli bilibili hot -f table # 表格(默认)
opencli bilibili hot -f json # JSON
opencli bilibili hot -f yaml # YAML
opencli bilibili hot -f md # Markdown
opencli bilibili hot -f csv # CSV
详细模式
opencli bilibili hot -v # 显示完整执行管道与调试步骤
常用命令示例
获取热门内容
# Bilibili 热门榜单
opencli bilibili hot --limit 10
# 知乎热榜
opencli zhihu hot
# Hacker News Top 文章
opencli hackernews top --limit 5
# 微博热搜
opencli weibo hot
# Reddit 热门帖子
opencli reddit hot --limit 10
搜索
# Bilibili 关键词搜索
opencli bilibili search --keyword "AI教程" --limit 10
# 知乎问题/文章搜索
opencli zhihu search --keyword "机器学习"
# YouTube 视频搜索
opencli youtube search --keyword "OpenAI"
# arXiv 论文搜索
opencli arxiv search --keyword "transformer"
# 小红书笔记搜索
opencli xiaohongshu search --keyword "美食"
下载媒体
# 下载 Bilibili 视频(需提前安装 yt-dlp)
opencli bilibili download --bvid BV1xxx --output ./videos
# 下载小红书笔记中的图片/视频
opencli xiaohongshu download --note-id abc123 --output ./xhs
# 下载 Twitter 用户媒体(如推文附图/视频)
opencli twitter download elonmusk --limit 20 --output ./twitter
# 导出知乎专栏文章为 Markdown
opencli zhihu download "https://zhuanlan.zhihu.com/p/xxx" --output ./zhihu
桌面应用控制
# 查询 Cursor 当前状态
opencli cursor status
# 在 Notion 中搜索页面
opencli notion search --query "项目"
# 向 ChatGPT macOS 应用发送消息
opencli chatgpt send --message "Hello"
# 读取 Discord 当前频道最新消息
opencli discord-app read
外部 CLI
# 调用 GitHub CLI 获取 PR 列表
opencli gh pr list --limit 5
# 查看本地 Docker 容器列表
opencli docker ps
# 查询 Kubernetes Pod 状态
opencli kubectl get pods
重要注意事项
浏览器命令
⚠️ 重要提示:浏览器命令完全复用 Chrome 的当前登录会话。运行前请确保:
- Chrome 浏览器处于运行状态
- 已在 Chrome 中完成目标网站的登录(如 bilibili、zhihu、xiaohongshu)
- 若返回空结果或
401 Unauthorized错误,请检查对应网站登录状态及 Cookie 是否有效
视频下载
Bilibili 等平台视频下载依赖 yt-dlp:
pip install yt-dlp
# 或(macOS Homebrew)
brew install yt-dlp
公开 API vs 浏览器命令
- 公开 API 接口(如 hackernews、bbc、wikipedia):无需浏览器,直接发起 HTTP 请求
- 浏览器命令(如 bilibili、zhihu、xiaohongshu):必须运行 Chrome 并保持对应网站登录态
探索和发现
查看所有可用命令
opencli list
opencli list -f yaml # 以 YAML 格式输出完整命令清单
探索新网站
# 对目标网站进行深度 API 探测与行为分析
opencli explore https://example.com --site mysite
# 基于探测结果自动生成适配器 YAML 配置
opencli synthesize mysite
# 一键生成适配器及基础命令集(例如定义“hot”榜单逻辑)
opencli generate https://example.com --goal "hot"
注册自己的 CLI
opencli register mycli
故障排除
扩展未连接
- 确认 Browser Bridge 扩展已成功安装并启用
- 访问
chrome://extensions检查扩展状态与权限设置
空数据或未授权错误
- 在 Chrome 中手动打开对应网站,确认已登录且会话未过期
- 尝试刷新网页,确保 Cookie 和认证 Token 处于有效状态
Node API 错误
- 确保运行环境使用 Node.js >= 20.0.0(推荐 LTS 版本)
守护进程问题
curl localhost:19825/status # 检查守护进程健康状态
curl localhost:19825/logs # 实时查看守护进程日志输出
最佳实践
- 始终验证登录态:执行浏览器命令前,务必确认 Chrome 已登录目标网站
- 合理选择输出格式:JSON 便于脚本解析与管道处理;YAML / Markdown 更适合人工阅读与调试
-
限制返回数量:使用
--limit参数避免因响应过大导致超时或内存溢出 -
定期验证连接:通过
opencli doctor检查扩展与守护进程通信是否正常 -
持续探索新功能:定期运行
opencli list,及时了解新增网站支持与命令能力
项目信息
- GitHub 仓库: https://github.com/jackwener/opencli
- NPM 包地址: https://www.npmjs.com/package/@jackwener/opencli
- 许可证: Apache-2.0
- Node.js 最低要求: >= 20.0.0