/opencli-reader

name: opencli-reader
description: >
  Generic read-only fallback for any source opencli covers but this repo has no dedicated
  reader for — Yahoo Finance, Bloomberg, Reuters, Barchart, Eastmoney, Xueqiu, Sinafinance,
  Reddit, HackerNews, Substack, Medium, Weibo, Bilibili, Xiaohongshu, Zhihu, arXiv,
  Google Scholar, Apple Podcasts, Xiaoyuzhou, Spotify, YouTube, Weixin, Amazon, and more.
  Triggers: "use opencli to read", "grab the frontpage from hackernews",
  "read reddit r/wallstreetbets", "fetch Eastmoney hot stocks", "pull Xueqiu feed",
  "get Bloomberg markets headlines", "search arXiv for", any request to read from a site
  where a specialized skill does not exist but opencli does.
  FALLBACK — prefer twitter-reader, linkedin-reader, discord-reader, telegram-reader, or
  yc-reader when the source matches. READ-ONLY — never invoke write operations.

opencli Reader (Generic Fallback, Read-Only)

Generic fallback for any source opencli supports via its [adapter registry](https://github.com/jackwener/opencli) (100+ sites, growing). Use this skill only when **no dedicated finance-skill covers the source** — the specialized skills (`twitter-reader`, `linkedin-reader`, `discord-reader`, `telegram-reader`, `yc-reader`) are always preferred when the request matches one of them.

**This skill is read-only.** Write commands that opencli exposes (post, like, comment, send, save, upvote, subscribe, follow, delete, reply-dm, etc.) must not be invoked.

---

Step 1: Decide Whether to Use This Skill

Only use this skill if the request **cannot** be handled by a more specific skill.

| If the user asks about… | Use this skill instead | |---|---| | Twitter/X | `twitter-reader` | | LinkedIn | `linkedin-reader` | | Discord | `discord-reader` | | Telegram | `telegram-reader` | | Y Combinator | `yc-reader` | | Anything else opencli supports (Yahoo Finance, Bloomberg, Reuters, Reddit, HackerNews, Eastmoney, Xueqiu, Substack, arXiv, etc.) | **this skill** |

If the source is not in opencli's registry either, stop and tell the user the request isn't covered — don't fall back to ad-hoc scraping.

---

Step 2: Ensure opencli Is Ready

**Current environment status:**

!`(command -v opencli && opencli doctor 2>&1 | head -5 && echo "READY" || echo "SETUP_NEEDED") 2>/dev/null || echo "NOT_INSTALLED"`

If `NOT_INSTALLED`:

npm install -g @jackwener/opencli

If `SETUP_NEEDED`, guide the user through Browser Bridge setup (only required for adapters whose strategy is `COOKIE`, `HEADER`, `INTERCEPT`, or `UI` — `PUBLIC` and `LOCAL` adapters work without a browser):

1. Download the latest `opencli-extension-v{version}.zip` from the [GitHub Releases page](https://github.com/jackwener/opencli/releases) 2. Unzip it, open `chrome://extensions` in Chrome, enable **Developer mode** 3. Click **Load unpacked** and select the unzipped folder 4. Make sure Chrome is logged into the target site, then re-run `opencli doctor`

Requires Node.js >= 20 (or Bun >= 1.0).

---

Step 3: Discover the Right Command

**Do not guess command names or flags** — the registry has 500+ commands and changes weekly. Instead:

# Full registry (grouped by site), machine-readable JSON
opencli list -f json

# Filter to a site
opencli list | grep -i <site>

# Site-level help (all commands + flags)
opencli <site> --help

# Command-level help (positional args + flags + defaults)
opencli <site> <command> --help

The `opencli list -f json` entry for each command includes:

• `site` — adapter namespace (e.g., `yahoo-finance`)
• `name` — subcommand (e.g., `quote`)
• `strategy` — `PUBLIC` / `COOKIE` / `HEADER` / `INTERCEPT` / `UI` / `LOCAL` — tells you if a browser login is needed
• `description`, `args`, `columns` — canonical metadata

Use `opencli list -f json` as the source of truth. Never paste a site list into the plan from memory; adapters are added every week.

Quick map of the most common finance / research sources

The table below is a **shortlist**, not exhaustive — always confirm with `opencli <site> --help`.

| Source | Site slug | Common commands | |---|---|---| | Yahoo Finance | `yahoo-finance` | `quote` | | Bloomberg | `bloomberg` | `markets`, `economics`, `industries`, `tech`, `politics`, `opinions`, `news`, `businessweek`, `feeds`, `main` | | Reuters | `reuters` | `search` | | Eastmoney (东方财富) | `eastmoney` | `quote`, `rank`, `kline`, `sectors`, `etf`, `holders`, `money-flow`, `northbound`, `longhu`, `kuaixun`, `convertible`, `index-board`, `announcement`, `hot-rank` | | Xueqiu (雪球) | `xueqiu` | `stock`, `hot-stock`, `hot`, `feed`, `comments`, `watchlist`, `search`, `groups`, `fund-snapshot`, `fund-holdings`, `earnings-date`, `kline` | | Sinafinance | `sinafinance` | (see `--help`) | | TDX / THS | `tdx`, `ths` | (see `--help`) | | Barchart (options) | `barchart` | `quote`, `options`, `flow`, `greeks` | | Reddit | `reddit` | `hot`, `popular`, `frontpage`, `search`, `subreddit`, `read`, `user`, `user-posts`, `user-comments`, `saved` | | HackerNews | `hackernews` | `top`, `best`, `new`, `ask`, `show`, `jobs`, `user`, `search` | | Substack | `substack` | `feed`, `publication`, `search` | | Medium | `medium` | (see `--help`) | | arXiv | `arxiv` | (see `--help`) | | Google Scholar | `google-scholar` | (see `--help`) | | Weibo | `weibo` | (see `--help`) | | Bilibili | `bilibili` | `hot`, `video` + more | | Xiaohongshu (小红书) | `xiaohongshu` | (see `--help`) | | Rednote (小红书 international) | `rednote` | (see `--help` — mirrors `xiaohongshu`) | | Zhihu | `zhihu` | (see `--help`) | | Tieba (百度贴吧) | `tieba` | (see `--help`) | | Hupu (虎扑) | `hupu` | (see `--help`) | | Xianyu (闲鱼) | `xianyu` | (see `--help`) | | 1688 | `1688` | (see `--help`) | | Gitee | `gitee` | (see `--help`) | | Quark | `quark` | (see `--help`) | | Baidu Scholar | `baidu-scholar` | (see `--help`) | | Nowcoder | `nowcoder` | (see `--help`) | | Wanfang | `wanfang` | (see `--help`) | | Doubao (豆包) | `doubao` | (see `--help`) | | Yuanba