核心用法
Finnhub Pro 是一个 Python CLI 封装工具，将 Finnhub API 的免费层功能打包为命令行接口。用户需先注册获取 API Key 并通过环境变量 FINNHUB_API_KEY 传入，不支持硬编码密钥。
主要功能模块（10 项免费功能）：
- 实时报价：
quote <ticker>获取最新股价、涨跌额、成交量 - 公司档案：
profile <ticker>查看公司行业、市值、官网等元信息 - 公司新闻：
news <ticker>获取最近 7 天新闻，支持日期筛选和数量限制 - 分析师推荐趋势：
recommend <ticker>查看买入/持有/卖出评级分布 - 内部人交易记录：
insiders <ticker>追踪高管和大股东最近 90 天交易动向 - 盈利日历：
earnings [ticker]查询未来 30 天财报发布日期 - 基本面财务指标：
financials <ticker>获取收入、利润、资产负债等核心数据 - 市场状态：
market [exchange]查看交易所开盘/休市状态 - 同行公司：
peers <ticker>列出同行业竞争对手 - 股票代码搜索：
search <keyword>模糊匹配 ticker
输出格式：默认表格化展示，加 --json 可获取原始 API 响应便于二次处理。
显著优点
1. 零成本入门：完全基于 Finnhub 免费层，无需订阅费用即可获取机构级金融数据
2. 命令行效率：适合量化研究员、开发者集成到自动化工作流，比网页查询快 10 倍以上
3. 内部人交易特色功能：免费层罕见提供高管交易追踪，对价值投资者判断管理层信心极具参考价值
4. 数据覆盖面广：美股全市场覆盖，包含纳斯达克、NYSE、AMEX 三大交易所
5. Python 原生：依赖单一官方 SDK（finnhub-python），无复杂第三方依赖链
潜在缺点与局限性
1. 严格速率限制：60 次/分钟对批量扫描场景捉襟见肘，监控多只股票时易触发 429 错误
2. 关键功能缺失：K 线数据、分析师目标价、新闻情绪分析等核心量化功能需付费升级（月费 $25-75）
3. 无历史深度：免费层新闻仅 7 天、内部人交易仅 90 天，无法做长期回溯分析
4. 美股单一市场：不支持 A 股、港股等其他市场，地域局限性明显
5. CLI 门槛：非技术用户需要配置 Python 环境和环境变量，使用门槛高于网页工具
适合人群
- 个人价值投资者：快速查价 + 监控内部人交易信号
- 量化研究员：作为数据管道原型验证，正式生产需评估付费升级
- 财经自媒体：批量获取公司档案和新闻素材
- Python 开发者：需要金融数据 CLI 工具集成到 CI/CD 或自动化脚本
常规风险
1. API Key 泄露风险：脚本强制要求环境变量传入，但用户可能误将 Key 写入代码仓库或 shell 历史记录，建议配合 direnv 或 1Password CLI 管理密钥
2. 数据延迟风险：免费层报价延迟约 1-15 分钟（非实时），不适合高频交易决策
3. 服务稳定性风险：Finnhub 为第三方数据聚合商，非交易所官方数据源，极端行情下可能存在数据中断
4. 合规边界：内部人交易数据仅供信息参考，不构成投资建议，需遵守 SEC Reg FD 信息披露规则
5. 速率超限惩罚：频繁触发 429 可能导致临时 IP 封禁，建议实现指数退避重试机制