@jackwener/opencli 1.6.1 → 1.6.3

package/docs/.vitepress/config.mts

@@ -1,234 +0,0 @@
-import { defineConfig } from 'vitepress'
-
-export default defineConfig({
-  base: '/docs/',
-  title: 'OpenCLI',
-  description: 'Make any website or Electron App your CLI — AI-powered, account-safe, self-healing.',
-
-  head: [
-    ['meta', { property: 'og:title', content: 'OpenCLI Documentation' }],
-    ['meta', { property: 'og:description', content: 'Make any website or Electron App your CLI.' }],
-    ['meta', { name: 'twitter:card', content: 'summary_large_image' }],
-  ],
-
-  locales: {
-    root: {
-      label: 'English',
-      lang: 'en',
-      themeConfig: {
-        nav: [
-          { text: 'Guide', link: '/guide/getting-started' },
-          { text: 'Adapters', link: '/adapters/' },
-          { text: 'Developer', link: '/developer/contributing' },
-          { text: 'Advanced', link: '/advanced/cdp' },
-        ],
-        sidebar: {
-          '/guide/': [
-            {
-              text: 'Guide',
-              items: [
-                { text: 'Getting Started', link: '/guide/getting-started' },
-                { text: 'Installation', link: '/guide/installation' },
-                { text: 'Comparison', link: '/comparison' },
-                { text: 'Browser Bridge', link: '/guide/browser-bridge' },
-                { text: 'Troubleshooting', link: '/guide/troubleshooting' },
-                { text: 'Add an Electron App CLI', link: '/guide/electron-app-cli' },
-                { text: 'Plugins', link: '/guide/plugins' },
-              ],
-            },
-          ],
-          '/adapters/': [
-            {
-              text: 'Adapters Overview',
-              items: [
-                { text: 'All Adapters', link: '/adapters/' },
-              ],
-            },
-            {
-              text: 'Browser Adapters',
-              collapsed: false,
-              items: [
-                { text: 'Twitter / X', link: '/adapters/browser/twitter' },
-                { text: 'Reddit', link: '/adapters/browser/reddit' },
-                { text: 'Tieba', link: '/adapters/browser/tieba' },
-                { text: 'Bilibili', link: '/adapters/browser/bilibili' },
-                { text: 'Zhihu', link: '/adapters/browser/zhihu' },
-                { text: 'Xiaohongshu', link: '/adapters/browser/xiaohongshu' },
-                { text: 'Weibo', link: '/adapters/browser/weibo' },
-                { text: 'YouTube', link: '/adapters/browser/youtube' },
-                { text: 'Xueqiu', link: '/adapters/browser/xueqiu' },
-                { text: 'V2EX', link: '/adapters/browser/v2ex' },
-                { text: 'Bloomberg', link: '/adapters/browser/bloomberg' },
-                { text: 'LinkedIn', link: '/adapters/browser/linkedin' },
-                { text: 'Coupang', link: '/adapters/browser/coupang' },
-                { text: 'BOSS Zhipin', link: '/adapters/browser/boss' },
-                { text: 'Ctrip', link: '/adapters/browser/ctrip' },
-                { text: 'Reuters', link: '/adapters/browser/reuters' },
-                { text: 'SMZDM', link: '/adapters/browser/smzdm' },
-                { text: 'Jike', link: '/adapters/browser/jike' },
-                { text: 'Jimeng', link: '/adapters/browser/jimeng' },
-                { text: 'Yollomi', link: '/adapters/browser/yollomi' },
-                { text: 'LINUX DO', link: '/adapters/browser/linux-do' },
-                { text: 'Band', link: '/adapters/browser/band' },
-                { text: 'Chaoxing', link: '/adapters/browser/chaoxing' },
-                { text: 'Grok', link: '/adapters/browser/grok' },
-                { text: 'Amazon', link: '/adapters/browser/amazon' },
-                { text: 'Gemini', link: '/adapters/browser/gemini' },
-                { text: 'NotebookLM', link: '/adapters/browser/notebooklm' },
-                { text: 'WeRead', link: '/adapters/browser/weread' },
-                { text: 'Douban', link: '/adapters/browser/douban' },
-                { text: 'Sina Blog', link: '/adapters/browser/sinablog' },
-                { text: 'Substack', link: '/adapters/browser/substack' },
-                { text: 'Pixiv', link: '/adapters/browser/pixiv' },
-                { text: 'Douban', link: '/adapters/browser/douban' },
-                { text: 'Doubao', link: '/adapters/browser/doubao' },
-                { text: 'Facebook', link: '/adapters/browser/facebook' },
-                { text: 'Google', link: '/adapters/browser/google' },
-                { text: 'IMDb', link: '/adapters/browser/imdb' },
-                { text: 'Instagram', link: '/adapters/browser/instagram' },
-                { text: 'JD.com', link: '/adapters/browser/jd' },
-                { text: 'Medium', link: '/adapters/browser/medium' },
-                { text: 'TikTok', link: '/adapters/browser/tiktok' },
-                { text: 'Web (Generic)', link: '/adapters/browser/web' },
-                { text: 'Weixin', link: '/adapters/browser/weixin' },
-              ],
-            },
-            {
-              text: 'Public API Adapters',
-              collapsed: false,
-              items: [
-                { text: 'HackerNews', link: '/adapters/browser/hackernews' },
-                { text: 'Dev.to', link: '/adapters/browser/devto' },
-                { text: 'Dictionary', link: '/adapters/browser/dictionary' },
-                { text: 'BBC', link: '/adapters/browser/bbc' },
-                { text: 'Apple Podcasts', link: '/adapters/browser/apple-podcasts' },
-                { text: 'Xiaoyuzhou', link: '/adapters/browser/xiaoyuzhou' },
-                { text: 'Yahoo Finance', link: '/adapters/browser/yahoo-finance' },
-                { text: 'arXiv', link: '/adapters/browser/arxiv' },
-                { text: 'paperreview.ai', link: '/adapters/browser/paperreview' },
-                { text: 'Barchart', link: '/adapters/browser/barchart' },
-                { text: 'Hugging Face', link: '/adapters/browser/hf' },
-                { text: 'Sina Finance', link: '/adapters/browser/sinafinance' },
-                { text: 'Spotify', link: '/adapters/browser/spotify' },
-                { text: 'Stack Overflow', link: '/adapters/browser/stackoverflow' },
-                { text: 'Wikipedia', link: '/adapters/browser/wikipedia' },
-                { text: 'Lobsters', link: '/adapters/browser/lobsters' },
-                { text: 'Steam', link: '/adapters/browser/steam' },
-              ],
-            },
-            {
-              text: 'Desktop Adapters',
-              collapsed: false,
-              items: [
-                { text: 'Cursor', link: '/adapters/desktop/cursor' },
-                { text: 'Codex', link: '/adapters/desktop/codex' },
-                { text: 'Antigravity', link: '/adapters/desktop/antigravity' },
-                { text: 'ChatGPT', link: '/adapters/desktop/chatgpt' },
-                { text: 'ChatWise', link: '/adapters/desktop/chatwise' },
-                { text: 'Notion', link: '/adapters/desktop/notion' },
-                { text: 'Discord', link: '/adapters/desktop/discord' },
-                { text: 'Doubao App', link: '/adapters/desktop/doubao-app' },
-              ],
-            },
-          ],
-          '/developer/': [
-            {
-              text: 'Developer Guide',
-              items: [
-                { text: 'Contributing', link: '/developer/contributing' },
-                { text: 'Testing', link: '/developer/testing' },
-                { text: 'Architecture', link: '/developer/architecture' },
-                { text: 'YAML Adapter Guide', link: '/developer/yaml-adapter' },
-                { text: 'TypeScript Adapter Guide', link: '/developer/ts-adapter' },
-                { text: 'AI Workflow', link: '/developer/ai-workflow' },
-              ],
-            },
-          ],
-          '/advanced/': [
-            {
-              text: 'Advanced',
-              items: [
-                { text: 'Chrome DevTools Protocol', link: '/advanced/cdp' },
-                { text: 'Electron Apps', link: '/advanced/electron' },
-                { text: 'Remote Chrome', link: '/advanced/remote-chrome' },
-                { text: 'Download Support', link: '/advanced/download' },
-              ],
-            },
-          ],
-        },
-      },
-    },
-    zh: {
-      label: '中文',
-      lang: 'zh-CN',
-      link: '/zh/',
-      themeConfig: {
-        nav: [
-          { text: '指南', link: '/zh/guide/getting-started' },
-          { text: '适配器', link: '/zh/adapters/' },
-          { text: '开发者', link: '/zh/developer/contributing' },
-          { text: '进阶', link: '/zh/advanced/cdp' },
-        ],
-        sidebar: {
-          '/zh/guide/': [
-            {
-              text: '指南',
-              items: [
-                { text: '快速开始', link: '/zh/guide/getting-started' },
-                { text: '安装', link: '/zh/guide/installation' },
-                { text: 'Browser Bridge', link: '/zh/guide/browser-bridge' },
-                { text: '给新 Electron 应用生成 CLI', link: '/zh/guide/electron-app-cli' },
-                { text: '插件', link: '/zh/guide/plugins' },
-              ],
-            },
-          ],
-          '/zh/adapters/': [
-            {
-              text: '适配器概览',
-              items: [
-                { text: '所有适配器', link: '/zh/adapters/' },
-              ],
-            },
-          ],
-          '/zh/developer/': [
-            {
-              text: '开发者指南',
-              items: [
-                { text: '贡献指南', link: '/zh/developer/contributing' },
-              ],
-            },
-          ],
-          '/zh/advanced/': [
-            {
-              text: '进阶',
-              items: [
-                { text: 'Chrome DevTools Protocol', link: '/zh/advanced/cdp' },
-              ],
-            },
-          ],
-        },
-      },
-    },
-  },
-
-  themeConfig: {
-    search: {
-      provider: 'local',
-    },
-
-    socialLinks: [
-      { icon: 'github', link: 'https://github.com/jackwener/opencli' },
-      { icon: 'npm', link: 'https://www.npmjs.com/package/@jackwener/opencli' },
-    ],
-
-    editLink: {
-      pattern: 'https://github.com/jackwener/opencli/edit/main/docs/:path',
-      text: 'Edit this page on GitHub',
-    },
-
-    footer: {
-      message: 'Released under the Apache-2.0 License.',
-      copyright: 'Copyright © 2024-present jackwener',
-    },
-  },
-})

package/docs/adapters/browser/36kr.md

@@ -1,47 +0,0 @@
-# 36kr (36氪)
-
-**Mode**: 🌐 Public / 🔐 Browser · **Domain**: `36kr.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli 36kr hot` | 36氪热榜 — trending articles |
-| `opencli 36kr news` | Latest tech/startup news from 36kr |
-| `opencli 36kr search <query>` | Search 36kr articles |
-| `opencli 36kr article <id-or-url>` | Read full article content |
-
-## Usage Examples
-
-```bash
-# Trending articles
-opencli 36kr hot --limit 10
-
-# Hot by type
-opencli 36kr hot --type renqi --limit 10
-opencli 36kr hot --type zonghe --limit 10
-
-# Latest news
-opencli 36kr news --limit 20
-
-# Search articles
-opencli 36kr search "AI" --limit 10
-opencli 36kr search "OpenAI" --limit 5
-
-# Read full article (by ID or URL)
-opencli 36kr article 3000000123456
-opencli 36kr article https://36kr.com/p/3000000123456
-
-# JSON output
-opencli 36kr hot -f json
-```
-
-## Notes
-
-- `news` uses the public RSS feed and works without Browser Bridge.
-- `hot`, `search`, and `article` use Browser Bridge and are best run with Chrome open.
-- `hot --type` accepts `catalog`, `renqi`, `zonghe`, and `shoucang`.
-
-## Prerequisites
-
-- No browser required — uses public API

package/docs/adapters/browser/amazon.md

@@ -1,53 +0,0 @@
-# Amazon
-
-**Mode**: 🔐 Browser · **Domain**: `amazon.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli amazon bestsellers [<best-sellers-url>]` | Read Amazon Best Sellers pages for ranked candidate discovery |
-| `opencli amazon search "<query>"` | Read Amazon search results for coarse filtering |
-| `opencli amazon product <asin-or-url>` | Read a product page with title, price, rating, breadcrumbs, and bullets |
-| `opencli amazon offer <asin-or-url>` | Read seller / fulfillment / buy-box facts from the product page |
-| `opencli amazon discussion <asin-or-url>` | Read review summary and sample customer reviews |
-
-## Usage Examples
-
-```bash
-# Root Best Sellers page
-opencli amazon bestsellers https://www.amazon.com/Best-Sellers/zgbs --limit 10 -f json
-
-# Category-specific Best Sellers page
-opencli amazon bestsellers "<category-best-sellers-url>" --limit 50 -f json
-
-# Search products
-opencli amazon search "desk shelf organizer" --limit 20 -f json
-
-# Validate one product
-opencli amazon product B0FJS72893 -f json
-
-# Validate seller / offer facts
-opencli amazon offer B0FJS72893 -f json
-
-# Read review summary + samples
-opencli amazon discussion B0FJS72893 --limit 5 -f json
-```
-
-## Prerequisites
-
-- Chrome running with an active `amazon.com` session in the shared profile
-- [Browser Bridge extension](/guide/browser-bridge) installed
-
-## Notes
-
-- This adapter only returns fields visible on public Amazon pages.
-- `bestsellers` and `search` are for candidate discovery; `product`, `offer`, and `discussion` are the validation surfaces.
-- `offer` is the right surface for `sold_by`, `ships_from`, and Amazon-retail exclusion.
-- `discussion` may return review data even when Q&A is absent. Missing Q&A is a normal outcome, not an error.
-
-## Troubleshooting
-
-- If Amazon shows a robot-check page, clear it in Chrome and retry.
-- If CDP is attached to the wrong tab, retry with `OPENCLI_CDP_TARGET=amazon.com`.
-- Avoid running multiple Amazon browser commands in parallel against the same shared Chrome target.

package/docs/adapters/browser/apple-podcasts.md

@@ -1,28 +0,0 @@
-# Apple Podcasts
-
-**Mode**: 🌐 Public · **Domain**: `podcasts.apple.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli apple-podcasts search` | |
-| `opencli apple-podcasts episodes` | |
-| `opencli apple-podcasts top` | |
-
-## Usage Examples
-
-```bash
-# Quick start
-opencli apple-podcasts search --limit 5
-
-# JSON output
-opencli apple-podcasts search -f json
-
-# Verbose mode
-opencli apple-podcasts search -v
-```
-
-## Prerequisites
-
-- No browser required — uses public API

package/docs/adapters/browser/arxiv.md

@@ -1,27 +0,0 @@
-# arXiv
-
-**Mode**: 🌐 Public · **Domain**: `arxiv.org`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli arxiv search` | Search arXiv papers |
-| `opencli arxiv paper` | Get arXiv paper details by ID |
-
-## Usage Examples
-
-```bash
-# Search for papers
-opencli arxiv search "transformer attention" --limit 10
-
-# Get paper details by arXiv ID
-opencli arxiv paper 2301.00001
-
-# JSON output
-opencli arxiv search "LLM" -f json
-```
-
-## Prerequisites
-
-- No browser required — uses public arXiv API

package/docs/adapters/browser/band.md

@@ -1,63 +0,0 @@
-# Band
-
-**Mode**: 🔐 Browser · **Domain**: `www.band.us`
-
-Read posts, comments, and notifications from [Band](https://www.band.us), a private community platform. Authentication uses your logged-in Chrome session (cookie-based).
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli band bands` | List all Bands you belong to |
-| `opencli band posts <band_no>` | List posts from a Band |
-| `opencli band post <band_no> <post_no>` | Export full post content including nested comments |
-| `opencli band mentions` | Show notifications where you were @mentioned |
-
-## Usage Examples
-
-```bash
-# List all your bands (get band_no from here)
-opencli band bands
-
-# List recent posts in a band
-opencli band posts 12345678 --limit 10
-
-# Export a post with comments
-opencli band post 12345678 987654321
-
-# Export post body only (skip comments)
-opencli band post 12345678 987654321 --comments false
-
-# Export post and download attached photos
-opencli band post 12345678 987654321 --output ./band-photos
-
-# Show recent @mention notifications
-opencli band mentions --limit 20
-
-# Show only unread mentions
-opencli band mentions --unread true
-
-# Show all notification types
-opencli band mentions --filter all
-```
-
-### `band mentions` filter options
-
-| Filter | Description |
-|--------|-------------|
-| `mentioned` | Only notifications where you were @mentioned (default) |
-| `all` | All notifications |
-| `post` | Post-related notifications |
-| `comment` | Comment-related notifications |
-
-## Prerequisites
-
-- Chrome running and **logged into** [band.us](https://www.band.us)
-- [Browser Bridge extension](/guide/browser-bridge) installed
-
-## Notes
-
-- `band_no` is the numeric ID in the Band URL: `band.us/band/{band_no}/post`
-- `band bands` lists all your bands with their `band_no` values
-- `band post` output rows: `type=post` (the post itself), `type=comment` (top-level comment), `type=reply` (nested reply)
-- Photo downloads use the full-resolution URL (thumbnail query params are stripped automatically)

package/docs/adapters/browser/barchart.md

@@ -1,33 +0,0 @@
-# Barchart
-
-**Mode**: 🔐 Browser · **Domain**: `barchart.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli barchart quote` | Stock quote with price, volume, and key metrics |
-| `opencli barchart options` | Options chain with greeks, IV, volume, and open interest |
-| `opencli barchart greeks` | Options greeks overview (IV, delta, gamma, theta, vega) |
-| `opencli barchart flow` | Unusual options activity / options flow |
-
-## Usage Examples
-
-```bash
-# Get stock quote
-opencli barchart quote AAPL
-
-# View options chain
-opencli barchart options TSLA
-
-# Options greeks overview
-opencli barchart greeks NVDA
-
-# Unusual options flow
-opencli barchart flow --limit 20 -f json
-```
-
-## Prerequisites
-
-- Chrome running and able to open `barchart.com`
-- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/bbc.md

@@ -1,26 +0,0 @@
-# BBC News
-
-**Mode**: 🌐 Public · **Domain**: `bbc.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli bbc news` | |
-
-## Usage Examples
-
-```bash
-# Quick start
-opencli bbc news --limit 5
-
-# JSON output
-opencli bbc news -f json
-
-# Verbose mode
-opencli bbc news -v
-```
-
-## Prerequisites
-
-- No browser required — uses public API

package/docs/adapters/browser/bilibili.md

@@ -1,47 +0,0 @@
-# Bilibili
-
-**Mode**: 🔐 Browser · **Domain**: `bilibili.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli bilibili hot` | |
-| `opencli bilibili search` | |
-| `opencli bilibili me` | |
-| `opencli bilibili favorite` | |
-| `opencli bilibili history` | |
-| `opencli bilibili feed` | |
-| `opencli bilibili subtitle` | |
-| `opencli bilibili dynamic` | |
-| `opencli bilibili ranking` | |
-| `opencli bilibili following` | |
-| `opencli bilibili user-videos` | |
-| `opencli bilibili download` | |
-
-## Usage Examples
-
-```bash
-# Quick start
-opencli bilibili hot --limit 5
-
-# Search videos
-opencli bilibili search 黑神话 --limit 10
-
-# Read one creator's videos
-opencli bilibili user-videos 2 --limit 10
-
-# Fetch subtitles
-opencli bilibili subtitle BV1xx411c7mD --lang zh-CN
-
-# JSON output
-opencli bilibili hot -f json
-
-# Verbose mode
-opencli bilibili hot -v
-```
-
-## Prerequisites
-
-- Chrome running and **logged into** bilibili.com
-- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/bloomberg.md

@@ -1,70 +0,0 @@
-# Bloomberg
-
-**Mode**: 🌐 / 🔐 Mixed · **Domains**: `feeds.bloomberg.com`, `www.bloomberg.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli bloomberg main` | Bloomberg homepage top stories from RSS |
-| `opencli bloomberg markets` | Bloomberg Markets top stories from RSS |
-| `opencli bloomberg economics` | Bloomberg Economics top stories from RSS |
-| `opencli bloomberg industries` | Bloomberg Industries top stories from RSS |
-| `opencli bloomberg tech` | Bloomberg Tech top stories from RSS |
-| `opencli bloomberg politics` | Bloomberg Politics top stories from RSS |
-| `opencli bloomberg businessweek` | Bloomberg Businessweek top stories from RSS |
-| `opencli bloomberg opinions` | Bloomberg Opinion top stories from RSS |
-| `opencli bloomberg feeds` | List the RSS feed aliases used by the adapter |
-| `opencli bloomberg news <link>` | Read a standard Bloomberg story/article page and return title, summary, media links, and article text |
-
-## What works today
-
-- RSS-backed listing commands work without a browser:
-  - `main`
-  - `markets`
-  - `economics`
-  - `industries`
-  - `tech`
-  - `politics`
-  - `businessweek`
-  - `opinions`
-  - `feeds`
-- `bloomberg news` works on standard Bloomberg story/article pages that expose `#__NEXT_DATA__` and are accessible to your current Chrome session.
-
-## Current limitations
-
-- Audio pages and some other non-standard Bloomberg URLs may fail.
-- Some Bloomberg pages can return bot-protection or access-gated responses instead of article data.
-- This adapter is for data retrieval/extraction only. It does **not** bypass Bloomberg paywall, login, entitlement, or other access checks.
-
-## Usage Examples
-
-```bash
-# List supported RSS feed aliases
-opencli bloomberg feeds
-
-# Fetch Bloomberg homepage headlines
-opencli bloomberg main --limit 5
-
-# Fetch a section feed as JSON
-opencli bloomberg tech --limit 3 -f json
-
-# Read a standard article page
-opencli bloomberg news https://www.bloomberg.com/news/articles/2026-03-19/example -f json
-
-# Relative article paths also work
-opencli bloomberg news /news/articles/2026-03-19/example
-```
-
-## Prerequisites
-
-- RSS commands do not require Chrome.
-- `bloomberg news` requires:
-  - Chrome running
-  - a Chrome session that can already access the target Bloomberg article page
-  - the [Browser Bridge extension](/guide/browser-bridge)
-
-## Notes
-
-- RSS commands support `--limit` with a maximum of 20 items.
-- If `bloomberg news` fails on a page from RSS, try a different standard story/article link first; not every Bloomberg URL in feeds is a normal article page.