mcpField
T
trader-analyst

trader-analyst

github.com/jakeschincariol数据与数据库2.6k110 次安装1 周前更新
代码仓库

关于 trader-analyst

trader-analyst 是用于查看公司申报和财报数据的 Python Skill，适合评估近期业绩及即将发布的报告。它按季度比较 SEC 数据，并标明推导数据或可能的延迟。

主要功能

  1. 01读取公司事实数据和 SEC 提交记录
  2. 02比较季度营收、净收入和 EPS
  3. 03报告利润率与增长指标
  4. 04标记推导季度和数据延迟
  5. 05将公司指标写入 JSON

适用场景

  1. 01交易前查看公司最新申报季度
  2. 02比较多个季度的业绩
  3. 03确认即将发布的报告是否落在计划持仓期间

安装

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

$npx skills add https://github.com/jakeschincariol/day-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，以及最新的利润率和增长数据），供你记笔记或导入电子表格。本文件夹中的 metrics.example.json 是 2026-10-13 针对 AAPL、AXP、GOOGL、KO 和 BAC 的真实运行结果。
  • 财报电话会议：该工具不会获取文字记录。如果用户粘贴了文字记录（或公司的 IR 页面上有），请阅读并总结管理层提到的变化：业绩指引、利润率、需求，以及他们拒绝回答的问题。
  • SEC 数据中没有下一次财报日期。请在 /trader-news 标题或公司的投资者关系页面中查找，并说明日期来源。

规则

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

步骤

  1. 针对相关公司运行工具（或使用 trader/watchlist.json 中的股票代码）：

    python3 "${CLAUDE_SKILL_DIR}/facts.py" TSLA
python3 "${CLAUDE_SKILL_DIR}/facts.py" TSLA NVDA AMD --metrics trader/metrics.json

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

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

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

  4. 如果下一次财报会在计划交易期间发布（例如隔夜持仓，或开盘前发布财报），请在 /trader-exit 设置止损前说明：止损无法防范跳空，股价可能会以低于止损价的价格开盘。

示例：这只股票的财务状况

facts.py TSLA（运行日期：2026-10-20）：截至 2026-06-30 的季度（2026 年第 2 季度）， 营收为 282.4 亿美元，较上年同期增长 25.5%；净利润为 11.1 亿美元（下降 4.9%）， 摊薄后每股收益为 0.32 美元（下降 3.0%）；最近四个季度的营收为 1,036 亿美元， 每股收益为 1.08 美元。工具指出，净利润高于营业利润，说明其中包含了 业务以外的收益。最新的 10-Q 于 2026-07-23 提交。周一的新闻标题称，特斯拉本周将发布财报， 因此摘要最后写道：“距离下一份财报发布只剩几天。收盘前平仓的日内交易不会受到影响； 任何隔夜持仓则会受到影响。”

facts.py AAPL（2026-10-13）：营收为 1,094.2 亿美元，较上年同期增长 16.4%；摊薄后每股收益为 2.02 美元（增长 28.7%）。对于 Coca-Cola，工具注意到 SEC 的财务数据 截至 2026-04-03，而截至 2026-07-03 的 10-Q 已经提交，因此摘要直接读取了这份 10-Q。

它绝不会做什么

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

安全

用于教育和工具支持，不构成财务建议。此技能只读取文件。 除非 /trader-risk 检查通过，且用户明确输入“是”确认该笔订单，否则不会有任何操作下单；唯一会下单的是 /trader-broker。

评论

支持 Markdown