mcpField
T
trader-analyst

trader-analyst

github.com/jakeschincariol数据与数据库90751 次安装2 周前更新
代码仓库

关于 trader-analyst

trader-analyst 是面向投资者和分析师的 Python 技能，用于逐季比较公司向 SEC 提交的数据，并标注推算值、数据滞后和异常项目。它以申报的 XBRL 数据为主，并用业绩新闻稿补充背景。

主要功能

  1. 01逐季比较 SEC 申报数据
  2. 02汇总 TTM 营收、净收入和 EPS
  3. 03推算第四季度数据
  4. 04提示申报滞后和一次性项目

适用场景

  1. 01查看公司的最新业绩
  2. 02将增长与去年同期比较
  3. 03生成公司筛选所需指标

安装

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

$npx skills add https://github.com/jakeschincariol/trader-skill --skill trader-analyst

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

附带文件facts.pymetrics.example.json

详细介绍

trader-analyst

财报季会影响股价，而新闻稿总会把最好的数字放在最前面。此技能会读取公司实际向 SEC 提交的数据，按季度排列，并直截了当地说明发生了哪些变化。

此文件夹中的工具（使用 Python 标准库，无需密钥）：

python3 "${CLAUDE_SKILL_DIR}/facts.py" --help

它需要 SEC User-Agent（trader/config.json 中的 sec_user_agent，或 SEC_USER_AGENT）："Your Name [email protected]"，其中应填写用户的真实姓名和邮箱。没有该信息时，它会拒绝调用 SEC。

读取和写入的内容

  • 读取 https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json（公司在申报文件中标记的每个数字）、公司的申报列表（用于查找最新的 10-Q 或 10-K，以及最新的、包含项目 2.02“经营业绩”的 8-K），以及该 8-K 的文件夹，以找到新闻稿（EX-99.1 附件）。
  • 使用 --metrics 时，会将数据写入 trader/metrics.json：每家公司一行（TTM 营收、净利润和稀释后 EPS，以及最新的利润率和增长数据），供 /trader-screener 使用。此文件夹中的 metrics.example.json 是 2026-10-13 对 AAPL、AXP、GOOGL、KO 和 BAC 执行的真实结果。

规则

  • 优先采用已申报数字。 表格数据来自公司申报的 XBRL 事实。新闻稿用于了解背景（业绩指引、分部情况），并说明数字的来源。
  • 确保比较口径一致。 增长数据与一年前的同一季度比较。也会显示环比变化，但许多企业有季节性（Apple 的 12 月季度一直是其业绩最好的季度）。
  • 说明哪些数据是推算得出的。 公司不会提交 Q4 10-Q。第四季度数据由 10-K 全年数据减去其中三个季度的数据得出，并标记为“derived”；推算出的 EPS 是近似值。
  • 说明数据何时滞后。 SEC 的 facts API 可能晚于申报文件更新。如果最新的 10-Q 日期晚于 facts 中的最新季度，工具会输出一条带链接的 NOTE：请先阅读 10-Q 本身，再进行总结。
  • 标记一次性项目。 净利润高于营业利润时，说明其中包含业务之外的收益（投资估值变动、税务项目）。工具会对此作出说明。银行和保险公司没有毛利率：留空，不填零。

步骤

  1. 对相关公司运行工具（或运行 trader/targets.json 中的所有股票代码）：

    python3 "${CLAUDE_SKILL_DIR}/facts.py" AAPL
python3 "${CLAUDE_SKILL_DIR}/facts.py" AAPL AXP GOOGL KO BAC --metrics trader/metrics.json

    --quarters 8 显示两年数据，--json 输出全部机器可读数据，--cik 用于没有股票代码的公司。

  2. 打开最新的财报新闻稿（EX-99 链接）和 10-Q，在需要了解数字背景时阅读这些文件。

  3. 撰写摘要：用一行说明本季度情况（营收、EPS、增长），一行说明利润率，一行说明任何异常情况（一次性项目、推算季度、滞后数据），并附上链接。用语平实，列出真实数字，不使用数字无法支持的形容词。

示例：组合中持仓最多的股票

facts.py AAPL（2026-10-13）：截至 2026-06-27 的季度（2026 财年 Q3），营收为 $109.42B，较一年前增长 16.4%；净利润为 $29.79B（增长 27.1%），稀释后 EPS 为 $2.02（增长 28.7%）；毛利率为 50.1%（较上一季度上升 0.8 个百分点）；最近四个季度营收为 $466.8B，EPS 为 $8.71。新闻稿：2026-07-30 提交的 8-K 中的 EX-99.1。对于 Coca-Cola，工具会提示 SEC facts 的数据截至 2026-04-03，而 2026-07-03 的 10-Q 已经提交，因此摘要会直接依据该 10-Q 撰写。

它绝不会做的事

  • 绝不判断某只股票便宜、昂贵、值得买入或应该卖出，只报告公司提交的数据。
  • 绝不编造申报文件中没有的数字，也不估算无法推算的季度数据。
  • 绝不在缺少 User-Agent 时调用 SEC，并且请求频率远低于每秒 10 次。

安全

仅用于教育和工具辅助，不构成财务建议。此技能只读取申报文件。只有在 /trader-risk 检查通过且用户明确输入确认下单后，/trader-broker 才会下单。

评论

支持 Markdown