mcpField
F
financial-analysis-earnings

financial-analysis-earnings

github.com/pionex-officialデータ・データベース5121 回インストール14 週間前に更新
リポジトリ

financial-analysis-earnings について

financial-analysis-earningsは、米国上場企業の四半期決算を分析するスキルです。SEC EDGARのXBRLデータとコンセンサス予想のウェブ調査を組み合わせ、予想との差、推移、業績見通しをまとめます。

主な機能

  1. 01発表済み四半期とコンセンサスを検索
  2. 02スクリプトでSEC EDGARの財務データを取得
  3. 03累計申告値から単独四半期値を算出
  4. 04実績をコンセンサスと比較
  5. 058四半期の推移と見通しを分析

活用シーン

  1. 01米国上場企業の最新四半期決算を評価
  2. 02売上高とEPSをアナリスト予想と比較
  3. 038四半期の利益率と業績推移を確認
  4. 04実績と合わせて会社見通しを検討

インストール

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

$npx skills add https://github.com/pionex-official/pionex-skills --skill financial-analysis-earnings

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

run.sh
scripts/
earnings_report.py
get_comps.py
get_fundamentals.py
get_quote.py

詳細

収益分析

米国上場株の四半期決算を分析します。SEC EDGAR の XBRL 提出書類とウェブ検索によるコンセンサス予想を組み合わせ、トレンド分析を含む、ビート/ミスの構造化レポートを作成します。

セットアップ

依存関係は不要です。すべてのスクリプトは Python 標準ライブラリのみを使用します。

ワークフロー

ステップ 1 — 四半期を特定し、コンセンサスを調べる(ウェブ検索)

必ず最初に検索してください。決算結果の確認に学習データを頼ってはいけません。

検索 0 — 直近に発表された四半期を特定します。

  • [Company] [ticker] latest quarterly earnings results [current year]

今日の日付と照合します(暦年を会計年度とする企業の場合)。

  • Q1 の決算発表時期の目安:4~5 月
  • Q2 の決算発表時期の目安:7~8 月
  • Q3 の決算発表時期の目安:10~11 月
  • Q4 の決算発表時期の目安:1~2 月

暦年以外の会計年度:四半期を割り当てる前に、SEC EDGAR データで会社の会計年度末を確認します。よくある例:Apple の FY は 9 月に終了(Q1 = 10~12 月)、Microsoft の FY は 6 月に終了(Q1 = 7~9 月)。get_fundamentals.py の出力にある fiscal_year と fiscal_quarter の各フィールドを使用してください。

今日の日付が次の四半期の通常の発表時期を過ぎている場合は、再度検索してください。より新しい四半期が発表されている可能性があります。

四半期を確認したら、次の 2 つの検索を実行します。

検索 A — 発表済みの決算:

  • [Company] [confirmed quarter] earnings results revenue EPS

検索 B — コンセンサス予想:

  • [Company] [confirmed quarter] earnings consensus estimate revenue EPS
  • [Ticker] earnings beat miss [confirmed quarter]

検索 C(A と B の後)— ガイダンス:

  • [Company] [confirmed quarter] earnings guidance outlook next quarter [year]

次に進む前に、以下をすべて抽出してください。

項目備考
発表された四半期(例:Q1 FY2026)日付を確認してください。推測してはいけません
売上高(発表値)
調整後 EPS(発表値)
売上高のコンセンサス予想絶対額で記載してください(例:$27.2B)
調整後 EPS のコンセンサス予想金額で記載してください(例:$2.84)
次四半期のガイダンス売上高または EPS の範囲。見つからない場合は「未提供」と記載してください
通期ガイダンス前回と比較して引き上げ/引き下げ/維持
経営陣の主なコメント主なポイントを 2~3 点

2 回検索してもコンセンサスが見つからない場合は、さらに 1 回、対象を絞って検索します:[Ticker] EPS estimate Q[X] [year] analyst consensus。3 回試すまでは「コンセンサス予想は入手できません」と記載しないでください。


ステップ 2 — 財務データを取得する(スクリプト)

一括処理スクリプトを実行します。ステップ 1 の検索 A と B と並行して実行してください。

bash run.sh <SYMBOL>
# With peer comparison:
bash run.sh <SYMBOL> --peers <PEER1> <PEER2>

現在の株価、SEC EDGAR の 8 四半期分の財務データ、3 年分の年次データ、および任意の同業他社比較を含む JSON を返します。

重要:SEC EDGAR の 10-Q データは年初来の累計値です。 差し引き計算で単独四半期の値を算出してください。

  • Q1 の単独値 = Q1 の年初来累計値(差し引き不要)
  • Q2 の単独値 = 上半期の年初来累計値 − Q1 の年初来累計値
  • Q3 の単独値 = 9 か月累計値 − 上半期の年初来累計値
  • Q4 の単独値 = 通期(10-K)− 9 か月累計値

売上高、売上総利益、営業利益、純利益に差し引き計算を適用します。EPS は差し引かないでください。EPS は 1 株当たりの数値であり、累計値ではありません。そのため、上半期の EPS から Q1 の EPS を引いても、Q2 の EPS にはなりません(期間ごとに株式数が異なるためです)。Q2/Q3 の単独 EPS には、ウェブ検索(ステップ 1)の値を使用するか、単独四半期の純利益 ÷ 希薄化後株式数で算出してください。

Q4 の算出に関する注意:Q4 の単独値 = 10-K の通期値 − Q3 の 9 か月累計値。Q3 の 10-Q がスクリプトの返す 8 期間に含まれていない場合(古すぎる場合)は、ウェブ検索で Q4 の単独値を補ってください。

現在の四半期について、年初来累計値から単独四半期値への算出表を作成する必要があります。正確なテンプレートとルールについては、出力形式のセクション 3を参照してください。

一括処理スクリプト(bash run.sh)を推奨します。四半期データ、年次データ、株価、同業他社データを 1 回の呼び出しで集約します。


ステップ 3 — ビート/ミス分析

3 列の表を提示します。

Metric        | Reported  | Consensus        | Beat/(Miss)
--------------|-----------|------------------|------------------
Revenue       | $X.XB     | $X.XB            | +$XXM (+X.X%)
Adj. EPS      | $X.XX     | $X.XX            | +$X.XX (+X.X%)
Gross Margin  | XX.X%     | XX.X% (if avail) | +XXbps

コンセンサスが得られない場合は、「n/a — consensus not found」と記載します。この行は省略しないでください。

各ビートまたはミスについて、理由を説明する文を 1 文記載します。理由には、セグメント構成、価格設定、コストの変化、一時的な項目などを含めます。


ステップ 4 — トレンド分析

ステップ 2 で算出した四半期単独の数値を使用します。直近の四半期の数値が膨らみ、前年比の比較が歪む YTD 累計値は使用しないでください。実際に報告された直近 8 四半期の結果を示します。分析対象の四半期は、最後(最も新しい)の行に記載してください。

データソースの要件: 表の各四半期について、データソースを示します。

  • (SEC) — SEC EDGAR への提出書類から算出(優先)
  • (web) — ウェブ検索から取得(SEC への提出書類がまだ利用できない場合のみ)

SEC データが利用できる場合、ウェブ検索のデータを使用しないでください。SEC EDGAR を第一の情報源とします。

報告対象四半期の 10-Q/10-K がまだ SEC EDGAR に提出されていない場合は、ウェブ検索(ステップ 1)の数値を使用し、行に (web) と記載します。

四半期売上高前年比粗利益率営業利益率希薄化後 EPS出典
Q[X-7]$X.XB+X%XX.X%XX.X%$X.XXSEC
.....................
Q[X]$X.XB+X%XX.X%XX.X%$X.XXSEC/web

当四半期と前年同期の両方の数値がある場合は、必ず前年比を算出します。

表の後に、次の点についてコメントします。

  • 利益率の拡大または縮小の傾向
  • EPS の成長と売上高の成長の比較(自社株買いの効果か、利益率の改善か)
  • 直近 2~3 四半期の加速または減速

ステップ 5 — ガイダンスと見通し

必須です。

  • 次四半期のガイダンス:指標、レンジ、ウォール街予想を上回る/下回る/一致するか
  • 通期ガイダンス:前回と比べて引き上げ/引き下げ/維持のいずれか。変更幅も数値で示します
  • ガイダンスがない場合:その旨を明記し、トレンドデータに基づく先行きの見通しを示します

ステップ 6 — 類似企業のバリュエーション(ユーザーが求めた場合のみ)
bash run.sh <SYMBOL> --peers <PEER1> <PEER2> ...

最大 10 社について、売上高、利益率、成長率、P/E、P/S を返します。


出力形式

セクション 1 — サマリーボックス(必須、常に最初に記載):

[COMPANY] ([TICKER]) — Q[X] FY[YYYY] EARNINGS   Result: BEAT / INLINE / MISS / N/A

Revenue:      $X.XB   (consensus: $X.XB  |  beat by +$XXM, +X.X%)
Adj. EPS:     $X.XX   (consensus: $X.XX  |  beat by +$X.XX, +X.X%)
Gross Margin: XX.X%   (vs. XX.X% a year ago, +XXbps YoY)

サマリーボックスの数値はすべて四半期単独の値とし、通期または YTD の値は使用しません。

売上高と調整後 EPS の両方でコンセンサスが得られない場合は、Result を N/A に設定します。

セクション 2 — 主なポイント(箇条書き 3~5 項目)。「好調な売上高」ではなく、「売上高は 15.7% 増の $143.8B」のように数値から始めます。

セクション 3 — SEC データの算出(必須)

当四半期について、YTD から四半期単独の数値を算出する表を示します。これは、数値がウェブ情報源ではなく SEC への提出書類から得られたことを証明する監査証跡です。この表がなければ、読者は計算を検証できません。次の形式を使用します。

SEC EDGAR Derivation: Q4 FY2025 Standalone
| Metric       | FY Annual   | − Q3 YTD    | = Q4 Standalone |
|--------------|-------------|-------------|-----------------|
| Revenue      | $XXX.XB     | $XXX.XB     | $XX.XB ✓        |
| Net Income   | $XX.XB      | $XX.XB      | $XX.XB          |

売上高と純利益(最も重要な 2 つの指標)のみを示します。✓ はウェブ検索結果との相互検証を示します。この表は、四半期単独の数値を提示する前に必ず記載してください。

セクション 4 — 売上高とセグメントの分析

セクション 5 — 利益率の分析

セクション 6 — 8 四半期のトレンド表(必須 — ステップ 4 の表を使用し、出典列を含める)

セクション 7 — ガイダンス(必須 — ステップ 5 の内容を記載)

セクション 8 — バリュエーション(依頼された場合のみ)

追加の選択肢を提示する前に、必須セクションをすべて出力してください。


書式ルール

  • 売上高/利益:B または M を使用します(例:「$143.8B」、「$890M」)
  • 利益率:小数点以下 1 桁のパーセントで表します(例:「48.2%」)
  • 利益率の変化:ベーシスポイントで表します(例:「前年比 +130bps」)
  • EPS:小数点以下 2 桁で表します(例:「$2.84」)
  • 成長率:小数点以下 1 桁で表します(例:「前年比 +15.7%」)

制限事項

  • SEC EDGARの遅延:提出データは決算発表から2~5日遅れる場合があります。提出書類が入手できない場合は、最新四半期の数値をウェブ検索で確認してください。
  • 10-Qは年初来累計:単独四半期の数値を算出するため、必ず前の期間の数値を差し引いてください(ステップ2を参照)。
  • 決算説明会のトランスクリプトなし:ウェブ検索のみを使って、経営陣のコメントを要約してください。
  • 米国株のみ:SEC EDGARが対象とするのは、米国上場株式のみです。
  • ウェブ検索によるコンセンサス:必ず情報源を明記してください。3回試しても入手できない場合は、その旨を明記してください。

コメント