mcpField
T
trader-news

trader-news

github.com/jakeschincariol生产力90750 次安装2 周前更新
代码仓库

关于 trader-news

trader-news 是一款 Python 技能,可检查投资组合或指定股票的新闻标题和 SEC 文件。它会记录已展示的内容,便于整理带来源链接的简报,不预测股价走势,也不依据新闻交易。

主要功能

  1. 01Yahoo Finance 新闻源
  2. 02检查 SEC 文件
  3. 03保留 30 天已展示记录
  4. 04按股票与主题标记
  5. 05支持 JSON 和试运行输出

适用场景

  1. 01查看持仓股票的新消息
  2. 02检查指定类型的 SEC 文件
  3. 03优先查看财报、法律与风险事项
  4. 04整理带来源链接的投资组合简报

安装

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

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

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

附带文件news.py

详细介绍

trader-news

你持有的头寸可能在一分钟内发生变化:业绩未达预期、CEO 离职、诉讼、财务重述。此技能会读取每只股票最先发布此类消息的两个信息源,并只告诉你有哪些新消息。

此文件夹中的工具(使用 Python 标准库,无需密钥):

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

读取和写入的内容

  • 你的股票代码:使用 --tickers 指定;否则读取 trader/portfolio.json 中的头寸;若无,则读取 trader/targets.json 中的权重(因此可在运行 /trader-copycat 后立即使用)。
  • 标题:Yahoo Finance 的公开标题 RSS,每只股票代码对应一个信息源(https://feeds.finance.yahoo.com/rss/2.0/headline?s=AAPL&region=US&lang=en-US)。
  • 申报文件:SEC EDGAR 的公司 Atom 信息源,默认读取 8-K(如需更多,可使用 --forms 8-K,10-Q)。需要在 trader/config.json(sec_user_agent)或 SEC_USER_AGENT 中设置 SEC User-Agent。未设置时会跳过申报文件并给出提示,但仍会读取标题。
  • 写入 trader/state/news.json:已展示的内容(保留 30 天)以及每个股票代码对应的 CIK,确保每条内容只出现一次。

规则

  • 标题是线索,不是事实。 告诉用户某事发生之前,先打开报道或申报文件并阅读。引用来源并附上链接。不要概述无法阅读的付费墙内容:请说明内容需要付费才能查看。
  • 申报文件优先于标题。 如果 8-K 与某条标题不一致,以公司提交给 SEC 的 8-K 为准。
  • 说明影响范围。 每条内容都会列出其涉及的股票代码(包括发布该内容的信息源对应的股票代码,以及内容提及的你的股票代码或公司名称)和标签(earnings、analyst、legal、deal、capital、people、risk)。标有 ! 的申报文件包含重要的 8-K 内容:业绩结果(2.02)、高管变动(5.02)、资产减值(2.06)、退市通知(3.01)、不再可靠的过往财务信息(4.02)、破产(1.03)或网络安全事件(1.05)。
  • 不做预测。 报告已发布的内容。绝不预测股票接下来会如何表现。

步骤

  1. 运行检查:

    python3 "${CLAUDE_SKILL_DIR}/news.py"
    python3 "${CLAUDE_SKILL_DIR}/news.py" --tickers AAPL AXP GOOGL KO BAC --hours 24
    

    退出代码 1 表示没有新内容。--all 会显示已看过的内容,--json 会以机器可读格式输出全部内容,--dry-run 则不会更改状态。

  2. 阅读重要内容:每份标有 ! 的申报文件、每条带有 earnings、legal 或 risk 标签的内容,以及优先涉及最大头寸的内容。

  3. 撰写简短摘要:按股票代码说明发生了什么、来源和链接,并用一句话说明该消息为何与此投资组合相关(注明其在 trader/targets.json 或 trader/portfolio.json 中的权重)。

  4. 如果某条消息可能改变计划(例如 8-K 4.02 财务重述或退市通知),请说明,并建议使用 /trader-analyst 分析数据,或使用 /trader-risk 重新检查待处理订单。绝不要只凭标题采取行动。

若要定时运行,可在交易时段使用 /loop 30m /trader-news,或设置每天早上的定时任务。

示例:reel 的投资组合

用户复制了 Berkshire 的前 5 大持仓(AAPL、AXP、GOOGL、KO、BAC)。2026-10-13 星期二,检查首先显示了 Apple 的标题(“Apple 推出 HomeView 智能家居中枢及其他设备”、“法官命令 OpenAI 在 Apple 商业机密案中提交招聘记录”,标记为 legal)、Coca-Cola 的股息相关报道,以及 SEC 的申报文件:Apple 于 2026-07-30 提交的 8-K(条目 2.02,业绩结果)和 Coca-Cola 于 2026-07-28 提交的 8-K(2.02)。摘要:“Apple(你的最大头寸,占 30.7%)推出了售价 $299 的智能家居中枢;其针对 OpenAI 的商业机密案中出现了一项法院裁决。本周,你持有的五家公司没有新申报文件。” 如果某个股票代码没有相关新闻,应如实说明,不要为了凑内容而扩写摘要。

它绝不会做的事

  • 绝不编造或夸大报道、引语或数字。
  • 绝不根据新闻进行交易,也绝不因某条标题而建议用户买入或卖出。
  • 绝不给服务发送过多请求:每只股票代码对应的每个信息源仅请求一次,SEC 调用之间会暂停,并且与 SEC 每秒 10 次的请求上限保持足够距离。

安全

本技能用于教育和提供工具,并非财务建议。它只读取和报告信息。只有在 /trader-risk 检查通过后,且用户明确输入 yes 确认该订单,/trader-broker 才会下单。

评论

支持 Markdown