核心用法
stock-fundamentals 是一个本地运行的 Python 脚本工具,通过 uv run 命令直接调用,无需手动配置虚拟环境或安装依赖。用户只需提供股票代码(如 AAPL、TSLA、RHM.DE),即可获取涵盖九大维度的结构化基本面报告。
主要功能模块
| 维度 | 覆盖指标 |
|------|---------|
| 估值 | P/E(动态/静态)、PEG、P/S、P/B、EV/EBITDA |
| 盈利能力 | 毛利率、营业利润率、净利率、ROE、ROA |
| 成长性 | 营收同比、盈利同比 |
| 财务健康 | 现金、债务、D/E、流动比率 |
| 股东回报 | 股息率、派息率 |
| 市场预期 | 分析师目标价、评级、下次财报日 |
使用示例
# 美股 uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py NVDA # 欧股(需加市场后缀) uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py ASML.AS
显著优点
1. 零配置启动:uv run 自动解析内联依赖块,隔离安装 yfinance,无需 pip 或 venv 手动操作
2. 全球多市场支持:覆盖美股、欧股(德/英/荷)、日股、韩股及加密货币,通过标准后缀区分市场
3. 结构化输出:自动生成叙述性摘要(Fundamental Highlights)和风险预警(Potential Watch Items),降低解读门槛
4. 离线友好:本地脚本执行,不依赖外部 API 密钥,适合受限网络环境
潜在缺点与局限性
| 问题 | 说明 |
|------|------|
| 数据源单一 | 完全依赖 Yahoo Finance,数据延迟约 15-30 分钟,极端行情下可能出现缺失 |
| 无历史对比 | 仅提供当前快照,不支持多期趋势分析或同业横向对比 |
| 有限市场深度 | 新兴市场、小盘股或粉单市场数据覆盖不完整 |
| 分析师数据质量 | 目标价和评级来自卖方汇总,可能存在乐观偏差或滞后 |
| ETF 支持有限 | 文档明确提示 ETF 基本面数据可用性受限 |
适合人群
- 个人投资者:需要快速获取标准化基本面快照,辅助买卖决策
- 分析师/研究员:初步筛选标的时的第一道工序,替代手动查数
- 教育场景:学习财务比率计算和解读的实操工具
常规风险
- 数据可靠性:Yahoo Finance 免费数据未经审计,关键决策需交叉验证交易所官方披露
- 市场后缀误用:不同交易所代码冲突(如
BABAvs9988.HK),需严格参照格式表 - 非实时性:基本面数据按季度更新,无法捕捉突发业绩预警
- 无投资建议:自动生成的 Highlights 和 Watch Items 为规则化输出,不构成投资推荐