mcpField
E
earningswhispers

earningswhispers

github.com/gauss314データ・データベース252256 回インストール20 週間前に更新
リポジトリ

earningswhispers について

earningswhispersは、EarningsWhispersから決算説明会のトランスクリプトを取得するスキルです。上場企業の業績分析に利用でき、CLIとPythonクライアントで最新の発言や質疑応答を参照できますが、APIから過去分は取得できません。

主な機能

  1. 01ティッカーで最新トランスクリプトを取得
  2. 02企業名、日付、四半期情報を抽出
  3. 03準備発言と質疑応答を閲覧
  4. 04CLIで複数ティッカーを一括照会
  5. 05ローカルキャッシュと任意の更新に対応

活用シーン

  1. 01決算説明会の議論を確認
  2. 02経営陣の発言と質疑応答を読む
  3. 03複数企業の最新トランスクリプトを確認
  4. 04トランスクリプトの項目を後続分析に利用

インストール

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

$npx skills add https://github.com/gauss314/skills --skill earningswhispers

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

同梱ファイル

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

references/
REFERENCES.md
scripts/
ew_cli.py
ew_client.py

詳細

EarningsWhispers — Earnings Transcripts API(世界規模のカバレッジ)

EarningsWhispers の 公開 API を通じて、決算説明会の全文トランスクリプトを取得するスキルです。

Seeking Alpha と異なり、このサイトには認証不要で、ボット対策もなく、厳しいレート制限もない公開 API があります。トランスクリプトには、参加者、準備発言、質疑応答を含む決算説明会の全文が記載されています。


API エンドポイント

GET https://www.earningswhispers.com/api/conferencecalls?t={TICKER}
パラメーター型説明
tstring(必須)株式銘柄のティッカー(AAPL、MSFT、GGAL、SHEL など)
ccidintカンファレンスコールの内部 ID(任意。過去の履歴は取得できません)

レスポンス: JSON 配列です。ティッカーが存在する場合、配列には最新のトランスクリプトを含むオブジェクトが 1 つ格納されます。存在しない場合、空の配列が返されます。

Respuesta tipica (~50 KB para GGAL, ~90 KB para AAPL):
[{
  "ccid": 132,
  "ticker": "GGAL",
  "company": "Grupo Financiero Galicia S.A.",
  "ccDate": "2026-05-14T11:00:00",
  "ccYear": 2026,
  "ccQtr": 1,
  "speakers": "JSON string con array de speakers",
  "speakerMap": "JSON string con mapping de nombres y cargos",
  "summary": null,
  "aiSummary": null,
  "status": ""
}]

実際のカバレッジ

EarningsWhispers のプラットフォームでは、世界中の 約 33,500 以上の株式を追跡しています。そのうち、相当数の企業について、API 経由で決算説明会の全文トランスクリプトを取得できます。

どの企業のトランスクリプトを取得できますか?

決算説明会を開催する公開企業であれば、トランスクリプトを取得できる可能性があります。実際のカバレッジは次のとおりです。

  • 大型株:ほぼ全面的にカバーされています(AAPL、MSFT、JPM、SHEL、TM など)
  • 中型株:高いカバレッジです(大半の企業にトランスクリプトがあります)
  • 小型株:一部をカバーしています(公開説明会を開催するかどうかによります)
  • ADR:アルゼンチン、ブラジル、メキシコなどの ADR は高いカバレッジです
  • ETF、ファンド、債券:カバレッジ対象外です(決算説明会を開催しないため)
ティッカーのトランスクリプトがあるかどうかを確認するには?

API を試すだけです。

# Si devuelve datos, tiene transcript
curl "https://www.earningswhispers.com/api/conferencecalls?t=AAPL"

# Si devuelve [] (array vacio), no tiene transcript
curl "https://www.earningswhispers.com/api/conferencecalls?t=XXXX"
2026-05-30 時点の地域別の例

米国 — 広範なカバレッジ(決算説明会を開催する米国の公開企業全般):

ティッカー企業トランスクリプト
AAPLApple Inc.✅ Q2 2026
MSFTMicrosoft Corp.✅ Q3 2026
GOOGAlphabet Inc.✅ Q1 2026
AMZNAmazon.com, Inc.✅ Q1 2026
METAMeta Platforms, Inc.✅ Q1 2026
NVDANVIDIA Corp.✅ Q1 2027
TSLATesla, Inc.✅ Q1 2026
JPMJPMorgan Chase & Co.✅
VVisa Inc.✅
WMTWalmart Inc.✅
DISWalt Disney Co.✅
NKENike Inc.✅
XOMExxon Mobil Corp.✅
UNHUnitedHealth Group✅
PFEPfizer, Inc.✅
DALDelta Air Lines✅
COINCoinbase Global✅

ヨーロッパ:

ティッカー企業トランスクリプト
SHELShell plc✅
BPBP p.l.c.✅
TTETotalEnergies SE✅
HSBCHSBC Holdings✅
BBVABBVA✅

アジア:

ティッカー企業トランスクリプト
TMToyota Motor Corp.✅
HMCHonda Motor Co.✅
BABAAlibaba Group✅
JDJD.com, Inc.✅
TCEHYTencent Holdings✅
INFYInfosys Technologies✅

中南米:

ティッカー企業トランスクリプト
ITUBItau Unibanco✅
BBDBanco Bradesco✅
VALEVale S.A.✅
AMXAmerica Movil✅
FMXFomento Economico Mexicano✅
SBSCia de Saneamento✅
WMMVYWalmart Mexico✅

アルゼンチン:

ティッカー企業トランスクリプト
GGALGrupo Financiero Galicia✅ Q1 2026
YPFYPF S.A.✅ Q1 2026
TGSTransportadora de Gas✅ Q1 2026
PAMPampa Energia✅ Q4 2025
BMABanco Macro✅

機能しないティッカーについて

次のような理由で、トランスクリプトを取得できないティッカーがあります。

理由例
決算説明会を開催していないETF(SPY、QQQ、ARKK)、債券
ティッカーが間違っているGOOGL → GOOG、WALMEX → WMMVY
データベースでカバーされていない一部の小型株
企業が破綻・合併したSBNY、FRC

ティッカーに関する注意事項

  • GOOGL は機能しません。Alphabet の場合は GOOG を使用してください
  • WALMEX は機能しません。Walmart Mexico の場合は WMMVY を使用してください
  • SNE(旧 Sony)はすでに存在せず、SONY もカバーされていません
  • データベースに存在しないティッカーは [](空の配列)を返します

インストール

python -c "from curl_cffi import requests; print('OK')"

依存関係:curl_cffi(環境にすでに用意されています)。


スクリプト

スクリプト説明
ew_client.pyCLI を統合した完全なクライアント
ew_cli.pyCLI ラッパー

クイックスタート

CLI
# Cualquier ticker global
python ew_cli.py get AAPL
python ew_cli.py get SHEL --json
python ew_cli.py batch MSFT,GOOG,AMZN --json
python ew_cli.py info GGAL

# Lista de tickers de ejemplo
python ew_cli.py list
Python から
from ew_client import EarningsWhispersClient

client = EarningsWhispersClient()

# Transcript de cualquier empresa global
tr = client.get_transcript("AAPL")
print(tr.company)                    # "Apple, Inc."
print(tr.prepared_remarks[:500])

# Como dict (para JSON)
data = tr.to_dict()

# Batch
results = client.get_transcripts_batch(["MSFT", "GOOG", "AMZN"])

Transcript の主なフィールド

tr = client.get_transcript("NVDA")
tr.company          # "NVIDIA Corp."
tr.date             # "2026-05-20T16:30:00"
tr.quarter_label    # "Q1"
tr.year             # 2027 (fiscal year)
tr.prepared_remarks # Texto de la presentacion
tr.qa_section       # Preguntas y respuestas
tr.summary          # Resumen ejecutivo (puede ser None)
tr.ai_summary       # Resumen AI (puede ser None)

キャッシュ

  • .cache/transcript_{TICKER}.json にローカルキャッシュを保存します
  • 有効期限:24 時間
  • キャッシュを強制更新するには、--no-cache または force_refresh=True を指定します
  • キャッシュに Cookie や認証情報が保存されることは決してありません

制限事項

  1. 最新の Transcript のみ:API が返すのは最新のものだけです。完全な履歴はありません。
  2. 検索エンドポイントなし:利用可能なティッカーをプログラムから検出する方法はありません。
  3. Google/Facebook 認証なし:ウェブページにはログインが必要ですが、API には必要ありません。
  4. 網羅的ではないカバレッジ:追跡対象の株式は約 33,500 銘柄ですが、すべてに Transcript があるわけではありません(公開の決算説明会を実施しているかどうかによります)。
  5. 過去のデータなし:ccid パラメーターを指定しても、以前の Transcript にはアクセスできません。

参考資料

コメント