核心用法
stock-fundamentals 是一款本地执行的股票基本面分析工具,基于 yfinance 库从 Yahoo Finance 获取数据。用户通过 uv run 命令直接运行 Python 脚本,无需手动配置虚拟环境或安装依赖,系统会自动解析脚本头部的依赖声明并完成隔离环境的构建。
使用场景
- 需要快速获取某只股票的完整基本面画像
- 对比多维度指标(P/E、ROE、负债率、分析师目标价等)
- 初步筛选投资标的或验证估值假设
典型命令
uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py AAPL
支持全球多市场股票代码,包括美股(AAPL)、德股(RHM.DE)、英股(SHEL.L)、日股(7203.T)等,以及加密货币(BTC-USD)。
显著优点
1. 零配置启动:uv run 自动处理依赖,用户无需关心 Python 环境
2. 数据维度全面:覆盖估值、盈利能力、成长性、财务健康、股东回报、市场预期六大模块
3. 智能生成摘要:自动输出「Fundamental Highlights」叙事总结和「Potential Watch Items」风险标记
4. 多市场兼容:支持 10+ 交易所的后缀格式
5. 离线友好:本地执行,不依赖外部 API 密钥配额
潜在局限
- 数据源单一:完全依赖 Yahoo Finance,存在数据延迟、缺失或调整风险
- 非实时数据:财务数据基于季度/年度报告,非日内更新
- 无历史对比:不提供多季度趋势图表或同业对标功能
- ETF 支持有限:基金类产品基本面字段可能缺失
- 无深度分析:仅输出原始指标,不含 DCF 模型或情景测算
适合人群
- 需要快速基本面快照的个人投资者
- 进行初筛阶段的量化研究者
- 对估值指标敏感的价值投资者
- 不愿维护 Python 环境的轻度技术用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据准确性 | Yahoo Finance 数据未经审计,可能与公司财报存在差异 |
| 时效性 | 季度数据更新滞后,重大事件(并购、重组)可能未反映 |
| 市场覆盖 | 小盘股、OTC 市场数据质量不稳定 |
| 工具依赖 | 依赖 `uv` 和 `yfinance` 的维护状态,版本更新可能引入 breaking change |
| 投资决策 | 基本面指标仅为参考,不构成买卖建议 |