Opencli Reader

opencli Reader (Generic Fallback, Read-Only)

Generic fallback for any source opencli supports via its adapter registry (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 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
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.

For anything not listed, run opencli list -f json and filter.

Step 4: Check the Adapter's Strategy Before Running

Run opencli list -f json (or opencli <site> <command> --help) and read the strategy field:

If the user doesn't have a login and the adapter's strategy is not PUBLIC / LOCAL, tell them they need to log into the site in Chrome before retrying.

Step 5: Execute the Command

General pattern

opencli <site> <command> [positional-args] [flags] -f json

Universal flags

Command-specific flags (--limit, --filter, --type, etc.) are not universal — always check opencli <site> <command> --help.

Examples

# Yahoo Finance quote (PUBLIC)
opencli yahoo-finance quote AAPL -f json

# Reddit hot posts in a subreddit (COOKIE or PUBLIC depending on subreddit)
opencli reddit subreddit wallstreetbets --limit 20 -f json
opencli reddit search "SPY options" --limit 15 -f json

# HackerNews top (PUBLIC)
opencli hackernews top --limit 20 -f json

# Eastmoney hot rank (PUBLIC)
opencli eastmoney hot-rank -f json

# Xueqiu hot stocks (PUBLIC or COOKIE)
opencli xueqiu hot-stock -f json