finance-research-agent

金融リサーチエージェント

概要

このスキルは、自律的な金融リサーチのための包括的なフレームワークを提供します。複数の資産クラス（株式、暗号資産、コモディティ、マクロ経済指標）にわたるデータ収集、分析、レポート作成に対応しています。エージェントは、簡易スナップショット、詳細分析、継続的なモニタリングなど、さまざまなモードで動作できます。

主な機能：

• 複数ソースの市場データ（リアルタイム＋過去データ）
• ニュースのセンチメント分析
• テクニカル指標の計算
• Polymarketのポジション追跡
• レポートの自動作成（Markdown/PDF）
• アラート／ウォッチリストの管理

主な機能

1. 市場データのリサーチ

任意のティッカー／シンボルの現在および過去の価格データを取得します。

リクエスト例：

• 「BTCの過去30日間の価格データを取得して」
• 「AAPLの現在のP/E比率は？」
• 「ETHの1時間足チャートを表示して」

使い方：

from .scripts.data_fetcher import fetch_historical, fetch_current
data = fetch_historical("AAPL", period="1mo", interval="1d")

対応ソース：

• Yahoo Finance（株式、ETF、指数）
• CoinGecko（暗号資産）
• FRED API（マクロ経済指標）
• Polymarket（予測市場）

2. ニュースとセンチメントの分析

金融ニュースをスキャンし、センチメントや知見を抽出します。

リクエスト例：

• 「Nvidiaの最新ニュースは？」
• 「過去24時間のFRBの政策に関するニュースをスキャンして」
• 「Teslaをめぐるセンチメントを要約して」

処理手順：

1. ニュースAPI（Google News、RSSフィード）に問い合わせる
2. 関連性（ティッカー、キーワード、期間）に基づいて絞り込む
3. センチメント（ポジティブ／ネガティブ／中立）を抽出する
4. 主要なエンティティとイベントを特定する
5. 調査結果を要約する

出力： 記事、センチメントスコア、要約を含むJSON。

3. テクニカル分析

指標を計算し、パターンを特定します。

含まれる指標：

• 移動平均（SMA、EMA、WMA）
• RSI、MACD、ボリンジャーバンド
• 出来高プロファイル
• サポート／レジスタンス水準
• ローソク足パターン

例：

Analyze NVDA technicals:
- RSI(14) = 67.3 (neutral)
- Price above 50-day SMA
- MACD bullish crossover

4. Polymarketとの連携

保有中のポジションと市場確率を追跡します。

機能：

• 保有中のすべてのポジションを一覧表示
• 市場価格とエントリー価格を確認
• 保留中の市場更新情報を取得（米国・イランの攻撃日など）
• 確率の大幅な変動をアラートで通知

例： 「2月28日のイラン攻撃市場における自分のPolymarketポジションを表示して」

5. レポートの作成

MarkdownまたはPDF形式で、プロフェッショナルなリサーチレポートを作成します。

レポートの種類：

• スナップショット（1～2ページ）：ティッカーの簡易概要
• 詳細分析（5～10ページ）：チャートを含む包括的な分析
• デイリーブリーフィング：値上がり・値下がり上位銘柄、ニュースの要約、ウォッチリストの更新
• ポートフォリオ概要：すべての保有資産＋Polymarketの集計ビュー

利用可能なテンプレート：

• assets/templates/report_snapshot.md
• assets/templates/report_deep_dive.md
• assets/templates/daily_briefing.md

カスタマイズ： レポートではJinja2テンプレートを使用します。形式の変更、セクションの追加、ブランド設定の変更を行うには、assets/templates/内のテンプレートを編集してください。

6. ウォッチリストとアラート

シンボルのウォッチリストを管理し、条件を満たしたときにアラートを受け取ります。

アラートのトリガー：

• 価格のしきい値（上回る／下回る）
• 出来高の急増（平均の2倍超）
• ニュースのセンチメント変化
• RSIの買われ過ぎ／売られ過ぎ
• Polymarketの確率変化

設定例：

watchlist:
  - symbol: BTC-USD
    alerts:
      - price_above: 100000
      - rsi_below: 30

ワークフローの例

簡易スナップショット（10分）

ユーザー：「AMDについて手短に教えて」

エージェント：

1. 現在の価格と主要指標（P/E、時価総額、52週レンジ）を取得する
2. センチメント付きの直近5件のニュース記事を取得する
3. RSI(14)を計算する
4. テンプレートを使用して snapshot_report.mdを生成する
5. レポートと重要なポイントを出力する

詳細分析（30～60分）

ユーザー：「競争環境も含めてTeslaを徹底的に分析して」

エージェント：

1. テクニカルチャート（MA、RSI、出来高）用の過去1年分の価格データを取得する
2. ファンダメンタルデータ（売上高成長率、利益率、EPSの推移）を取得する
3. 過去30日間のニュースをスキャンし、センチメントを集計する
4. 競合他社（NIO、RIVN、従来型自動車メーカー）と比較する
5. オプションフロー／機関投資家の保有状況を確認する（利用可能な場合）
6. チャート付きの詳細レポートを生成する（matplotlibのプロットはassets/charts/に保存）
7. 確信度を添えて、買い／売り／保有の推奨を提示する

継続的なモニタリング（スケジュール実行）

ユーザー：「毎日 CET の午前 8 時にブリーフィングを実行してください」

エージェント：

1. ウォッチリストの銘柄をスキャンして、夜間の変動を確認します
2. 主要な金融ニュースを取得します（Bloomberg、Reuters、CNBC）
3. Polymarket のポジションを確認して、確率の更新を調べます
4. 重要な値動きを要約します
5. ブリーフィングを Telegram メッセージで送信します
6. 完全なレポートを memory/daily_briefings/YYYY-MM-DD.md に保存します

設定

デフォルトを設定するには、ワークスペースに config.yaml を作成します。

data_sources:
  stocks: yahoo
  crypto: coingecko
  news: google_rss
  macro: fred

polymarket:
  enabled: true
  positions_file: memory/polymarket_positions.md

reports:
  output_dir: memory/reports/
  default_format: markdown
  include_charts: true

alerts:
  telegram_enabled: true
  check_interval_minutes: 60

スクリプトのリファレンス

スクリプト	用途	使用方法
scripts/finance_api.py	コア API モジュール	from finance_api import fetch_historical, calculate_rsi, generate_snapshot_report
scripts/demo.py	コマンドラインのデモ	python scripts/demo.py snapshot AAPL

詳しいドキュメントについては、references/data_sources.md と references/technical_indicators.md を参照してください。

リファレンス

• データソース： references/data_sources.md — API エンドポイント、レート制限、セットアップ
• インジケーター： references/technical_indicators.md — 数式と解釈
• レポートテンプレート： assets/templates/ — Jinja2 テンプレートと例
• Polymarket のスキーマ： references/polymarket_schema.md — 市場データの構造

OpenClaw との連携

このスキルは以下と連携します：

• NewsClawd： ニュースソースを共有します（重複を避けます）
• Clawd:Mail： レポートを自動的にメールで送信します
• Telegram： メッセージツールでアラートとブリーフィングを送信します
• Cron： 毎日／毎週の実行をスケジュールします

例

例 1：暗号資産レポートを生成する

Create a research report on Ethereum including:
- Last 90 days price action
- Dominance vs Bitcoin
- Recent ecosystem news (L2s, DeFi)
- Technical outlook (RSI, MACD, volume)

例 2：ウォッチリストをモニタリングする

Check my watchlist (AAPL, NVDA, BTC) and alert if:
- Any price moved >5% in 24h
- RSI goes below 30 or above 70
- Major news breaks

例 3：Polymarket のポジションを確認する

List all my Polymarket positions on US-Iran markets
Calculate current profit/loss
Alert if any market probability shifted >20% overnight

対象外（スコープ外）

• 自動取引／注文執行（調査のみ）
• 金融アドバイス（免責事項が必要）
• ポートフォリオの最適化（別のスキル）
• 税務レポート
• ESG／サステナビリティ指標

変更履歴

v0.1.0（2026-02-15）

• 初回リリース
• コアデータの取得、ニュースのスキャン、テクニカル分析
• Polymarket との連携
• テンプレートを使用したレポート生成