用途:从 Yahoo Finance 抓取基本面财务数据,用于财务分析、价值股筛选与公司财务健康度评估。
主要能力:
- 基本面数据查询:uv run python scripts/fundamentals.py SYMBOL [--type TYPE]。SYMBOL 为股票代码;--type 可选 all、financials、earnings、info,默认 all。返回 JSON,包含 info(市值、市盈率、每股收益、股息等关键指标)、financials(近期季度/年度利润表数据)、earnings(历史与预估盈利)。
- Piotroski F-Score:uv run python scripts/piotroski.py SYMBOL。基于 9 项标准评分,每项通过得 1 分,满分 9 分。标准包括:净利润为正、ROA 为正、经营现金流为正、现金流大于净利润、长期负债下降、流动比率上升、未增发新股、毛利率上升、资产周转率上升。评分解读:8-9 优秀,6-7 良好,4-5 一般,0-3 较弱。返回 JSON 含 score、max_score、criteria(各项通过状态与数值)、interpretation、data_available。
实现细节:标准 1-4 使用最近一年季度财务数据;标准 5-9 使用年度数据做同比比较,比较最近财年与上一财年。
使用方式:若未安装 uv 或找不到 pyproject.toml,将命令中的 uv run python 替换为 python。依赖 pandas 与 yfinance。所有时间戳与基于时间的计算须使用 America/New_York 时区,JSON 输出须包含 generated_at(纽约时间字符串)与 data_delay 字段。
适用场景:评估基本面财务实力、筛选基本面改善的价值股、判断财务健康趋势、跨公司比较财务强度、寻找基本面强但估值偏低的公司。
限制:数据来自 Yahoo Finance,可能存在延迟;Piotroski 标准 5-9 需年度同比数据,若缺失则 data_available 为 false。