mcpField
E
earnings-preview

earnings-preview

github.com/himself65データ・データベース3.5k3.4k 回インストール3 日前に更新
リポジトリ

earnings-preview について

yfinanceのデータで決算前の概要をまとめる、金融リサーチ担当者や投資家向けのスキルです。発表日、コンセンサス予想、過去のEPS実績、アナリスト評価、企業情報を整理し、注目点と注意事項も示します。

主な機能

  1. 01決算発表日と時刻
  2. 02EPS・売上高の市場予想
  3. 03過去のEPS予想超過・未達分析
  4. 04アナリスト評価と目標株価
  5. 05財務情報と注目ポイント

活用シーン

  1. 01決算説明会の事前準備
  2. 02予想と過去のEPSサプライズの比較
  3. 03決算発表前のアナリスト評価の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/himself65/finance-skills --skill earnings-preview

インストール後、Claude Code で/earnings-previewを入力して読み込まれたか確認します。

同梱ファイルREADME.mdreferences/api_reference.md

詳細

決算プレビューのスキル

ホストが以下のシェルプローブをまだ実行していない場合(たとえば Codex など)、セットアップ方法を選ぶ前に、シェルツールを使って ! で囲まれたコマンドを実行してください。実際の出力を使用してください。シェルにアクセスできない場合は、その制限を報告してください。

yfinance を通じて Yahoo Finance のデータを使用し、決算発表前のブリーフィングを生成します。今後の決算日、コンセンサス予想、過去の予想精度、アナリストのセンチメント、重要な財務情報をまとめます。決算説明会の前に必要な情報をすべて確認できます。

重要:データは調査および教育目的のみで提供されています。投資助言ではありません。yfinance は Yahoo, Inc. とは無関係です。


ステップ 1:yfinance が利用可能であることを確認する

現在の環境の状態:

!`python3 -c "exec('try:\n import yfinance\n print(\'yfinance \' + yfinance.__version__ + \' installed\')\nexcept Exception:\n print(\'YFINANCE_NOT_INSTALLED\')')"`

YFINANCE_NOT_INSTALLED の場合は、インストールしてください。

import subprocess, sys
subprocess.check_call([sys.executable, "-m", "pip", "install", "-q", "yfinance"])

すでにインストールされている場合は、次のステップに進んでください。


ステップ 2:ティッカーを特定し、すべてのデータを取得する

ユーザーのリクエストからティッカーシンボルを抽出してください。ティッカーを指定せずに会社名を挙げている場合は、ティッカーを調べてください。その後、API 呼び出しを最小限に抑えるため、1 つのスクリプトですべての関連データを取得してください。

import yfinance as yf

ticker = yf.Ticker("AAPL")  # replace with actual ticker

# --- Core data ---
info = ticker.info
calendar = ticker.calendar
earnings_dates = ticker.get_earnings_dates(limit=8)  # report timestamps; the upcoming one has no Reported EPS yet
hist = ticker.history(period="1mo")                  # recent price performance

# --- Estimates ---
earnings_est = ticker.earnings_estimate
revenue_est = ticker.revenue_estimate

# --- Historical track record ---
earnings_hist = ticker.earnings_history

# --- Analyst sentiment ---
price_targets = ticker.analyst_price_targets
recommendations = ticker.recommendations

# --- Recent financials for context ---
quarterly_income = ticker.quarterly_income_stmt
quarterly_cashflow = ticker.quarterly_cashflow
各データソースから抽出する項目
データソース主なフィールド目的
calendarEarnings Date、Ex-Dividend Date決算日と重要な日付
get_earnings_dates()Earnings Date(タイムゾーン対応のタイムスタンプ)、EPS Estimate、Reported EPS決算発表のタイミング:今後の行には Reported EPS がありません。16:00 ET 以降の時刻は取引終了後、それより早い時刻は取引開始前を意味します
earnings_estimateavg、low、high、numberOfAnalysts、yearAgoEps、growth(0q、+1q、0y、+1y)コンセンサス EPS 予想
revenue_estimateavg、low、high、numberOfAnalysts、yearAgoRevenue、growth売上高予想
earnings_historyepsEstimate、epsActual、epsDifference、surprisePercent予想を上回ったか下回ったかの実績(会計四半期末をインデックスとし、古い順)
analyst_price_targetscurrent、low、high、mean、medianアナリストの株価目標
recommendationsBuy/Hold/Sell の件数センチメントの内訳
quarterly_income_stmtTotalRevenue、NetIncome、BasicEPS直近の推移

ステップ 3:決算プレビューを作成する

このブリーフィングを見れば、ユーザーが状況を一目で把握できるようにしてください。以下の 5 項目を取り上げます。いずれかのデータが欠けている場合は、その項目を省略せず、1 行で欠落を伝えてください。

  1. 日付と背景情報 — 会社名、ティッカー、セクター、業界、決算発表日と取引開始前/終了後の別、現在の株価と 1 週間および 1 か月の騰落率、時価総額。
  2. コンセンサス予想 — 当四半期の EPS と売上高のコンセンサスについて、下限、上限、アナリスト数、前年同期の値、予想成長率を含む表を作成します。予想の上限と下限の差がコンセンサスの約 20%を超える場合は、通常より不確実性が高いことを示すため、その旨を明記してください。
  3. 予想を上回ったか下回ったかの実績 — 直近 4 四半期について、EPS の予想と実績をサプライズ率とともに示し、予想を上回った四半期数と平均サプライズ率を要約します。
  4. アナリストのセンチメント — 強い買いから強い売りまでの評価の内訳と、株価目標の範囲(下限、平均、中央値、上限)を示し、平均目標株価から算出した上昇または下落の余地を記載します。
  5. 注目点 — この会社とセクターに応じて、今回の決算発表で市場が注目する点をいくつか選びます。売上高の伸びが加速しているか減速しているか、利益率が拡大しているか縮小しているか、前四半期比で大きく変動した項目、データがある場合はセグメント別の動向などです。ここがブリーフィングにおける判断力を要する部分です。

ステップ 4:ユーザーに回答する

見出しには、決算発表日とセットアップの概要を一文で記載してから、上記の5つの項目を続けます。役立つ場合は表を使用してください。最後に、推定値、実績、センチメントに基づいてセットアップ全体を簡潔にまとめます。推奨ではなく、市場がどのように予想しているかという観点で記述してください。

該当する注意事項を記載してください。推定値は決算発表日まで変更される可能性があること、過去の予想超過が将来の予想超過を保証するものではないこと、Yahoo Finance のコンセンサスはリアルタイムの情報提供元より数時間遅れる場合があること、そしてこれは金融アドバイスではないことです。


参考ファイル

  • references/api_reference.md — 決算および推定値のメソッドに関する yfinance API の詳細なリファレンス

メソッドの正確なシグネチャや特殊なケースへの対応が必要な場合は、参考ファイルを参照してください。

コメント