mcpField
F
fundamentals

fundamentals

github.com/staskh数据与数据库394179 次安装1 天前更新
代码仓库

关于 fundamentals

fundamentals 是一项命令行技能,可获取 Yahoo Finance 公司数据并计算 Piotroski F-Score,面向股票基本面分析。它结合财务报表、盈利数据、公司指标及基于九项标准的财务实力评估。

主要功能

  1. 01获取公司指标和财务报表
  2. 02检索历史及预估盈利数据
  3. 03计算 Piotroski F-Score
  4. 04展示各项标准结果和解读
  5. 05标注纽约生成时间和数据延迟

适用场景

  1. 01查看公司的基本面数据
  2. 02筛选基本面改善的股票
  3. 03比较不同公司的财务实力
  4. 04评估同比财务健康状况

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/staskh/trading_skills --skill fundamentals

安装后在 Claude Code 中输入/fundamentals确认已加载。

附带文件scripts/fundamentals.pyscripts/piotroski.py

详细介绍

基本面

从 Yahoo Finance 获取基本面财务数据。

说明

**注意:**如果未安装 uv 或未找到 pyproject.toml,请在下方所有命令中将 uv run python 替换为 python。

uv run python scripts/fundamentals.py SYMBOL [--type TYPE]

参数

  • SYMBOL - 股票代码
  • --type - 数据类型:all、financials、earnings、info(默认:all)

输出

返回包含以下内容的 JSON:

  • info - 关键指标(市值、市盈率、每股收益、股息等)
  • financials - 近期季度/年度损益表数据
  • earnings - 历史和预估收益

清晰呈现关键指标。必要时比较实际收益与预估收益。


Piotroski F-Score

使用 9 项基本面标准计算 Piotroski F-Score,以评估公司的财务实力。

说明
uv run python scripts/piotroski.py SYMBOL
什么是 Piotroski F-Score?

Piotroski F-Score 是由 Joseph Piotroski 开发的一种基本面分析工具,通过 9 项标准评估公司的财务实力。每项标准通过得 1 分,未通过得 0 分,最高得分为 9 分。

9 项标准
  1. 净利润为正 - 公司实现盈利
  2. ROA 为正 - 资产能够产生回报
  3. 经营现金流为正 - 公司通过经营活动产生现金
  4. 现金流 > 净利润 - 盈利质量高(现金流超过会计利润)
  5. 长期债务减少 - 杠杆率下降(财务状况改善)
  6. 流动比率提高 - 流动性改善
  7. 未发行新股 - 没有股权稀释(或进行了股票回购)
  8. 毛利率提高 - 盈利效率改善
  9. 资产周转率提高 - 资产使用效率更高
分数解读
  • **8-9:**优秀 - 财务状况非常稳健
  • **6-7:**良好 - 财务状况稳健
  • **4-5:**一般 - 财务状况中等
  • **0-3:**较差 - 财务状况薄弱
输出

返回包含以下内容的 JSON:

  • score - F-Score(0-9)
  • max_score - 最高可能得分(9)
  • criteria - 各项标准的详细结果,包括通过/未通过状态和数值
  • interpretation - 对财务状况等级的文字描述
  • data_available - 布尔值,表示是否有用于第 5-9 项标准同比比较的数据
实现细节
  • 第 1-4 项标准使用季度财务数据(最近一年)
  • 第 5-9 项标准使用年度财务数据进行同比比较
  • 比较最近一个财年与前一个财年
使用场景

以下情况可使用 Piotroski F-Score:

  • 评估基本面财务实力
  • 筛选基本面不断改善的价值股
  • 评估财务状况趋势
  • 比较不同公司的财务实力
  • 识别基本面稳健但价格被低估的公司

依赖项

  • pandas
  • yfinance

时区

所有时间戳和基于时间的计算都必须使用 America/New_York 时区。所有 JSON 输出都必须包含 generated_at(纽约时间字符串)和 data_delay 字段。

评论

支持 Markdown