- name
- finnhub-pro
- description
- Finnhub 美股金融数据 CLI。实时报价、公司档案、新闻、分析师推荐、内部人交易、盈利日历、基本面财务、同行比较。Python 脚本封装，免费层 60 次/分钟。Use when: 查股价、查公司信息、看最新新闻、了解内部人是否在买卖、查看近期财报日期。NOT for: K线数据、目标价、情绪分析（需付费层）。
- version
- 1.0.0
Finnhub Pro — 美股金融数据 CLI
Python CLI 封装 Finnhub API，聚焦免费层实际可用的 10 个功能。
安装
pip install finnhub-pythonAPI Key
- 去 finnhub.io 注册获取免费 API Key
- 设置环境变量：
export FINNHUB_API_KEY="your-key-here" - 或写入
~/.openclaw/.env
⚠️ 脚本不硬编码 Key，必须通过环境变量 FINNHUB_API_KEY 传入！
使用方法
# 基础格式
FINNHUB_API_KEY="your-key" python3 scripts/finnhub_cli.py <command> [args] [--json] [--limit N]
# 推荐：设好环境变量后直接用
python3 scripts/finnhub_cli.py quote AAPL免费层支持的命令（10 个）
实时报价
python3 scripts/finnhub_cli.py quote AAPL
python3 scripts/finnhub_cli.py quote NVDA --json # 原始 JSON公司档案
python3 scripts/finnhub_cli.py profile AAPL公司新闻（最近 7 天）
python3 scripts/finnhub_cli.py news NVDA
python3 scripts/finnhub_cli.py news AAPL --from 2026-02-01 --to 2026-02-21 --limit 5分析师推荐趋势
python3 scripts/finnhub_cli.py recommend NVDA内部人交易记录（最近 90 天）
python3 scripts/finnhub_cli.py insiders AAPL
python3 scripts/finnhub_cli.py insiders NVDA --from 2026-01-01 --to 2026-02-21盈利日历（未来 30 天）
python3 scripts/finnhub_cli.py earnings # 所有股票
python3 scripts/finnhub_cli.py earnings NVDA # 指定股票
python3 scripts/finnhub_cli.py earnings --from 2026-02-21 --to 2026-03-07基本面财务指标
python3 scripts/finnhub_cli.py financials AAPL
python3 scripts/finnhub_cli.py financials NVDA --json # 全部指标市场状态
python3 scripts/finnhub_cli.py market # 默认美国
python3 scripts/finnhub_cli.py market NYSE同行公司
python3 scripts/finnhub_cli.py peers AAPL股票代码搜索
python3 scripts/finnhub_cli.py search "apple"不可用功能（付费层）
- K 线数据（
stock_candles） - 分析师目标价（
price_target） - 新闻情绪分析（
news_sentiment）
限制
- 免费层：60 次/分钟
- 403 = 需付费升级
- 429 = 触发限速
依赖
- Python 3.10+
finnhub-python（pip install finnhub-python）