👁️ 101
👍 75
📅 2026-06-13 收录
🔄 2026-06-13 更新

正文内容

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