市場センチメント分析

概要

このスキルは複数のデータソースを組み合わせて、包括的な暗号資産市場センチメント分析を提供します：

• Fear & Greed Index: Alternative.meからの市場全体のセンチメント
• ニュースセンチメント: 最近の暗号資産ニュースのキーワードベース分析
• 市場モメンタム: CoinGeckoからの価格とボリュームトレンド

主要機能：

• 複合センチメントスコア (0-100) と分類
• コイン固有のセンチメント分析
• センチメント構成要素の詳細な内訳
• 複数の出力形式 (テーブル、JSON、CSV)

前提条件

このスキルを使用する前に、以下を確認してください：

1. Python 3.8+ がインストールされていること
2. requests ライブラリが利用可能であること: pip install requests
3. API アクセス用のインターネット接続 (Alternative.me、CoinGecko)
4. オプション: ニュース分析を強化するための crypto-news-aggregator スキル

手順

ステップ 1: ユーザーの意図を評価する

ユーザーが必要とするセンチメント分析を判断します：

• 市場全体: 特定のコインなし、一般的なセンチメント
• コイン固有: コインシンボル (BTC、ETH など) を抽出
• クイック vs 詳細: クイックスコアまたは完全な内訳

ステップ 2: センチメント分析を実行する

適切なオプションでセンチメント分析を実行します：

# クイックセンチメントチェック (デフォルト)
python {baseDir}/scripts/sentiment_analyzer.py

# コイン固有のセンチメント
python {baseDir}/scripts/sentiment_analyzer.py --coin BTC

# 構成要素の内訳を含む詳細分析
python {baseDir}/scripts/sentiment_analyzer.py --detailed

# JSON形式でエクスポート
python {baseDir}/scripts/sentiment_analyzer.py --format json --output sentiment.json

# カスタム期間
python {baseDir}/scripts/sentiment_analyzer.py --period 7d --detailed

ステップ 3: 結果を提示する

センチメント分析をフォーマットして提示します：

• 複合スコアと分類を表示
• センチメントの意味を説明
• 極端な値を強調
• 詳細モードでは構成要素の内訳を表示

コマンドラインオプション

オプション	説明	デフォルト
--coin	特定のコインを分析 (BTC、ETH など)	市場全体
--period	期間 (1h、4h、24h、7d)	24h
--detailed	完全な構成要素の内訳を表示	false
--format	出力形式 (table、json、csv)	table
--output	出力ファイルパス	stdout
--weights	カスタムウェイト (例: "news:0.5,fng:0.3,momentum:0.2")	デフォルト
--verbose	詳細出力を有効化	false

センチメント分類

スコア範囲	分類	説明
0-20	極度の恐怖	市場パニック、潜在的な底値
21-40	恐怖	慎重なセンチメント、弱気
41-60	中立	バランスの取れた状態、強いバイアスなし
61-80	貪欲	楽観的、強気センチメント
81-100	極度の貪欲	陶酔感、潜在的な天井

出力

テーブル形式 (デフォルト)

==============================================================================
  MARKET SENTIMENT ANALYZER                         Updated: 2026-01-14 15:30
==============================================================================

  COMPOSITE SENTIMENT
------------------------------------------------------------------------------
  Score: 65.5 / 100                         Classification: GREED

  Component Breakdown:
  - Fear & Greed Index:  72.0  (weight: 40%)  → 28.8 pts
  - News Sentiment:      58.5  (weight: 40%)  → 23.4 pts
  - Market Momentum:     66.5  (weight: 20%)  → 13.3 pts

  Interpretation: Market is moderately greedy. Consider taking profits or
  reducing position sizes. Watch for reversal signals.

==============================================================================

JSON 形式

{
  "composite_score": 65.5,
  "classification": "Greed",
  "components": {
    "fear_greed": {
      "score": 72,
      "classification": "Greed",
      "weight": 0.40,
      "contribution": 28.8
    },
    "news_sentiment": {
      "score": 58.5,
      "articles_analyzed": 25,
      "positive": 12,
      "negative": 5,
      "neutral": 8,
      "weight": 0.40,
      "contribution": 23.4
    },
    "market_momentum": {
      "score": 66.5,
      "btc_change_24h": 3.5,
      "weight": 0.20,
      "contribution": 13.3
    }
  },
  "meta": {
    "timestamp": "2026-01-14T15:30:00Z",
    "period": "24h"
  }
}

エラーハンドリング

包括的なエラーハンドリングについては {baseDir}/references/errors.md を参照してください。

エラー	原因	解決策
Fear & Greed が利用不可	API ダウン	キャッシュ値を警告付きで使用
ニュース取得失敗	ネットワークの問題	ニュースコンポーネントのウェイトを軽減
無効なコイン	不明なシンボル	市場全体の分析を進行

例

詳細な例については {baseDir}/references/examples.md を参照してください。

クイック例

# クイック市場センチメントチェック
python {baseDir}/scripts/sentiment_analyzer.py

# ビットコイン固有のセンチメント
python {baseDir}/scripts/sentiment_analyzer.py --coin BTC

# 詳細分析
python {baseDir}/scripts/sentiment_analyzer.py --detailed

# トレーディングモデル用にエクスポート
python {baseDir}/scripts/sentiment_analyzer.py --format json --output sentiment.json

# カスタムウェイト (ニュースを強調)
python {baseDir}/scripts/sentiment_analyzer.py --weights "news:0.5,fng:0.3,momentum:0.2"

# 週間センチメント比較
python {baseDir}/scripts/sentiment_analyzer.py --period 7d --detailed

リソース

• Alternative.me Fear & Greed Index: https://alternative.me/crypto/fear-and-greed-index/
• CoinGecko API: https://www.coingecko.com/en/api
• センチメント分析理論: コントラリアン指標 - 極端な値は反転の前に現れることが多い
• 設定オプションについては {baseDir}/config/settings.yaml を参照してください