SuperAPI AI 工具集

trader-news

数据与分析

查看项目

更新于 10-17 13:24

技能介绍

trader-news 是一个用标准库 Python 编写的市场新闻与 SEC 文件监控工具,属于 jakeschincariol/trader-skill 技能集。它的目标是针对用户持有的股票(或即将复制的组合),从两个信息源中只挑出自上次检查后新增的内容,避免重复播报。

主要能力

  1. 标题抓取:按每只股票读取 Yahoo Finance 公开标题 RSS(https://feeds.finance.yahoo.com/rss/2.0/headline?s=AAPL&region=US&lang=en-US)。
  2. 文件抓取:读取 SEC EDGAR 公司 Atom 订阅,默认 8-K,可通过 --forms 8-K,10-Q 扩展。需提供 SEC User-Agent(trader/config.json 的 sec_user_agent 或 SEC_USER_AGENT 环境变量),缺少时跳过文件并给出提示,标题仍照常运行。
  3. 去重与状态:将已展示内容(保留 30 天)及各股票 CIK 写入 trader/state/news.json,保证每条信息只出现一次。
  4. 股票来源:优先 --tickers,其次 trader/portfolio.json 的持仓,再次 trader/targets.json 的权重,因此可在 /trader-copycat 之后直接使用。
  5. 标注:每条信息列出涉及的股票代码与标签(earnings、analyst、legal、deal、capital、people、risk);带 ! 的文件表示重要 8-K 事项,如业绩(2.02)、高管变动(5.02)、减值(2.06)、退市通知(3.01)、过往财报不再可靠(4.02)、破产(1.03)或网络安全事件(1.05)。

使用方式 查看帮助: python3 "${CLAUDE_SKILL_DIR}/news.py" --help 运行检查: 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 不修改状态。可按计划运行,例如交易时段内 /loop 30m /trader-news,或每天早晨的定时任务。

使用规则与限制 标题只是线索而非事实:告知用户前应打开报道或文件阅读,引用来源并附链接;无法阅读的付费报道明确说明是付费墙。文件优先于标题:8-K 与标题冲突时以 8-K 为准。不预测股价走势,不因标题建议买卖。当某只股票没有新闻时应如实说明,不填充内容。不做创作或夸大,不频繁请求服务器(每只股票每个源一次请求,SEC 调用间有停顿,远低于每秒 10 次限制)。该技能仅阅读和报告,不执行交易;下单只能通过 /trader-broker,且需 /trader-risk 通过并由用户明确确认。本工具是教育与工具用途,不构成财务建议。