Finflow — Chinese Financial Data CLI

Finflow (@openduo/finflow) aggregates real-time data from four Chinese platforms — CLS (财联社), Jin10 (金十), Xueqiu (雪球), Gelonghui (格隆汇) — with Yahoo Finance as a fallback for markets they don't cover (Japan/Korea/HK/US). Cover A-shares, HK, US stocks, futures, commodities, forex, global indices, macro & flash news.

Core principles

1. Run via Bash: finflow <command> — install first if missing: npm install -g @openduo/finflow.
2. Stock codes are flexible: sh600519, SH600519, 600519 all work — the CLI normalizes internally.
3. Markets: A-shares (SH600519), HK (00700), US (AAPL, NVDA, .DJI). JP/KR and Yahoo-only symbols fall back to Yahoo.
4. Output is always one compact JSON line — {"data": {...}, "meta": {"source", "timestamp", "command"}}. Parse it (pipe to jq or python).
5. Percent fields are percentage numbers, not ratios: changePercent: -4.34 means -4.34% (NOT -0.0434 or -434%). This holds for every percent-named field across every command — changePercent, percent, turnoverRate, amplitude, pe, pb, dividendYield, etc. Display them verbatim with a %; never ×/÷ 100. (change is the absolute price delta — a different field.)
6. Name → code first: if a company is named without a code (茅台/宁德时代/腾讯), run quote search <名字> to get the code before quoting. Never guess a code from a name.

The golden rule: classify the question, then pick ONE command

Almost every market question maps to a single finflow command that pulls the whole picture at once. The #1 source of bad answers is reconstructing data from memory — listing "半导体/AI/白酒" tickers by hand, guessing an index code, etc. Before running anything, classify what the user is actually asking (which kind of 板块? per-stock or market-wide flow? snapshot or multi-period?), then pick from the tables below. The data is one command away.

❌→✅ Anti-patterns (do not do these)