mcpField
T
trader-analyst

trader-analyst

github.com/jakeschincariolデータ・データベース2.6k110 回インストール1 週間前に更新
リポジトリ

trader-analyst について

trader-analystは、企業の提出書類や決算データを調べるPython製スキルです。最近の業績や次回報告を確認するトレーダー向けに、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へ提出した数値を読み取り、四半期ごとに並べて、何が変わったのかを率直に伝えます。デイトレーダーが取引を始める前に確認する次の2つの質問に答えます。直近の報告書には何が書かれていたか、次の決算発表はこの取引期間内にあるか、です。

このフォルダー内のツール（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に企業ごとに1行（TTM売上高、純利益、希薄化後EPS、最新の利益率と成長率）を書き込みます。メモやスプレッドシートに利用できます。このフォルダー内のmetrics.example.jsonは、2026-10-13にAAPL、AXP、GOOGL、KO、BACを対象に実行した実際の結果です。
  • 決算説明会：このツールは文字起こしを取得しません。ユーザーが貼り付けた場合（または企業のIRページに掲載されている場合）は読み、経営陣が何が変わったと述べたかを要約します。ガイダンス、利益率、需要、回答を避けた質問などが対象です。
  • 次回の決算発表日はSECのデータには含まれていません。/trader-newsの見出し、または企業の投資家向け情報ページで確認し、情報源も記載してください。

ルール

  • 提出済みの数値を優先します。 表は企業が提出したXBRLの事実データに基づきます。プレスリリースは背景情報（ガイダンス、セグメントの詳細）に使い、数値ごとに情報源を明記してください。
  • 同じ条件で比較します。 成長率は前年同期比です。前四半期比の変化も示しますが、多くの企業には季節性があります（Appleの12月期は常に最大です）。
  • 推計値であることを明記します。 企業は第4四半期の10-Qを提出しません。第4四半期は、10-Kの通期実績からその中の3四半期分を差し引いて算出し、「derived」と表示します。推計EPSは概算です。
  • データの遅れを明記します。 SECの事実データAPIへの反映は、提出書類より遅れることがあります。最新の10-Qが事実データに含まれる最新四半期より新しい場合、ツールはリンク付きのNOTEを出力します。要約する前に10-Qそのものを確認してください。
  • 一時的な要因に注意を促します。 純利益が営業利益を上回る場合、事業外の利益（投資評価益、税項目など）が含まれています。ツールはその旨を示します。銀行や保険会社には粗利益率がないため、0ではなく空欄にします。

手順

  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を指定すると2年分を表示し、--jsonを指定するとすべて機械可読形式で出力します。ティッカーのない企業には--cikを指定します。

  2. 最新の決算プレスリリース（EX-99リンク）と、数値の背景情報が必要な場合は10-Qを開いて読みます。

  3. 要約を作成します。四半期の概要（売上高、EPS、成長率）を1行、利益率を1行、特記事項（一時的な要因、推計した四半期、遅延しているデータなど）とリンクを1行にまとめます。平易な言葉と実際の数値を使い、数値が裏付けていない形容は避けてください。

  4. 次回の決算発表が予定している取引期間内（夜間の持ち越し中、または寄り付き前の発表など）にある場合は、/trader-exitでストップを設定する前に伝えてください。ストップはギャップリスクを防げず、株価がストップ価格を飛び越えて寄り付くことがあります。

例：リールの株式

facts.py TSLA（実行日：2026-10-20）：2026-06-30終了四半期（2026年第2四半期）の売上高は282億4,000万ドルで、前年同期比25.5％増、純利益は11億1,000万ドル（4.9％減）、希薄化後EPSは0.32ドル（3.0％減）です。粗利益率は16.8％（前四半期比4.3ポイント減）、営業利益率は1.4％です。直近4四半期の売上高は1,036億ドル、EPSは1.08ドルです。このツールは、純利益が営業利益を上回っているため、事業外の利益が含まれていると警告します。最新の10-Qは2026-07-23に提出されました。月曜日の見出しでは、Teslaが今週決算を発表すると報じられていたため、要約の結びは「次回の決算発表は数日後です。取引終了前に決済するデイトレードには影響しませんが、翌日まで持ち越すポジションには影響します」となります。

facts.py AAPL（2026-10-13）：売上高は1,094億2,000万ドルで、前年同期比16.4％増、希薄化後EPSは2.02ドル（28.7％増）です。Coca-Colaについては、SECのfactsの情報が2026-04-03までしかなかった一方で、2026-07-03の10-Qはすでに提出済みだったため、要約ではその10-Qを直接参照しました。

決してしないこと

  • 株が割安、割高、買い、売りだとは決して述べません。企業が提出した情報を報告します。
  • 提出書類にない数字を決して捏造せず、算出できない四半期の数値を推定しません。
  • User-AgentなしでSECにアクセスせず、リクエスト数は常に毎秒10件を大きく下回るようにします。

安全性

教育とツールの提供を目的としており、金融アドバイスではありません。このスキルは提出書類を読むだけです。注文を発注するのは/trader-brokerだけであり、その前に/trader-riskのチェックに合格し、ユーザーがその注文に対して明示的に「はい」と入力する必要があります。

コメント

Markdown 対応