mcpField
T
trader-news

trader-news

github.com/jakeschincariol生産性90750 回インストール2 週間前に更新
リポジトリ

trader-news について

trader-newsは、ポートフォリオまたは指定銘柄のニュース見出しとSEC提出書類を確認するPythonスキルです。既出項目を記録し、株価を予測したりニュースに基づいて取引したりせず、出典リンク付きの要約作成を支援します。

主な機能

  1. 01Yahoo Financeの見出しフィード
  2. 02SEC提出書類の確認
  3. 03既出項目を30日間記録
  4. 04銘柄とトピックのタグ付け
  5. 05JSONとドライラン出力

活用シーン

  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の退任、訴訟、財務諸表の訂正などにより、わずか1分で状況が変わることがあります。このスキルは、保有銘柄ごとにそうした情報をいち早く伝える2つのフィードを読み、新しい情報だけをお知らせします。

このフォルダー内のツール(Python標準ライブラリを使用、キー不要):

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

読み取る内容と書き込む内容

  • 対象ティッカー:--tickers、指定がなければtrader/portfolio.jsonのポジション、それもなければtrader/targets.jsonのウェイトを使用します(/trader-copycatの直後でも動作します)。
  • ヘッドライン:Yahoo Financeの公開ヘッドラインRSS。ティッカーごとに1つのフィードを読み取ります(https://feeds.finance.yahoo.com/rss/2.0/headline?s=AAPL&region=US&lang=en-US)。
  • SEC提出書類: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. 簡潔な概要を作成します。ティッカーごとに、何が起きたか、出典とリンク、ポートフォリオにとって重要な理由を1行で記載します(ウェイトはtrader/targets.jsonまたはtrader/portfolio.jsonから取得します)。

  4. あるニュースによって計画が変わる可能性がある場合(8-Kの4.02による財務諸表の訂正、上場廃止の通知など)は、その旨を伝え、数値の確認には/trader-analyst、未決済注文の再確認には/trader-riskを提案します。ヘッドラインだけを根拠に行動してはいけません。

スケジュールに沿って実行するには、市場時間中に/loop 30m /trader-newsを使うか、毎朝の定期タスクを設定します。

例:リールのポートフォリオ

ユーザーはBerkshireの上位5銘柄(AAPL、AXP、GOOGL、KO、BAC)をコピーしました。2026-10-13(火)のチェックでは、まずAppleのヘッドライン(「Apple Introduces HomeView Smart Home Hub, Other Gadgets」、「Judge orders OpenAI to turn over hiring records in Apple trade secrets case」。後者には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との企業秘密訴訟で裁判所の判断が出ました。今週、保有する5社から新たな提出書類はありません。」ティッカーにニュースがない場合は、概要を水増しせず、ニュースがないと伝えてください。

決して行わないこと

  • ニュース、引用、数値を捏造したり、誇張したりしません。
  • ニュースを根拠に取引を行わず、ヘッドラインを理由にユーザーへ購入や売却を勧めません。
  • サーバーに過度な負荷をかけません。ティッカーごとにフィードへのリクエストは1回とし、SECへの呼び出しの間に間隔を置き、SECの毎秒10リクエスト制限を十分に下回るようにします。

安全性

教育とツールの提供を目的としており、金融アドバイスではありません。このスキルは読み取りと報告のみを行います。注文を実行するのは /trader-broker だけであり、その場合も /trader-risk の審査に合格し、ユーザーがその注文について明示的に「はい」と入力した後に限られます。

コメント