OpenCLI Tool Integration

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 扩展

1. 访问 [GitHub Releases 页面](https://github.com/jackwener/opencli/releases) 下载最新版扩展包
2. 在 Chrome 中打开 chrome://extensions
3. 启用右上角「开发者模式」
4. 将 .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 的当前登录会话。运行前请确保：

1. Chrome 浏览器处于运行状态
2. 已在 Chrome 中完成目标网站的登录（如 bilibili、zhihu、xiaohongshu）
3. 若返回空结果或 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    # 实时查看守护进程日志输出  

最佳实践

1. 始终验证登录态：执行浏览器命令前，务必确认 Chrome 已登录目标网站
2. 合理选择输出格式：JSON 便于脚本解析与管道处理；YAML / Markdown 更适合人工阅读与调试
3. 限制返回数量：使用 --limit 参数避免因响应过大导致超时或内存溢出
4. 定期验证连接：通过 opencli doctor 检查扩展与守护进程通信是否正常
5. 持续探索新功能：定期运行 opencli list，及时了解新增网站支持与命令能力

项目信息

• GitHub 仓库: https://github.com/jackwener/opencli
• NPM 包地址: https://www.npmjs.com/package/@jackwener/opencli
• 许可证: Apache-2.0
• Node.js 最低要求: >= 20.0.0

命令行