qiaomu-opencli-usage

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

OpenCLI Usage Guide

OpenCLI 使用指南

Make any website or Electron App your CLI. Reuse Chrome login, zero risk, AI-powered discovery.

将任意网站或Electron应用转化为你的CLI工具。复用Chrome登录状态，零风险，AI驱动的功能探索。

Install & Run

安装与运行

bash

undefined

bash

undefined

npm global install (recommended)

npm全局安装（推荐）

npm install -g @jackwener/opencli opencli <command>

Or from source

或从源码运行

cd ~/code/opencli && npm install npx tsx src/main.ts <command>

Update to latest

更新至最新版本

npm update -g @jackwener/opencli

undefined

npm update -g @jackwener/opencli

undefined

Prerequisites

前置条件

Browser commands require:

Chrome browser running (logged into target sites)
opencli Browser Bridge Chrome extension installed (load
```
extension/
```
as unpacked in
```
chrome://extensions
```
)
No further setup needed — the daemon auto-starts on first browser command

Note: You must be logged into the target website in Chrome before running commands. Tabs opened during command execution are auto-closed afterwards.

Public API commands (

hackernews

v2ex

) need no browser.

浏览器命令需要满足：

Chrome浏览器处于运行状态**（已登录目标网站）**
安装opencli Browser Bridge Chrome扩展（在
```
chrome://extensions
```
中加载
```
extension/
```
文件夹作为未打包扩展）
无需额外配置——首次运行浏览器命令时，守护进程会自动启动

注意：运行命令前，你必须已在Chrome中登录目标网站。命令执行期间打开的标签页会在事后自动关闭。

公共API命令（

hackernews

、

v2ex

）无需浏览器。

Quick Lookup by Capability

按功能快速查找

Capability	Platforms (partial list)
search	Bilibili, Twitter, Reddit, Xiaohongshu, Zhihu, YouTube, Google, arXiv, LinkedIn, Pixiv, etc.
hot/trending	Bilibili, Twitter, Weibo, HackerNews, Reddit, V2EX, Xueqiu, Lobsters, Douban
feed/timeline	Twitter, Reddit, Xiaohongshu, Xueqiu, Jike, Facebook, Instagram, Medium
user/profile	Twitter, Reddit, Instagram, TikTok, Facebook, Bilibili, Pixiv
post/create	Twitter, Jike, Douyin, Weibo
AI chat	Grok, Doubao, ChatGPT, Gemini, Cursor, Codex, NotebookLM
finance/stock	Xueqiu, Yahoo Finance, Barchart, Sina Finance, Bloomberg
web scraping	`opencli web read --url <url>` — any URL to Markdown
GitHub/DevOps	`opencli gh` , `opencli docker` , `opencli vercel` — external CLI passthrough
collaboration	`opencli lark-cli` , `opencli dws` , `opencli wecom-cli` — external CLI passthrough

功能	平台（部分列表）
搜索	Bilibili、Twitter、Reddit、小红书、知乎、YouTube、Google、arXiv、LinkedIn、Pixiv等
热门/趋势	Bilibili、Twitter、微博、HackerNews、Reddit、V2EX、雪球、Lobsters、豆瓣
动态/时间线	Twitter、Reddit、小红书、雪球、即刻、Facebook、Instagram、Medium
用户/个人主页	Twitter、Reddit、Instagram、TikTok、Facebook、Bilibili、Pixiv
发布内容	Twitter、即刻、抖音、微博
AI对话	Grok、豆包、ChatGPT、Gemini、Cursor、Codex、NotebookLM
财经/股票	雪球、Yahoo Finance、Barchart、新浪财经、Bloomberg
网页抓取	`opencli web read --url <url>` — 将任意URL转为Markdown格式
GitHub/DevOps	`opencli gh` 、 `opencli docker` 、 `opencli vercel` — 外部CLI透传
协作办公	`opencli lark-cli` 、 `opencli dws` 、 `opencli wecom-cli` — 外部CLI透传

Command Quick Reference

命令速查

Usage:

opencli <site> <command> [args] [--limit N] [-f json|yaml|md|csv|table]

Type legend: 🌐 = Browser (needs Chrome login) · ✅ = Public API (no browser) · 🖥️ = Desktop (Electron/CDP) · 🔧 = External CLI (passthrough)

用法：

opencli <site> <command> [args] [--limit N] [-f json|yaml|md|csv|table]

类型说明：🌐 = 浏览器（需Chrome登录） · ✅ = 公共API（无需浏览器） · 🖥️ = 桌面应用（Electron/CDP） · 🔧 = 外部CLI（透传）

Website Adapters

网站适配器

Site	Type	Commands
1688	🌐	`search` `item` `download` `store`
36kr	🌐	`hot` `news` `search` `article`
amazon	🌐	`bestsellers` `search` `product` `offer` `discussion` `movers-shakers` `new-releases`
apple-podcasts	✅	`top` `search` `episodes`
arxiv	✅	`search` `paper`
band	🌐	`bands` `posts` `post` `mentions`
barchart	🌐	`quote` `options` `greeks` `flow`
bbc	✅	`news`
bilibili	🌐	`hot` `search` `me` `favorite` `history` `feed` `user-videos` `subtitle` `dynamic` `ranking` `following`
bloomberg	✅🌐	RSS: `main` `markets` `tech` `politics` `economics` `opinions` `industries` `businessweek` `feeds` · Browser: `news` (full article)
bluesky	🌐	`search` `profile` `user` `feeds` `followers` `following` `thread` `trending` `starter-packs`
boss	🌐	`search` `detail` `recommend` `joblist` `greet` `batchgreet` `send` `chatlist` `chatmsg` `invite` `mark` `exchange` `resume` `stats`
chaoxing	🌐	`assignments` `exams`
coupang	🌐	`search` `add-to-cart`
ctrip	🌐	`search`
devto	✅	`top` `tag` `user`
dictionary	✅	`search` `synonyms` `examples`
doubao	🌐	`status` `new` `send` `read` `ask` `detail` `history` `meeting-summary` `meeting-transcript`
douban	🌐	`search` `top250` `subject` `photos` `download` `marks` `reviews` `movie-hot` `book-hot`
douyin	🌐	`profile` `videos` `user-videos` `activities` `collections` `hashtag` `location` `stats` `publish` `draft` `drafts` `delete` `update`
facebook	🌐	`feed` `profile` `search` `friends` `groups` `events` `notifications` `memories` `add-friend` `join-group`
gemini	🌐	`ask` `new` `image` `deep-research` `deep-research-result`
google	✅	`news` `search` `suggest` `trends`
grok	🌐	`ask`
hackernews	✅	`top` `new` `best` `ask` `show` `jobs` `search` `user`
hf	✅	`top`
hupu	🌐	`hot` `search` `detail` `like` `unlike` `reply` `mentions`
imdb	✅	`top` `trending` `search` `title` `person` `reviews`
instagram	🌐	`explore` `profile` `search` `user` `followers` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `saved`
jd	🌐	`item`
jianyu	🌐	`search`
jike	🌐	`feed` `search` `create` `like` `comment` `repost` `notifications` `post` `topic` `user`
jimeng	🌐	`generate` `history`
lesswrong	✅	`frontpage` `curated` `new` `top` `top-week` `top-month` `top-year` `shortform` `read` `comments` `user` `user-posts` `sequences` `tags` `tag`
linkedin	🌐	`search` `timeline`
linux-do	🌐	`hot` `latest` `feed` `search` `categories` `category` `tags` `topic` `topic-content` `user-posts` `user-topics`
lobsters	✅	`hot` `newest` `active` `tag`
medium	🌐	`feed` `search` `user`
notebooklm	🌐	`status` `list` `open` `current` `get` `history` `summary` `note-list` `notes-get` `source-list` `source-get` `source-fulltext` `source-guide`
ones	🌐	`login` `logout` `me` `tasks` `task` `my-tasks` `worklog` `token-info`
paperreview	✅	`submit` `review` `feedback`
pixiv	🌐	`ranking` `search` `user` `illusts` `detail` `download`
producthunt	✅	`today` `hot` `browse` `posts`
quark	🌐	`ls` `mkdir` `mv` `rename` `rm` `save` `share-tree`
reddit	🌐	`hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted`
reuters	🌐	`search`
sinablog	🌐	`hot` `search` `article` `user`
sinafinance	✅	`news`
smzdm	🌐	`search`
spotify	✅	`auth` `status` `play` `pause` `next` `prev` `volume` `search` `queue` `shuffle` `repeat`
stackoverflow	✅	`hot` `search` `bounties` `unanswered`
steam	✅	`top-sellers`
substack	🌐	`feed` `search` `publication`
tieba	🌐	`hot` `search` `posts` `read`
tiktok	🌐	`explore` `search` `profile` `user` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `live` `notifications` `friends`
twitter	🌐	`trending` `bookmarks` `search` `profile` `timeline` `thread` `article` `follow` `unfollow` `bookmark` `unbookmark` `post` `like` `likes` `reply` `delete` `block` `unblock` `followers` `following` `notifications` `hide-reply` `download` `accept` `reply-dm`
v2ex	✅🌐	Public: `hot` `latest` `topic` `node` `nodes` `member` `user` `replies` · Browser: `daily` `me` `notifications`
web	🌐	`read` — any URL to Markdown
weibo	🌐	`hot` `search` `feed` `user` `me` `post` `comments`
weixin	🌐	`download` — 公众号 article to Markdown
weread	🌐	`shelf` `search` `book` `highlights` `notes` `notebooks` `ranking`
wikipedia	✅	`search` `summary` `random` `trending`
xianyu	🌐	`search` `item` `chat`
xiaoe	🌐	`courses` `catalog` `content` `detail` `play-url`
xiaohongshu	🌐	`search` `notifications` `feed` `user` `note` `comments` `download` `publish` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats`
xiaoyuzhou	✅	`podcast` `podcast-episodes` `episode`
xueqiu	🌐	`hot-stock` `stock` `watchlist` `feed` `hot` `search` `comments` `earnings-date` `fund-holdings` `fund-snapshot`
yahoo-finance	🌐	`quote`
yollomi	🌐	`models` `generate` `video` `upload` `remove-bg` `edit` `background` `face-swap` `object-remover` `restore` `try-on` `upscale`
youtube	🌐	`search` `video` `transcript`
yuanbao	🌐	`new` `ask`
zhihu	🌐	`hot` `search` `question`
zsxq	🌐	`groups` `dynamics` `topics` `topic` `search`

站点	类型	命令
1688	🌐	`search` `item` `download` `store`
36氪	🌐	`hot` `news` `search` `article`
amazon	🌐	`bestsellers` `search` `product` `offer` `discussion` `movers-shakers` `new-releases`
apple-podcasts	✅	`top` `search` `episodes`
arxiv	✅	`search` `paper`
band	🌐	`bands` `posts` `post` `mentions`
barchart	🌐	`quote` `options` `greeks` `flow`
bbc	✅	`news`
bilibili	🌐	`hot` `search` `me` `favorite` `history` `feed` `user-videos` `subtitle` `dynamic` `ranking` `following`
bloomberg	✅🌐	RSS: `main` `markets` `tech` `politics` `economics` `opinions` `industries` `businessweek` `feeds` · 浏览器: `news` （完整文章）
bluesky	🌐	`search` `profile` `user` `feeds` `followers` `following` `thread` `trending` `starter-packs`
boss直聘	🌐	`search` `detail` `recommend` `joblist` `greet` `batchgreet` `send` `chatlist` `chatmsg` `invite` `mark` `exchange` `resume` `stats`
超星学习通	🌐	`assignments` `exams`
coupang	🌐	`search` `add-to-cart`
携程	🌐	`search`
devto	✅	`top` `tag` `user`
dictionary	✅	`search` `synonyms` `examples`
豆包	🌐	`status` `new` `send` `read` `ask` `detail` `history` `meeting-summary` `meeting-transcript`
豆瓣	🌐	`search` `top250` `subject` `photos` `download` `marks` `reviews` `movie-hot` `book-hot`
抖音	🌐	`profile` `videos` `user-videos` `activities` `collections` `hashtag` `location` `stats` `publish` `draft` `drafts` `delete` `update`
facebook	🌐	`feed` `profile` `search` `friends` `groups` `events` `notifications` `memories` `add-friend` `join-group`
gemini	🌐	`ask` `new` `image` `deep-research` `deep-research-result`
google	✅	`news` `search` `suggest` `trends`
grok	🌐	`ask`
hackernews	✅	`top` `new` `best` `ask` `show` `jobs` `search` `user`
hf	✅	`top`
虎扑	🌐	`hot` `search` `detail` `like` `unlike` `reply` `mentions`
imdb	✅	`top` `trending` `search` `title` `person` `reviews`
instagram	🌐	`explore` `profile` `search` `user` `followers` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `saved`
京东	🌐	`item`
简鱼	🌐	`search`
即刻	🌐	`feed` `search` `create` `like` `comment` `repost` `notifications` `post` `topic` `user`
即梦AI	🌐	`generate` `history`
lesswrong	✅	`frontpage` `curated` `new` `top` `top-week` `top-month` `top-year` `shortform` `read` `comments` `user` `user-posts` `sequences` `tags` `tag`
linkedin	🌐	`search` `timeline`
LinuxDo	🌐	`hot` `latest` `feed` `search` `categories` `category` `tags` `topic` `topic-content` `user-posts` `user-topics`
lobsters	✅	`hot` `newest` `active` `tag`
medium	🌐	`feed` `search` `user`
notebooklm	🌐	`status` `list` `open` `current` `get` `history` `summary` `note-list` `notes-get` `source-list` `source-get` `source-fulltext` `source-guide`
ONES	🌐	`login` `logout` `me` `tasks` `task` `my-tasks` `worklog` `token-info`
paperreview	✅	`submit` `review` `feedback`
pixiv	🌐	`ranking` `search` `user` `illusts` `detail` `download`
producthunt	✅	`today` `hot` `browse` `posts`
夸克网盘	🌐	`ls` `mkdir` `mv` `rename` `rm` `save` `share-tree`
reddit	🌐	`hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted`
路透社	🌐	`search`
新浪博客	🌐	`hot` `search` `article` `user`
新浪财经	✅	`news`
什么值得买	🌐	`search`
spotify	✅	`auth` `status` `play` `pause` `next` `prev` `volume` `search` `queue` `shuffle` `repeat`
stackoverflow	✅	`hot` `search` `bounties` `unanswered`
steam	✅	`top-sellers`
substack	🌐	`feed` `search` `publication`
贴吧	🌐	`hot` `search` `posts` `read`
tiktok	🌐	`explore` `search` `profile` `user` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `live` `notifications` `friends`
twitter	🌐	`trending` `bookmarks` `search` `profile` `timeline` `thread` `article` `follow` `unfollow` `bookmark` `unbookmark` `post` `like` `likes` `reply` `delete` `block` `unblock` `followers` `following` `notifications` `hide-reply` `download` `accept` `reply-dm`
v2ex	✅🌐	公共API: `hot` `latest` `topic` `node` `nodes` `member` `user` `replies` · 浏览器: `daily` `me` `notifications`
web	🌐	`read` — 将任意URL转为Markdown格式
微博	🌐	`hot` `search` `feed` `user` `me` `post` `comments`
微信	🌐	`download` — 将公众号文章转为Markdown格式
微信读书	🌐	`shelf` `search` `book` `highlights` `notes` `notebooks` `ranking`
wikipedia	✅	`search` `summary` `random` `trending`
闲鱼	🌐	`search` `item` `chat`
小鹅通	🌐	`courses` `catalog` `content` `detail` `play-url`
小红书	🌐	`search` `notifications` `feed` `user` `note` `comments` `download` `publish` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats`
小宇宙	✅	`podcast` `podcast-episodes` `episode`
雪球	🌐	`hot-stock` `stock` `watchlist` `feed` `hot` `search` `comments` `earnings-date` `fund-holdings` `fund-snapshot`
yahoo-finance	🌐	`quote`
Yollomi	🌐	`models` `generate` `video` `upload` `remove-bg` `edit` `background` `face-swap` `object-remover` `restore` `try-on` `upscale`
youtube	🌐	`search` `video` `transcript`
元宝AI	🌐	`new` `ask`
知乎	🌐	`hot` `search` `question`
知识星球	🌐	`groups` `dynamics` `topics` `topic` `search`

Desktop Apps (CDP/Electron)

桌面应用（CDP/Electron）

App	Commands
antigravity	`status` `send` `read` `new` `dump` `extract-code` `model` `watch`
chatgpt	`status` `new` `send` `read` `ask` `model`
chatwise	`status` `new` `send` `read` `ask` `model` `history` `export` `screenshot`
codex	`status` `send` `read` `new` `dump` `extract-diff` `model` `ask` `screenshot` `history` `export`
cursor	`status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export`
discord-app	`status` `send` `read` `channels` `servers` `search` `members`
doubao-app	`status` `new` `send` `read` `ask` `screenshot` `dump`
notion	`status` `search` `read` `new` `write` `sidebar` `favorites` `export`

应用	命令
antigravity	`status` `send` `read` `new` `dump` `extract-code` `model` `watch`
chatgpt	`status` `new` `send` `read` `ask` `model`
chatwise	`status` `new` `send` `read` `ask` `model` `history` `export` `screenshot`
codex	`status` `send` `read` `new` `dump` `extract-diff` `model` `ask` `screenshot` `history` `export`
cursor	`status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export`
discord-app	`status` `send` `read` `channels` `servers` `search` `members`
doubao-app	`status` `new` `send` `read` `ask` `screenshot` `dump`
notion	`status` `search` `read` `new` `write` `sidebar` `favorites` `export`

External CLI (passthrough)

外部CLI（透传）

OpenCLI can discover, auto-install, and passthrough commands to external CLI tools. Use

opencli install <name>

to auto-install, or

opencli register <name>

to register a local CLI.

CLI	Description	Commands
gh	GitHub CLI — repos, PRs, issues, releases	`repo` `pr` `issue` (all gh subcommands)
obsidian	Obsidian vault — notes, search, tags	All obsidian subcommands
docker	Docker CLI	All docker subcommands
lark-cli	Lark/Feishu — messages, docs, calendar, tasks (200+ commands)	All lark-cli subcommands
dws	DingTalk Workspace — messages, docs, calendar, contacts	All dws subcommands
wecom-cli	WeCom/企业微信 — contacts, todos, meetings, messages	All wecom-cli subcommands
vercel	Vercel — deploy, domains, env vars, logs	All vercel subcommands

bash

opencli install gh              # Auto-install gh CLI
opencli register my-tool        # Register a local custom CLI
opencli gh pr list --limit 5    # Passthrough to gh
opencli docker ps               # Passthrough to docker
opencli lark-cli msg send ...   # Passthrough to lark-cli

OpenCLI可以发现、自动安装并透传命令至外部CLI工具。使用

opencli install <name>

自动安装，或

opencli register <name>

注册本地CLI。

CLI	描述	命令
gh	GitHub CLI — 仓库、PR、Issue、发布	`repo` `pr` `issue` （所有gh子命令）
obsidian	Obsidian知识库 — 笔记、搜索、标签	所有obsidian子命令
docker	Docker CLI	所有docker子命令
lark-cli	Lark/飞书 — 消息、文档、日历、任务（200+命令）	所有lark-cli子命令
dws	钉钉工作台 — 消息、文档、日历、联系人	所有dws子命令
wecom-cli	企业微信 — 联系人、待办、会议、消息	所有wecom-cli子命令
vercel	Vercel — 部署、域名、环境变量、日志	所有vercel子命令

bash

opencli install gh              # 自动安装gh CLI
opencli register my-tool        # 注册本地自定义CLI
opencli gh pr list --limit 5    # 透传至gh
opencli docker ps               # 透传至docker
opencli lark-cli msg send ...   # 透传至lark-cli

Management

管理命令

bash

opencli list [-f json|yaml]     # List all commands
opencli validate [site]         # Validate adapter definitions
opencli doctor                  # Diagnose browser bridge
opencli explore <url>           # AI-powered API discovery
opencli record <url>            # Record API calls manually

All commands support:

--format

-f

with

table

json

yaml

md

csv

bash

opencli list [-f json|yaml]     # 列出所有命令
opencli validate [site]         # 验证适配器定义
opencli doctor                  # 诊断浏览器桥接状态
opencli explore <url>           # AI驱动的API探索
opencli record <url>            # 手动录制API调用

所有命令支持：

--format

-f

参数，可选格式为

table

json

yaml

md

csv

Self-Repair

自我修复

If a command fails due to a site change (selector, API, or response schema), automatically fix the adapter and retry instead of reporting failure. Re-run the command with

OPENCLI_DIAGNOSTIC=1

to get structured diagnostic context, then fix the adapter file at

RepairContext.adapter.sourcePath

and retry. Max 3 repair rounds. See the

opencli-autofix

skill for the full workflow.

若因网站变更（选择器、API或响应 schema）导致命令失败，请自动修复适配器并重试，而非直接报告错误。添加

OPENCLI_DIAGNOSTIC=1

参数重新运行命令以获取结构化诊断信息，然后在

RepairContext.adapter.sourcePath

路径下修复适配器文件并重试。最多支持3轮修复。完整工作流请查看

opencli-autofix

技能。

qiaomu-opencli-usage

Original

Translation

OpenCLI Usage Guide

OpenCLI 使用指南

Install & Run

安装与运行

npm global install (recommended)

npm全局安装（推荐）

Or from source

或从源码运行

Update to latest

更新至最新版本

Prerequisites

前置条件

Quick Lookup by Capability

按功能快速查找

Command Quick Reference

命令速查

Website Adapters

网站适配器

Desktop Apps (CDP/Electron)

桌面应用（CDP/Electron）

External CLI (passthrough)

外部CLI（透传）

Management

管理命令

Self-Repair

自我修复

Related Skills

相关技能