invesresearch

命令行里的投研工作台。行情、财务、可比、对话式研判、卫星互联网产业信号 —— 全部来自 oaf.world 的公开只读 API。

零依赖、无需注册、无需密钥。

npx invesresearch quote NVDA

标的    US:NVDA
名称    NVIDIA Corporation · 英伟达
价格    206.84
涨跌%   -0.5529
币种    USD
总股本  24,221,000,000
数据源  yfinance
时间    2026-07-25T11:05:28Z

安装

不装也能用（推荐）：

npx invesresearch <命令>

想常驻就全局装，invesresearch 和短别名 ires 都可用：

npm install -g invesresearch
ires quote 0700.HK

要求 Node.js ≥ 18（用到内置 fetch）。

标的代码怎么写

四种写法都认，内部统一映射到后端 uid：

| 你输入 | 解析为 | 说明 | | --- | --- | --- | | NVDA brk.b | US:NVDA US:BRK.B | 美股，纯字母 | | 600519 | SH:600519 | A 股，6 开头 → 沪 | | 000001 300750 | SZ:000001 SZ:300750 | A 股，0/3 开头 → 深 | | 700 0700.HK 09988.HK | HK:00700 HK:00700 HK:09988 | 港股，自动补零到 5 位 | | 600519.SS 300750.SZ | SH:600519 SZ:300750 | Yahoo 后缀写法 | | US:NVDA SH:600519 | 原样 | 直接给 uid 也行 |

不知道代码就先搜：

npx invesresearch search 宁德

代码       名称      市场
SZ:300750  宁德时代  SZ
HK:03750   宁德时代  HK

命令

行情与基本面

| 命令 | 说明 | | --- | --- | | quote <代码> | 实时报价（价格/涨跌/总股本） | | search <关键词> [--limit N] | 全市场名称/代码模糊搜索 | | news <代码> [--limit N] [--zh] | 个股新闻，--zh 附中文标题翻译 | | financials <代码> [--period 2025A] [--cross-check] | 财务指标，可多源交叉校验 | | history <代码> [--years 5] [--quarter] | 历年（或历季）财务趋势 | | peers <代码> [--period 2025A] | 可比公司 PE/PB/PS | | profile <代码> [--period 2025A] | 公司画像 | | bars <代码> [--days 30] | 日线 K 线（--days 最小 5） | | indices | 主要指数行情 | | industries | 已覆盖的行业专题列表 | | industry <key> | 行业专题详情（成分股 + 财务聚合 + 产业链） | | pulse [key] | 行业异动预警，默认 satellite |

研究（模型生成，输出带免责声明）

| 命令 | 说明 | | --- | --- | | ask <问题…> | 对话式投研问答 | | thesis <代码> | 多空研判 + 护城河 | | compare <代码A> <代码B> […] [--cross-check] | 同口径多标的对比 |

npx invesresearch ask "英伟达的护城河在哪"
npx invesresearch compare NVDA AMD

卫星互联网产业 agent（只读）

| 命令 | 说明 | | --- | --- | | events [--limit N] [--thread 主线] | 产业事件流 | | alerts [--window 7] [--limit N] | 风险预警（含证伪触发器） | | weekly [--window 7] | 周度决策报告（markdown） | | companies [--thread 主线] | 产业链公司卡片 | | thesis-state | 各主线 thesis 实时评分 | | sources | 数据来源账本 |

全局选项

| 选项 | 说明 | | --- | --- | | --json, -j | 输出原始 JSON，可管道给 jq | | --api <url> | 覆盖行情 API 端点（默认 https://api.oaf.world，亦可用环境变量 IR_API_BASE） | | --agent <url> | 覆盖 agent 端点（默认 https://agent.oaf.world，亦可用 IR_AGENT_BASE） | | --timeout <ms> | 请求超时。默认 30s，研究类命令 180s | | --help, -h | 帮助 | | --version, -v | 版本 |

管道用法：

npx invesresearch quote 0700.HK --json | jq .price
npx invesresearch peers NVDA --json | jq -r '.rows[] | "\(.name)\t\(.pe)"'
npx invesresearch weekly > 周报.md

退出码：0 成功 · 1 请求失败（错误进 stderr，stdout 不产出任何数据）· 2 用法错误。

数据边界（诚实说明）

• 数字来自数据源，不由本工具计算。 CLI 只做参数映射与排版，任何指标、估值、涨跌都是后端返回的原值。
• 缺数显式降级。 取不到的字段一律显示 —，不会填 0、不会省略、更不会编。
• 搜索覆盖不对称。 A 股中文名可全量模糊搜；港股/美股认英文、拼音、代码，中文名只覆盖精选清单 —— 港美股搜不到时请改用代码。
• ask / thesis / compare 的叙述由模型生成，其中的数字仍来自确定性计算。输出末尾强制带免责声明。
• compare 默认不做多源交叉校验（实测 2 个标的开启后 >200s）。需要时加 --cross-check。
• 预警不命中就是不报警。 alerts / pulse 返回空表示规则未触发，不是故障。

隐私与凭证

本工具不接受、不读取、不存储任何 token 或密钥，也从不发送 Authorization 头 —— 目标接口本就是公开只读服务。除了你输入的查询参数，不会向任何第三方发送数据，也没有遥测。

免责声明

本工具输出仅供研究参考，不构成投资建议。投资有风险，决策需谨慎。

开发

npm test          # node --test，零 devDependencies

License

MIT（见 LICENSE）。注意：仓库其余部分是 Apache-2.0，本 CLI 单独采用更宽松的 MIT。