mcpField
F
financial-analysis-earnings-preview

financial-analysis-earnings-preview

github.com/pionex-official数据与数据库5106 次安装14 周前更新
代码仓库

关于 financial-analysis-earnings-preview

面向分析师和投资者的财报前瞻技能，结合 SEC EDGAR 历史财务数据与网络搜索的市场共识，并组织情景分析和催化因素检查。它规定了报告结构，也说明了数据限制。

主要功能

  1. 01搜索市场共识与财报日期
  2. 02整理 SEC EDGAR 历史趋势
  3. 03构建看涨、基准和看跌情景
  4. 04生成催化因素清单与报告
  5. 05由年初至今数据推算单季数据

适用场景

  1. 01准备美股公司的财报前瞻
  2. 02对照预期与历史业绩趋势
  3. 03整理财报前的风险和观察要点

安装

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

$npx skills add https://github.com/pionex-official/pionex-skills --skill financial-analysis-earnings-preview

安装后在 Claude Code 中输入/financial-analysis-earnings-preview确认已加载。

附带文件run.shscripts/get_fundamentals.py

详细介绍

财报预览

制作财报发布前预览，包含市场一致预期、历史趋势、情景分析和催化因素检查清单。使用 SEC EDGAR 获取历史财务数据，使用网页搜索获取市场一致预期和日期。

设置

无需安装依赖。所有脚本仅使用 Python 标准库。

工作流

步骤 1 — 查找财报日期和市场一致预期（网页搜索）

始终先搜索。不要依赖训练数据获取市场一致预期。

搜索 A — 财报日期：

  • [Company] [ticker] earnings date Q[X] FY[YYYY]
  • [Ticker] earnings release date when

搜索 B — 市场一致预期（与步骤 2 并行执行）：

  • [Company] Q[X] FY[YYYY] earnings preview consensus estimate revenue EPS
  • [Ticker] earnings estimates Wall Street expectations Q[X] FY[YYYY]

如果搜索 B 只返回含糊表述，没有明确的美元金额，请搜索：

  • [Ticker] Q[X] FY[YYYY] revenue estimate $B analyst consensus

继续前提取所有信息：

字段说明
财报日期具体日期；若无法获取，则标注“日期尚未确认”
报告的季度（例如 Q2 FY2026）明确的财季，不要写“下一季度”
营收一致预期必须是明确的美元金额（例如“$29.3B”）
调整后 EPS 一致预期必须是美元金额（例如“$2.18”）
先前业绩指引区间公司对该期间给出的指引
分析师关注主题2-3 项预期或担忧

确认财报日期在未来。 如果日期已过，则该季度的业绩已经公布——改为搜索下一个即将到来的日期。

步骤 2 — 获取历史趋势（脚本）

与搜索 B 并行执行：

bash run.sh <SYMBOL> --form 10-Q --periods 8
bash run.sh <SYMBOL> --form 10-K --periods 3

10-Q 数据是年初至今的累计数据。 通过相减推导单季度数据：

  • Q1 = Q1 年初至今
  • Q2 = 上半年年初至今 − Q1 年初至今
  • Q3 = 前 9 个月年初至今 − 上半年年初至今
  • Q4 = 全年（10-K）− 前 9 个月年初至今

必须以趋势表呈现（至少包含 4 个季度和 1 行预估）：

季度营收同比毛利率营业利润率摊薄 EPS
Q[X-3] FY[YYYY] A$X.XB+X%XX.X%XX.X%$X.XX
Q[X] FY[YYYY] E$X.XB(E)+X%E——$X.XX(E)

最后一行“Q[X] FY[YYYY] E”为步骤 1 获取的市场一致预期——将预估标记为“(E)”。

步骤 3 — 构建情景
看涨基准看跌
营收超出市场一致预期约 X%符合预期低于预期约 X%
调整后 EPS超出预期符合预期低于预期
毛利率较上年扩张持平收缩
关键驱动因素[业务板块] 上行稳健执行[风险] 走弱

以历史表现为基准：根据趋势表中的公司历史超预期/不及预期幅度，确定看涨和看跌情景的幅度。例如，如果该公司最近几个季度的营收超出市场一致预期约 10%（如 NVDA），看涨情景应采用约 8-12%，而不是通用的 2-4%。对于业绩持续稳定超预期约 1% 的成熟公司，可采用 1-3%。说明每种情景的主要触发因素。

步骤 4 — 催化因素检查清单

列出 3-5 个关注点：

[ ] Key question (e.g. "Does [segment] revenue accelerate above X%?")
    Why it matters: [1-2 sentences]
    What to look for: [specific metric or commentary]

重点关注：关键业务板块偏差、利润率走势、未来业绩指引、上一季度的风险。

输出格式

标题框（必需，始终置于最前）：

[COMPANY] ([TICKER]) — Q[X] FY[YYYY] EARNINGS PREVIEW
Earnings date: [exact date or "TBC"]

Consensus:   Revenue $X.XB (+X% YoY)  |  Adj. EPS $X.XX (+X% YoY)
Prior guidance: [range or "not provided"]
Source: [source name, retrieved YYYY-MM-DD]

第 1 节 — 趋势表（必需，至少包含 4 个季度和 1 行预估）

第 2 节 — 趋势解读（3-5 句话）

第 3 节 — 华尔街预期

第 4 节 — 情景分析（看涨 / 基准 / 看跌表格）

第 5 节 — 催化因素检查清单（3-5 个关注点）

格式规则

  • 营收 / 利润：使用 B 或 M，例如“$29.3B”
  • 利润率：保留一位小数，例如“48.2%”
  • EPS：保留两位小数，例如“$2.18”
  • 增长率：保留一位小数，例如“+12.4% YoY”

限制

  • 没有实时共识数据：估值来自网络搜索——请始终注明来源和日期
  • SEC EDGAR 存在延迟：申报数据可能不包含最近一个季度的数据
  • 10-Q 是年初至今的累计数据：计算单个季度的数据时，请始终减去之前各期的数据
  • 仅限美国股票：SEC EDGAR 仅涵盖在美国上市的股票

评论

支持 Markdown