Community研究&データ分析github.com

Shijiuwei/trader-analyst

決算アナリスト。SEC EDGARから企業が報告した数字(10-Q、10-KのXBRL企業ファクト、および最新の決算8-Kとプレスリリース)を直接読み取り、収益、粗利益、営業利益率、純利益、希薄化後EPSなど、前年同期比、四半期ごとの変化を要約します。決算説明会の文字起こしが貼り付けられた場合も読み取ります。

trader-analyst とは?

このスキルは、SEC(米国証券取引委員会)に提出された企業の財務データを直接EDGARシステムから取得・分析し、投資判断に役立つ定量的な要約を提供します。具体的には、企業が提出したXBRLファクトから収益、各種利益率、純利益、希薄化後EPSなどの主要指標を抽出し、前年同期比での成長率や四半期ごとの変化を明確に示します。日中のトレーダーにとっては、直近の決算内容を把握し、次の決算発表が取引期間内に予定されていないかを確認するために不可欠なツールです。取得したデータは表形式で提示され、SEC APIの更新遅延や一時的な項目などの注意点も自動的にフラグ付けされます。また、決算説明会の文字起こしを分析して経営陣のコメントを要約する機能も備えていますが、文字起こし自体の自動取得は行いません。このスキルはClaude CodeやCodexなどの標準的なPython環境で動作し、SEC APIへのアクセスにはユーザーエージェントの設定が必要です。

対応✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/Shijiuwei/cloud-day-trader-skill/tree/HEAD/trader-analyst

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

trader-analyst は何をしますか?

決算は、カレンダー上のどのイベントよりも株価を動かします。そして、プレスリリースは最も良い数字を最初に提示するように書かれています。このスキルは、企業が実際にSECに提出した数字を読み取り、四半期ごとに並べ、何が変わったのかを平易に説明します。デイトレーダーにとって、取引前に「前回の決算はどうだったか?」と「次の決算はこの取引期間内にあるか?」という2つの質問に答えます。

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

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

SEC User-Agent(trader/config.json の sec_user_agent、または SEC_USER_AGENT)が必要です:「あなたの名前 [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 のヘッドラインまたは企業の投資家向け情報(IR)ページで確認し、その情報源を明記してください。

ルール

  • 提出された数字を優先。 テーブルは企業が提出したXBRLファクトに基づきます。プレスリリースはコンテキスト(ガイダンス、セグメントの詳細)のために使用し、どの数字がどこから来たのかを明記してください。
  • 同じものを同じものと比較する。 成長率は前年同期比です。前期比の変化も表示しますが、多くの企業には季節性があります(アップルの12月四半期は常に最大)。
  • 導出された値であることを明記する。 企業は第4四半期の10-Qを提出しません。第4四半期は10-Kの年度からその中の3四半期を差し引いたもので、「導出」とマークされます。導出されたEPSは概算です。
  • データの遅延を明記する。 SECのファクトAPIは提出に遅れることがあります。最新の10-Qがファクト内の最新四半期よりも新しい場合、ツールはリンク付きの注記(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 で2年間、--json で機械可読な全データ、--cik でティッカーがない企業を指定できます。

  2. 最新の決算プレスリリース(EX-99リンク)を開き、数字にコンテキストが必要な場合は10-Qも開いて読みます。

  3. 要約を書きます:四半期の概要(収益、EPS、成長率)を1行、利益率を1行、異常項目(一時的な項目、導出された四半期、データ遅延)を1行、そしてリンク。平易な言葉、実際の数字、数字が裏付けない形容詞は使いません。

  4. 次の決算発表が計画された取引期間内(オーバーナイト保有、または寄り付き前の発表)に該当する場合、/trader-exit がストップを設定する前にその旨を伝えます:ストップはギャップに対しては無力であり、ストップ価格を通り越して寄り付く可能性があります。

例:問題の銘柄

facts.py TSLA(2026年10月20日実行):2026年6月30日終了四半期(2026年第2四半期)、収益282.4億ドル、前年同期比+25.5%、純利益11.1億ドル(-4.9%)、希薄化後EPS 0.32ドル(-3.0%);粗利益率16.8%(前期比-4.3ポイント)、営業利益率1.4%;過去4四半期の収益1036億ドル、EPS 1.08ドル。ツールは純利益が営業利益を上回っていることをフラグ付けし、本業以外の利益が含まれていることを示します。最新の10-Qは2026年7月23日提出。月曜日のヘッドラインはテスラが今週決算発表することを示していたため、要約は「次回の決算発表は数日後です。引けまでに決済するデイトレードは影響を受けませんが、オーバーナイトで保有するものは影響を受けます。」で終わります。

facts.py AAPL(2026年10月13日):収益1094.2億ドル、前年同期比+16.4%、希薄化後EPS 2.02ドル(+28.7%)。コカ・コーラについては、SECのファクトが2026年4月3日で止まっている一方、2026年7月3日時点の10-Qはすでに提出されていたため、ツールは注記を出力しました。要約はその10-Qを直接読みました。

決してしないこと

  • 株が安い、高い、買い、売りなどとは決して言いません。企業が提出した内容を報告するのみです。
  • 提出書類にない数字をでっち上げたり、導出できない四半期を推定したりしません。
  • User-AgentなしでSECを呼び出したり、1秒間に10リクエストを超えたりしません。

安全性

教育とツールの提供であり、金融アドバイスではありません。このスキルは提出書類を読むだけです。発注は、/trader-risk が承認され、ユーザーがその注文に明示的に同意した後に、/trader-broker のみが行います。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル