Economic Calendar Fetcher

Overview

Financial Modeling Prep (FMP) Economic Calendar API から今後の経済イベントとデータ公開を取得します。このスキルは、中央銀行の金融政策決定、雇用統計、インフレデータ（CPI/PPI）、GDP発表、小売売上高、製造業データ、および金融市場に影響を与えるその他の市場変動イベントなどの予定されている経済指標を取得します。

スキルは Python スクリプトを使用して FMP API をクエリし、生の JSON またはテキスト出力を返します。その後、アシスタントがイベントをフィルタリングし、市場への影響を評価し、スケジュール済みの各イベントについて時系列の Markdown レポートを生成します。ファイルは自動生成されません。

主な機能：

• 指定された日付範囲のために経済イベントを取得（最大90日）
• 柔軟な API キー提供をサポート（環境変数または CLI 引数）
• 影響レベル、国、またはイベントタイプでフィルタリング（フィルタリングはアシスタントが実行）
• フィルタリングされた結果を影響分析付きの構造化 Markdown レポートとして提示（アシスタントが生成、スクリプトではない）
• 迅速な市場展望のために次の7日間がデフォルト

データソース：

• FMP Economic Calendar API: https://financialmodelingprep.com/api/v3/economic_calendar
• 主要経済国をカバー：米国、EU、英国、日本、中国、カナダ、オーストラリア
• イベントタイプ：中央銀行決定、雇用、インフレ、GDP、貿易、住宅、調査

When to Use This Skill

ユーザーが以下をリクエストしたときにこのスキルを使用してください：

1. 経済カレンダークエリ：

   • 「今週はどのような経済イベントが予定されていますか？」
   • 「今後2週間の経済カレンダーを見せてください」
   • 「次の FOMC 会合はいつですか？」
   • 「来月の主な経済データ公開はいつですか？」

2. 市場イベント計画：

   • 「今週の市場で注視すべきことは何ですか？」
   • 「高影響の経済発表がありますか？」
   • 「次の失業率報告書 / CPI 発表 / GDP レポートはいつですか？」

3. 特定の日付範囲リクエスト：

   • 「1月1日から1月31日までの経済イベントを取得してください」
   • 「2025年Q1の経済カレンダーには何がありますか？」

4. 国別クエリ：

   • 「来週の米国経済データ公開を見せてください」
   • 「ECB イベントはいつ予定されていますか？」
   • 「日本はいつインフレデータを公開しますか？」

このスキルを使用しないでください：

• 過去の経済イベント（歴史的分析には market-news-analyst を使用）
• 企業決算カレンダー（このスキルは決算を除外）
• リアルタイム市場データまたはライブ相場
• テクニカル分析またはチャート解釈

Workflow

経済カレンダーを取得および分析するには、以下のステップに従ってください：

Step 1: FMP API キーを取得する

API キーの利用可能性を確認（優先順：

1. 推奨： FMP_API_KEY 環境変数が設定されているかどうかを確認 — キーをセッションログから除外
2. 許容可能： --api-key CLI 引数をワンオフ実行に使用
3. 推奨しない： ユーザーにチャットにキーを貼り付けるよう要求 — セッションログに保持される可能性
4. ユーザーが API キーを持っていない場合は、以下の手順を提供してください：
   • https://financialmodelingprep.com にアクセス
   • 無料アカウントにサインアップ（1日250リクエストの上限）
   • API ダッシュボードに移動してキーを取得

ユーザーとのやり取り例：

User: "Show me economic events for next week"
Assistant: "I'll fetch the economic calendar. I'll use the FMP_API_KEY environment variable if it's set. Otherwise, please pass the key via --api-key when running the script."

Step 2: 日付範囲を決定する

ユーザーのリクエストに基づいて適切な日付範囲を設定：

デフォルト（特定の日付なし）： 本日 + 7日間 ユーザーが期間を指定： 正確な日付を使用（形式を検証：YYYY-MM-DD） 最大範囲： 90日（FMP API 制限）

例：

• 「来週」 → 本日から +7日間
• 「今後2週間」 → 本日から +14日間
• 「2025年1月」 → 2025-01-01 から 2025-01-31
• 「2025年 Q1」 → 2025-01-01 から 2025-03-31

日付範囲を検証：

• 開始日付 ≤ 終了日付 であることを確認
• 範囲 ≤ 90日 であることを確認
• 過去の日付をクエリする場合は警告

Step 3: API フェッチスクリプトを実行する

適切なパラメータを使用して get_economic_calendar.py スクリプトを実行：

基本的な使用法（デフォルト7日間）：

python3 /path/to/economic-calendar-fetcher/scripts/get_economic_calendar.py --api-key YOUR_KEY

特定の日付範囲を指定：

python3 /path/to/economic-calendar-fetcher/scripts/get_economic_calendar.py \
  --from 2025-01-01 \
  --to 2025-01-31 \
  --api-key YOUR_KEY \
  --format json

環境変数を使用（--api-key は不要）：

export FMP_API_KEY=your_key_here
python3 /path/to/economic-calendar-fetcher/scripts/get_economic_calendar.py \
  --from 2025-01-01 \
  --to 2025-01-07

スクリプトパラメータ：

• --from: 開始日付（YYYY-MM-DD） - デフォルト：本日
• --to: 終了日付（YYYY-MM-DD） - デフォルト：本日 + 7日間
• --api-key: FMP API キー（FMP_API_KEY 環境変数が設定されている場合はオプション）
• --format: 出力形式（json または text） - デフォルト：json
• --output: 出力ファイルパス（オプション、デフォルト：stdout）

エラーを処理：

• 無効な API キー → キーを確認するようユーザーに要求
• レート制限超過（429） → 待機またはアップグレードを提案
• ネットワークエラー → 接続を確認してスクリプトを再実行
• 無効な日付形式 → 正しい形式例を提供

Step 4: イベントを解析およびフィルタリングする

スクリプトからの JSON レスポンスを処理：

1. イベントデータを解析： API レスポンスからすべてのイベントを抽出
2. 指定されたユーザーフィルターを適用：
   • 影響レベル：「High」、「Medium」、「Low」
   • 国：「US」、「EU」、「JP」、「CN」など
   • イベントタイプ：FOMC、CPI、雇用、GDP など
   • 通貨：USD、EUR、JPY など

フィルタリング例：

• 「高影響のイベントのみを表示」 → 影響 == 「High」 でフィルタリング
• 「米国イベントのみ」 → 国 == 「US」 でフィルタリング
• 「中央銀行決定」 → イベント名で「Rate」、「Policy」、「FOMC」、「ECB」、「BOJ」を検索

イベントデータ構造：

{
  "date": "2025-01-15 14:30:00",
  "country": "US",
  "event": "Consumer Price Index (CPI) YoY",
  "currency": "USD",
  "previous": 2.6,
  "estimate": 2.7,
  "actual": null,
  "change": null,
  "impact": "High",
  "changePercentage": null
}

Step 5: 市場への影響を評価する

各イベントの市場的重要性を評価：

影響レベル分類（FMP より）：

• High Impact（高影響）： 市場を大きく動かすイベント

  • FOMC 利率決定、ECB/BOJ 政策会合
  • 非農業部門雇用（NFP）、CPI、GDP
  • 市場は通常、インターネット内で 0.5-2%+ のボラティリティを示す

• Medium Impact（中影響）： 重要だがボラティリティが低い

  • 小売売上高、鉱工業生産
  • PMI 調査、消費者信頼感
  • 住宅データ、耐久財受注

• Low Impact（低影響）： マイナーな指標

  • 週単位の失業保険請求（極端な場合を除く）
  • 地域製造業調査
  • マイナー入札結果

追加の背景要因：

1. 現在の市場感応度：

   • 高インフレ環境 → CPI/PPI の重要性が高い
   • 景気後退懸念 → 雇用データがより重要
   • 利下げ予想 → 中央銀行会合が重要

2. サプライズ可能性：

   • 推定値と前回の読値を比較
   • 大きな予想変化 = より高い注目
   • コンセンサス不確実性 = より高い影響の可能性

3. イベント集中：

   • 同じ日に複数の関連イベント = 影響を増幅
   • 例：CPI + 小売売上高 + FRB スピーチ = 非常に高い影響の日

4. 前向きの重要性：

   • このイベントが今後の中央銀行決定に影響を与えるか？
   • これは速報値か最終値か？
   • このデータは修正されるか？

Step 6: 出力レポートを生成する

責任： スクリプトは生の JSON またはテキストを出力します。このステップはアシスタントがスクリプト出力を使用して実行されます。Markdown ファイルは自動生成されません。結果はチャットに表示され、リクエストに応じて reports/ に保存できます。

以下のセクションを含む構造化 Markdown レポートを作成：

レポートヘッダー：

# Economic Calendar
**Period:** [Start Date] to [End Date]
**Report Generated:** [Timestamp]
**Total Events:** [Count]
**High Impact Events:** [Count]

イベントリスト（時系列）：

各イベントについて、以下を提供してください：

## [Date] - [Day of Week]

### [Event Name] ([Impact Level])
- **Country:** [Country Code] ([Currency])
- **Time:** [HH:MM UTC]
- **Previous:** [Value]
- **Estimate:** [Consensus Forecast]
- **Impact Assessment:** [Your analysis]

**Market Implications:**
[2-3 sentences on why this matters, what markets watch for, typical reaction patterns]

---

イベントエントリの例：

## 2025-01-15 - Wednesday

### Consumer Price Index (CPI) YoY (High Impact)
- **Country:** US (USD)
- **Time:** 14:30 UTC (8:30 AM ET — converted by assistant based on US DST calendar)
- **Previous:** 2.6%
- **Estimate:** 2.7%
- **Impact Assessment:** Very High - Core inflation metric for Fed policy decisions

**Market Implications:**
CPI reading above estimate (>2.7%) likely strengthens hawkish Fed expectations, potentially pressuring equities and supporting USD. Reading at or below 2.7% could reinforce disinflation narrative and support risk assets. Options market pricing 1.2% S&P 500 move on release day.

---

サマリーセクション：

終了時に分析サマリーを追加してください：

## Key Takeaways

**Highest Impact Days:**
- [Date]: [Events] - [Combined impact rationale]
- [Date]: [Events] - [Combined impact rationale]

**Central Bank Activity:**
- [Summary of any scheduled Fed/ECB/BOJ meetings or speeches]

**Major Data Releases:**
- Employment: [NFP, Unemployment Rate dates]
- Inflation: [CPI, PPI dates]
- Growth: [GDP, Retail Sales dates]

**Market Positioning Considerations:**
[2-3 bullets on how traders might position around these events]

**Risk Events:**
[Highlight any particularly high-uncertainty or surprise-potential events]

フィルタリングノート：

ユーザーが特定のフィルターをリクエストした場合は、トップに注記してください：

**Filters Applied:**
- Impact Level: High only
- Country: US
- Events shown: [X] of [Y] total events in date range

出力：

• 結果はチャットに表示されます。ファイルは自動生成されません。
• 生の JSON/テキストデータ を保存するには、スクリプト実行時に --output reports/economic_calendar_[START]_to_[END].json を使用してください。
• Markdown レポート を保存するには、チャットで生成した後、アシスタントに reports/ に書き込むよう要求してください。

Assistant-Generated Report Format

Markdown 構造要件：

1. 時系列順序： イベントを日付と時間でソート（最も早いものが最初）
2. 影響レベルインジケータ： (High Impact)、(Medium Impact)、(Low Impact) ラベルを使用
3. タイムゾーンの明確性： 常に UTC を指定。ET/PT 変換はアシスタントが米国 DST カレンダーに基づいて実行
4. データ完全性： すべての利用可能なフィールドを含める（前回値、推定値、過去データの場合は実績）
5. Null 処理： null 値に対しては「N/A」または「No estimate」と表示
6. 影響評価： すべての高影響/中影響イベントに市場への影響分析が必要

テーブル形式オプション（密集したリスト用）：

| Date/Time (UTC) | Event | Country | Impact | Previous | Estimate | Assessment |
|-----------------|-------|---------|--------|----------|----------|------------|
| 01-15 14:30 | CPI YoY | US | High | 2.6% | 2.7% | Core inflation metric |

言語： すべてのレポートは英語で

Resources

Python スクリプト：

• scripts/get_economic_calendar.py: CLI インターフェースを備えたメイン API フェッチスクリプト

参照ドキュメント：

• references/fmp_api_documentation.md: 完全な FMP Economic Calendar API リファレンス
  • 認証と API キー管理
  • リクエストパラメータと日付形式
  • レスポンスフィールドの定義
  • レート制限とエラー処理
  • キャッシング効率のベストプラクティス

API 詳細：

• エンドポイント：https://financialmodelingprep.com/api/v3/economic_calendar
• 認証：API キーが必要（無料枠：1日250リクエスト）
• 最大日付範囲：リクエストあたり 90日
• レスポンス形式：イベントオブジェクトの JSON 配列
• レート制限：秒単位 5 リクエスト（無料枠）

イベントカバレッジ：

• 主要経済国：米国、EU、英国、日本、中国、カナダ、オーストラリア、スイス
• イベントカテゴリ：金融政策、雇用、インフレ、GDP、貿易、住宅、調査
• 更新頻度：リアルタイム（イベントはスケジュール通りに追加/更新）
• 歴史的データ：実績値を使用した過去イベント用に利用可能

使用のヒント：

1. API 呼び出しを最小化するために結果をキャッシング（イベントはスケジュール後にほぼ変更されない）
2. 最適なリクエスト効率のために 7-30日範囲でクエリ
3. 6 カ月以上先をクエリしない（データがまばら、推定日付）
4. キャッシュを毎日更新して、次の週をキャッチして時間変更に対応
5. リアルタイムイベント監視のために小さい範囲（1-7日）を使用

エラー処理：

• API キーエラー：無料キーを取得するための明確なユーザーガイダンス
• レート制限（429）：待機またはアップグレードを提案。待機後にスクリプトを再実行
• ネットワーク障害：接続を確認して再実行。スクリプトに自動再試行またはキャッシュなし
• 無効な日付：有用なエラーメッセージを含む検証