OpenCLI Usage Guide
Make any website or Electron App your CLI. Reuse Chrome login, zero risk, AI-powered discovery.
Install & Run
# npm global install (recommended)
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
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.
Quick Lookup by Capability
| Capability |
Platforms (partial list) |
File |
| search |
Bilibili, Twitter, Reddit, Xiaohongshu, Zhihu, YouTube, Google, arXiv, LinkedIn, Pixiv, etc. |
browser.md / public-api.md |
| hot/trending |
Bilibili, Twitter, Weibo, HackerNews, Reddit, V2EX, Xueqiu, Lobsters, Douban |
browser.md / public-api.md |
| feed/timeline |
Twitter, Reddit, Xiaohongshu, Xueqiu, Jike, Facebook, Instagram, Medium |
browser.md |
| user/profile |
Twitter, Reddit, Instagram, TikTok, Facebook, Bilibili, Pixiv |
browser.md |
| post/create |
Twitter, Jike, Douyin, Weibo |
browser.md |
| AI chat |
Grok, Doubao, ChatGPT, Gemini, Cursor, Codex, NotebookLM |
browser.md / desktop.md |
| finance/stock |
Xueqiu, Yahoo Finance, Barchart, Sina Finance, Bloomberg |
browser.md / public-api.md |
| web scraping |
opencli web read --url <url> — any URL to Markdown |
browser.md |
Command Quick Reference
Usage: opencli <site> <command> [args] [--limit N] [-f json|yaml|md|csv|table]
Browser-based (login required)
| Site |
Commands |
| bilibili |
hot search me favorite history feed user-videos subtitle dynamic ranking following |
| zhihu |
hot search question |
| xiaohongshu |
search notifications feed user note comments download publish creator-notes creator-note-detail creator-notes-summary creator-profile creator-stats |
| xueqiu |
hot-stock stock watchlist feed hot search comments earnings-date fund-holdings fund-snapshot |
| 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 |
| reddit |
hot frontpage popular search subreddit read user user-posts user-comments upvote save comment subscribe saved upvoted |
| youtube |
search video transcript |
| facebook |
feed profile search friends groups events notifications memories add-friend join-group |
| instagram |
explore profile search user followers following follow unfollow like unlike comment save unsave saved |
| tiktok |
explore search profile user following follow unfollow like unlike comment save unsave live notifications friends |
| linkedin |
search timeline |
| medium |
feed search user |
| substack |
feed search publication |
| sinablog |
hot search article user |
| weibo |
hot search feed user me post comments |
| douyin |
profile videos user-videos activities collections hashtag location stats publish draft drafts delete update |
| 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 |
| douban |
search top250 subject photos download marks reviews movie-hot book-hot |
| pixiv |
ranking search user illusts detail download |
| jike |
feed search create like comment repost notifications post topic user |
| band |
bands posts post mentions |
| zsxq |
groups dynamics topics topic search |
| tieba |
hot search posts read |
| yahoo-finance |
quote |
| barchart |
quote options greeks flow |
| sinafinance |
news |
| reuters |
search |
| amazon |
bestsellers search product offer discussion |
| coupang |
search add-to-cart |
| jd |
item |
| smzdm |
search |
| ctrip |
search |
| 36kr |
hot news search article |
| weread |
shelf search book highlights notes notebooks ranking |
| chaoxing |
assignments exams |
| jimeng |
generate history |
| yollomi |
models generate video upload remove-bg edit background face-swap object-remover restore try-on upscale |
| ones |
login logout me tasks task my-tasks worklog token-info |
| web |
read — any URL to Markdown |
| weixin |
download — 公众号 article to Markdown |
| v2ex (browser) |
daily me notifications |
| linux-do (browser) |
hot latest feed search categories category tags topic user-posts user-topics |
| bloomberg (browser) |
news — full article reader |
| grok |
ask |
| doubao |
status new send read ask detail history meeting-summary meeting-transcript |
| gemini |
ask new image |
| notebooklm |
status list open get current history summary note-list notes-get source-list source-get source-fulltext source-guide |
Desktop (CDP/Electron)
| Site |
Commands |
| gh |
repo pr issue — passthrough to gh CLI |
| cursor |
status send read new dump composer model extract-code ask screenshot history export |
| codex |
status send read new dump extract-diff model ask screenshot history export |
| chatgpt |
status new send read ask model |
| chatwise |
status new send read ask model history export screenshot |
| notion |
status search read new write sidebar favorites export |
| discord-app |
status send read channels servers search members |
| doubao-app |
status new send read ask screenshot dump |
| antigravity |
status send read new dump extract-code model watch |
Public API (no browser)
| Site |
Commands |
| hackernews |
top new best ask show jobs search user |
| v2ex (public) |
hot latest topic node nodes member user replies |
| bbc |
news |
| lobsters |
hot newest active tag |
| google |
news search suggest trends |
| devto |
top tag user |
| steam |
top-sellers |
| apple-podcasts |
top search episodes |
| arxiv |
search paper |
| bloomberg (RSS) |
main markets tech politics economics opinions industries businessweek feeds |
| dictionary |
search synonyms examples |
| hf |
top |
| stackoverflow |
hot search bounties unanswered |
| xiaoyuzhou |
podcast podcast-episodes episode |
| wikipedia |
search summary random trending |
| producthunt |
today hot browse posts |
| imdb |
top trending search title person reviews |
| spotify |
auth status play |
| paperreview |
submit review feedback |
Management
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
Related Skills
- opencli-operate — Browser automation for AI agents (navigate, click, type, extract via Chrome)
- opencli-explorer — Full guide for creating new adapters (API discovery, auth strategy, YAML/TS writing)
- opencli-oneshot — Quick 4-step template for adding a single command from a URL
1---2name: opencli-usage3description: Use when running OpenCLI commands to interact with websites (Bilibili, Twitter, Reddit, Xiaohongshu, etc.), desktop apps (Cursor, Notion), or public APIs (HackerNews, arXiv). Covers installation, command reference, and output formats for 73+ adapters.4---56# OpenCLI Usage Guide78> Make any website or Electron App your CLI. Reuse Chrome login, zero risk, AI-powered discovery.910## Install & Run1112```bash13# npm global install (recommended)14npm install -g @jackwener/opencli15opencli <command>1617# Or from source18cd ~/code/opencli && npm install19npx tsx src/main.ts <command>2021# Update to latest22npm update -g @jackwener/opencli23```2425## Prerequisites2627Browser commands require:281. Chrome browser running **(logged into target sites)**292. **opencli Browser Bridge** Chrome extension installed (load `extension/` as unpacked in `chrome://extensions`)303. No further setup needed — the daemon auto-starts on first browser command3132> **Note**: You must be logged into the target website in Chrome before running commands. Tabs opened during command execution are auto-closed afterwards.3334Public API commands (`hackernews`, `v2ex`) need no browser.3536## Quick Lookup by Capability3738| Capability | Platforms (partial list) | File |39|-----------|--------------------------|------|40| **search** | Bilibili, Twitter, Reddit, Xiaohongshu, Zhihu, YouTube, Google, arXiv, LinkedIn, Pixiv, etc. | browser.md / public-api.md |41| **hot/trending** | Bilibili, Twitter, Weibo, HackerNews, Reddit, V2EX, Xueqiu, Lobsters, Douban | browser.md / public-api.md |42| **feed/timeline** | Twitter, Reddit, Xiaohongshu, Xueqiu, Jike, Facebook, Instagram, Medium | browser.md |43| **user/profile** | Twitter, Reddit, Instagram, TikTok, Facebook, Bilibili, Pixiv | browser.md |44| **post/create** | Twitter, Jike, Douyin, Weibo | browser.md |45| **AI chat** | Grok, Doubao, ChatGPT, Gemini, Cursor, Codex, NotebookLM | browser.md / desktop.md |46| **finance/stock** | Xueqiu, Yahoo Finance, Barchart, Sina Finance, Bloomberg | browser.md / public-api.md |47| **web scraping** | `opencli web read --url <url>` — any URL to Markdown | browser.md |4849## Command Quick Reference5051Usage: `opencli <site> <command> [args] [--limit N] [-f json|yaml|md|csv|table]`5253### Browser-based (login required)5455| Site | Commands |56|------|----------|57| **bilibili** | `hot` `search` `me` `favorite` `history` `feed` `user-videos` `subtitle` `dynamic` `ranking` `following` |58| **zhihu** | `hot` `search` `question` |59| **xiaohongshu** | `search` `notifications` `feed` `user` `note` `comments` `download` `publish` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats` |60| **xueqiu** | `hot-stock` `stock` `watchlist` `feed` `hot` `search` `comments` `earnings-date` `fund-holdings` `fund-snapshot` |61| **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` |62| **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` |63| **youtube** | `search` `video` `transcript` |64| **facebook** | `feed` `profile` `search` `friends` `groups` `events` `notifications` `memories` `add-friend` `join-group` |65| **instagram** | `explore` `profile` `search` `user` `followers` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `saved` |66| **tiktok** | `explore` `search` `profile` `user` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `live` `notifications` `friends` |67| **linkedin** | `search` `timeline` |68| **medium** | `feed` `search` `user` |69| **substack** | `feed` `search` `publication` |70| **sinablog** | `hot` `search` `article` `user` |71| **weibo** | `hot` `search` `feed` `user` `me` `post` `comments` |72| **douyin** | `profile` `videos` `user-videos` `activities` `collections` `hashtag` `location` `stats` `publish` `draft` `drafts` `delete` `update` |73| **bluesky** | `search` `profile` `user` `feeds` `followers` `following` `thread` `trending` `starter-packs` |74| **boss** | `search` `detail` `recommend` `joblist` `greet` `batchgreet` `send` `chatlist` `chatmsg` `invite` `mark` `exchange` `resume` `stats` |75| **douban** | `search` `top250` `subject` `photos` `download` `marks` `reviews` `movie-hot` `book-hot` |76| **pixiv** | `ranking` `search` `user` `illusts` `detail` `download` |77| **jike** | `feed` `search` `create` `like` `comment` `repost` `notifications` `post` `topic` `user` |78| **band** | `bands` `posts` `post` `mentions` |79| **zsxq** | `groups` `dynamics` `topics` `topic` `search` |80| **tieba** | `hot` `search` `posts` `read` |81| **yahoo-finance** | `quote` |82| **barchart** | `quote` `options` `greeks` `flow` |83| **sinafinance** | `news` |84| **reuters** | `search` |85| **amazon** | `bestsellers` `search` `product` `offer` `discussion` |86| **coupang** | `search` `add-to-cart` |87| **jd** | `item` |88| **smzdm** | `search` |89| **ctrip** | `search` |90| **36kr** | `hot` `news` `search` `article` |91| **weread** | `shelf` `search` `book` `highlights` `notes` `notebooks` `ranking` |92| **chaoxing** | `assignments` `exams` |93| **jimeng** | `generate` `history` |94| **yollomi** | `models` `generate` `video` `upload` `remove-bg` `edit` `background` `face-swap` `object-remover` `restore` `try-on` `upscale` |95| **ones** | `login` `logout` `me` `tasks` `task` `my-tasks` `worklog` `token-info` |96| **web** | `read` — any URL to Markdown |97| **weixin** | `download` — 公众号 article to Markdown |98| **v2ex** (browser) | `daily` `me` `notifications` |99| **linux-do** (browser) | `hot` `latest` `feed` `search` `categories` `category` `tags` `topic` `user-posts` `user-topics` |100| **bloomberg** (browser) | `news` — full article reader |101| **grok** | `ask` |102| **doubao** | `status` `new` `send` `read` `ask` `detail` `history` `meeting-summary` `meeting-transcript` |103| **gemini** | `ask` `new` `image` |104| **notebooklm** | `status` `list` `open` `get` `current` `history` `summary` `note-list` `notes-get` `source-list` `source-get` `source-fulltext` `source-guide` |105106### Desktop (CDP/Electron)107108| Site | Commands |109|------|----------|110| **gh** | `repo` `pr` `issue` — passthrough to gh CLI |111| **cursor** | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` |112| **codex** | `status` `send` `read` `new` `dump` `extract-diff` `model` `ask` `screenshot` `history` `export` |113| **chatgpt** | `status` `new` `send` `read` `ask` `model` |114| **chatwise** | `status` `new` `send` `read` `ask` `model` `history` `export` `screenshot` |115| **notion** | `status` `search` `read` `new` `write` `sidebar` `favorites` `export` |116| **discord-app** | `status` `send` `read` `channels` `servers` `search` `members` |117| **doubao-app** | `status` `new` `send` `read` `ask` `screenshot` `dump` |118| **antigravity** | `status` `send` `read` `new` `dump` `extract-code` `model` `watch` |119120### Public API (no browser)121122| Site | Commands |123|------|----------|124| **hackernews** | `top` `new` `best` `ask` `show` `jobs` `search` `user` |125| **v2ex** (public) | `hot` `latest` `topic` `node` `nodes` `member` `user` `replies` |126| **bbc** | `news` |127| **lobsters** | `hot` `newest` `active` `tag` |128| **google** | `news` `search` `suggest` `trends` |129| **devto** | `top` `tag` `user` |130| **steam** | `top-sellers` |131| **apple-podcasts** | `top` `search` `episodes` |132| **arxiv** | `search` `paper` |133| **bloomberg** (RSS) | `main` `markets` `tech` `politics` `economics` `opinions` `industries` `businessweek` `feeds` |134| **dictionary** | `search` `synonyms` `examples` |135| **hf** | `top` |136| **stackoverflow** | `hot` `search` `bounties` `unanswered` |137| **xiaoyuzhou** | `podcast` `podcast-episodes` `episode` |138| **wikipedia** | `search` `summary` `random` `trending` |139| **producthunt** | `today` `hot` `browse` `posts` |140| **imdb** | `top` `trending` `search` `title` `person` `reviews` |141| **spotify** | `auth` `status` `play` |142| **paperreview** | `submit` `review` `feedback` |143144### Management145146```bash147opencli list [-f json|yaml] # List all commands148opencli validate [site] # Validate adapter definitions149opencli doctor # Diagnose browser bridge150opencli explore <url> # AI-powered API discovery151opencli record <url> # Record API calls manually152```153154All commands support: `--format` / `-f` with `table` `json` `yaml` `md` `csv`155156## Related Skills157158- **opencli-operate** — Browser automation for AI agents (navigate, click, type, extract via Chrome)159- **opencli-explorer** — Full guide for creating new adapters (API discovery, auth strategy, YAML/TS writing)160- **opencli-oneshot** — Quick 4-step template for adding a single command from a URL
pixiesgeosun