finance

Market Tracker Skill

このスキルを使うと、以下の最新の価格と過去の時系列データを取得できます。

• 株式／ETF／指数（例：AAPL、MSFT、^GSPC、VOO）
• FX ペア（例：USD/ZAR、EURUSD、GBP-JPY）
• 選択したプロバイダーがサポートする暗号資産のティッカー（可能な範囲で対応）

以下の用途に最適化されています。

• 「今の価格は？」という問い合わせへの迅速な回答
• ローカルのウォッチリストを使った軽量な追跡
• レート制限を避けるためのキャッシュ

使用する場面

ユーザーから以下のような依頼があった場合に、このスキルを使用してください。

• 「___ の最新価格を教えてください。」
• 「___ と ___ を追跡して、日ごとの変動を表示してください。」
• 「___ の30日分の時系列データをください。」
• 「USD を ZAR に換算してください（または USD/ZAR を追跡してください）。」
• 「ウォッチリストを管理して、パフォーマンスを要約してください。」

プロバイダー戦略（重要）

• 株式／ETF／指数のデフォルト：Yahoo Finance を yfinance 経由で利用します（API キー不要、幅広い銘柄に対応）。ただし非公式であり、レート制限がかかる場合があります。
• FXのデフォルト：ExchangeRate-API の Open Access エンドポイントを利用します（API キー不要、日次更新）。
• 高頻度の取得や多数の銘柄が必要な場合は、後から有料プロバイダーを追加することをおすすめします。

詳細とシンボル形式については、providers.md を参照してください。

---

クイックスタート（実行方法）

これらのスクリプトはターミナルから実行することを想定しています。エージェントは以下を行います。

1. 依存関係がインストールされていることを確認する
2. スクリプトを実行する
3. 結果を分かりやすく要約する

インストール：

• python -m venv .venv && source .venv/bin/activate（または Windows の同等のコマンド）
• pip install -r requirements.txt

コマンド

1) 最新の価格（株式／ETF／指数）

例：

• python scripts/market_quote.py AAPL
• python scripts/market_quote.py ^GSPC
• python scripts/market_quote.py VOO

2) 最新の FX レート

例：

• python scripts/market_quote.py USD/ZAR
• python scripts/market_quote.py EURUSD
• python scripts/market_quote.py GBP-JPY

3) 過去の時系列データ（CSV を標準出力へ）

例：

• python scripts/market_series.py AAPL --days 30
• python scripts/market_series.py USD/ZAR --days 30

4) ウォッチリストの要約（ローカルファイル）

• ティッカーを追加：python scripts/market_watchlist.py add AAPL MSFT USD/ZAR
• 削除：python scripts/market_watchlist.py remove MSFT
• 要約を表示：python scripts/market_watchlist.py summary

---

出力時の留意点（ユーザーに返す内容）

• 価格の場合：価格、変動率、タイムスタンプ／情報源、および注意事項（「FX は日次更新」など）。
• 時系列データの場合：日付範囲とデータ点数を確認し、冒頭と末尾の数行をプレビューとして表示します。
• レート制限が発生した場合：何が起きたかを説明し、間隔を空けて再試行するか、取得頻度を減らすよう案内します。

---

安全性／正確性

• プロバイダーが真にリアルタイムでない限り、「リアルタイム」とは決して言わないでください。FX の Open Access は日次更新です。
• 応答は常にキャッシュし、繰り返しの呼び出しを抑制してください。
• Yahoo にリクエストをブロックされた場合は、有料プロバイダーを提案するか、キャッシュ TTL を延長してください。