crypto-kline-analysis

暗号資産Kライン分析スキル

Binance API のリアルタイムデータを使用して、暗号資産の包括的なテクニカル分析を行うインテリジェントな AI スキルです。

🚀 すぐに使う

このスキルを呼び出す AI エージェント向け：

# Analyze BTC/USDT (default - full analysis)
python crypto_analyzer.py

# Analyze specific trading pair
python crypto_analyzer.py ETH/USDT

# Long-term analysis only (4h + daily)
python crypto_analyzer.py BTC/USDT long

# Short-term analysis only (15m + 1h)
python crypto_analyzer.py BTC/USDT short

できること：

• ✅ Binance からリアルタイムの Kラインデータを取得します
• ✅ 10 種類以上のテクニカル指標を計算します
• ✅ 複数の時間足でトレンドを分析します
• ✅ 潜在的な天井と底を特定します
• ✅ ダイバージェンスとクロスオーバーを検出します
• ✅ 実行可能な取引推奨を生成します

出力： トレンドの方向、シグナルの強さ、取引の提案を明確に示す、包括的なテクニカル分析レポートです。

---

主な機能

このスキルは、暗号資産の完全なテクニカル分析を提供します。

1. ✅ 長期分析 - EMA の並びに基づき、4 時間足と日足のトレンドを検出します
2. ✅ トレンドの特定 - 強さの指標を用いて、強気・弱気・横ばいのトレンドを判定します
3. ✅ 天井・底の検出 - RSI、StochRSI、ボリンジャーバンドを使って、潜在的な反転ポイントを特定します
4. ✅ 短期シグナル - エントリー／エグジットのタイミングを判断するための、高速な 15 分足および 1 時間足シグナルを提供します
5. ✅ ダイバージェンスの検出 - 価格と指標のダイバージェンス（強気／弱気）を検出します
6. ✅ 包括的なレポート - リスク警告を含む、明確で実行可能な分析を提供します

このスキルを使う場面

ユーザーが次のことを希望する場合に、このスキルを使います。

• 暗号資産の価格トレンド（BTC、ETH など）を分析する
• 取引判断のためのテクニカル分析を得る
• 潜在的なエントリーポイントまたはエグジットポイントを特定する
• 市場トレンドの方向と強さを把握する
• 買われすぎ／売られすぎの状態を検出する
• 複数の時間足を同時に分析する
• 実行可能な取引推奨を得る

実装されているテクニカル指標

移動平均

• EMA（9、21、50、200）
• SMA（20、50）

モメンタム指標

• RSI（14）- 相対力指数
• Stochastic RSI - 強化型モメンタム指標

トレンド指標

• MACD（12、26、9）- 移動平均収束拡散
• ボリンジャーバンド（20、2）- ボラティリティバンド

ボラティリティと出来高

• ATR（14）- 平均真幅
• Volume SMA（20）- 出来高移動平均

全体のワークフロー

1. ユーザーのリクエストを理解する

ユーザーが暗号資産の分析を依頼したら、次の情報を抽出して確認します。

必須情報：

• 取引ペア：分析する暗号資産（例：BTC/USDT、ETH/USDT）
• 分析の種類：長期、短期、または包括的（すべて）
• 具体的な質問：特定の懸念事項（トレンドの方向、エントリーポイントなど）

ユーザーリクエストの例：

• 「BTC の価格トレンドを分析して」
• 「今の ETH は買われすぎ？」
• 「BTC の長期分析をして」
• 「SOL の短期シグナルは？」

あなたが行うこと：

• 暗号資産のシンボルを特定します
• 分析範囲（長期／短期／すべて）を判断します
• 取引ペアの形式（シンボル/USDT）を確認します

2. Kラインデータを取得する

スキルのディレクトリに移動し、リアルタイムの市場データを取得します。

cd ~/.claude/skills/crypto-kline-analysis
source venv/bin/activate
python crypto_analyzer.py BTC/USDT [timeframe]

取得するデータ：

• 4 時間足の Kライン（200 本）
• 日足の Kライン（200 本）
• 1 時間足の Kライン（200 本）
• 15 分足の Kライン（200 本）
• 24 時間のティッカー情報

3. テクニカル分析のプロセス

ツールは次の処理を自動的に行います。

1. 指標を計算する - 各時間足のすべてのテクニカル指標を計算します
2. トレンドを分析する - EMA の並びを使ってトレンドの方向を判定します
3. 天井・底を検出する - 買われすぎ／売られすぎの状態を特定します
4. ダイバージェンスを検出する - 価格と指標のダイバージェンスを検出します
5. シグナルを生成する - 強気／弱気／中立のシグナルを生成します

4. 分析結果を解釈する

重要：分析結果を必ずユーザー向けに解釈してください。

ツールは次のセクションを出力します。

長期分析（4h・日次）

• トレンドの方向：強気、強気、横ばい、弱気、強い弱気
• トレンドの強さ：強、中、弱
• EMA の整列：現在価格と EMA（9、21、50、200）の比較
• MACD の状態：ゴールデンクロス（強気）またはデッドクロス（弱気）
• ポジション：天井の可能性、底の可能性、中立
• RSI レベル：買われすぎ（>70）、売られすぎ（<30）、または中立

短期分析（15m・1h）

• 短期トレンド：強気または弱気
• クイックシグナル：RSI の状態、MACD のクロスオーバー
• エントリーのタイミング：短い時間足での買われすぎ／売られすぎ

5. ユーザーに明確な概要を提供する

重要：テクニカル分析の結果は、必ず実践的な知見に置き換えてください。

概要には必ず以下を含めてください：

✅ 強気シグナルの場合：

📈 BTC/USDT Analysis Summary

Current Trend: Strong Bullish
- Daily trend is up with EMA(9) > EMA(21) > EMA(50)
- MACD showing golden cross on 4h timeframe
- Price above 200-day EMA = Bull market confirmed

Key Signals:
✅ Long-term trend is strong and upward
✅ Momentum indicators support continued upside
⚠️  Watch for RSI overbought on daily (currently 68)

Recommendation: Bullish bias - Consider holding or buying on dips
Risk: Monitor for RSI >70 which may signal short-term pullback

❌ 弱気シグナルの場合：

📉 BTC/USDT Analysis Summary

Current Trend: Strong Bearish
- Daily trend is down with EMA(9) < EMA(21) < EMA(50)
- MACD showing death cross on daily timeframe
- Price below 200-day EMA = Bear market confirmed

Key Signals:
❌ Long-term trend is weak and downward
❌ Multiple timeframes confirm bearish structure
💡 RSI oversold on daily (currently 28) = potential bounce

Recommendation: Bearish bias - Consider staying in cash or waiting
Opportunity: Watch for bullish divergence on RSI for reversal signal

📊 必ず含める項目：

• 明確なトレンドの方向（強気／弱気／横ばい）
• 時間足ごとのトレンドの強さ
• 主要なサポート／レジスタンスレベル（EMA）
• 買われすぎ／売られすぎの状態
• 具体的なエントリー／エグジットの提案
• リスクに関する警告と免責事項

6. 追加質問に回答する

分析を提供した後は、補足説明ができるようにしてください：

よくある質問：

• 「MACD のゴールデンクロスとは何ですか？」→ 強気方向へのモメンタムの変化を説明します
• 「今は買い時ですか？」→ トレンド、RSI、ポジションの分析を参照します
• 「リスクは何ですか？」→ 買われすぎの状態やトレンドの弱さを説明します
• 「いつ売るべきですか？」→ レジスタンスレベルとトレンドの変化を参照します

重要な注意事項：

• 免責事項を必ず含めてください：「これは教育目的のみであり、金融上の助言ではありません」
• 暗号資産市場は非常に変動が激しいことを強調してください
• 適切なリスク管理を推奨してください
• ユーザー自身で調査するよう促してください

環境のセットアップ

1. 依存関係をインストールする

cd crypto-kline-analysis
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

2. インストールをテストする

# Activate virtual environment
source venv/bin/activate

# Run test analysis
python crypto_analyzer.py BTC/USDT long

API キーは不要です — Binance のパブリック API エンドポイントを使用します。

分析手法

トレンド検出ロジック

1. EMA の整列を確認

   • 強気：EMA(9) > EMA(21) > EMA(50)
   • 強気：EMA(9) > EMA(21)
   • 強い弱気：EMA(9) < EMA(21) < EMA(50)
   • 弱気：EMA(9) < EMA(21)
   • 横ばい：整列が混在している、または明確な整列がない

2. MACD による確認

   • ゴールデンクロス：MACD ラインがシグナルラインを上抜ける（強気）
   • デッドクロス：MACD ラインがシグナルラインを下抜ける（弱気）

3. 長期的な市場構造

   • 200 EMA を上回る = 強気相場
   • 200 EMA を下回る = 弱気相場

天井／底の検出ロジック

1. RSI レベル

   • RSI < 30 = 売られすぎ（底の可能性）
   • RSI > 70 = 買われすぎ（天井の可能性）
   • RSI 40-60 = 中立ゾーン

2. StochRSI による確認

   • StochRSI < 20 = 強い売られすぎ
   • StochRSI > 80 = 強い買われすぎ

3. ボリンジャーバンドの位置

   • 価格が上限バンド付近 = 買われすぎゾーン
   • 価格が下限バンド付近 = 売られすぎゾーン

4. ダイバージェンスの検出

   • 弱気：価格が新高値を付けても、RSI は新高値を付けない（天井の可能性）
   • 強気：価格が新安値を付けても、RSI は新安値を付けない（底の可能性）

使用例

例 1：基本的なトレンドの確認

ユーザー：「現在の BTC のトレンドはどうですか？」

エージェントの操作：

1. 実行：python crypto_analyzer.py BTC/USDT long
2. 出力を分析する
3. 明確な概要を回答する

エージェントの回答：

BTC/USDT is currently in a Strong Bearish trend on the daily timeframe:

📉 Daily: Strong Bearish (EMA 9 < 21 < 50)
📉 4-hour: Bearish
💡 Price is below 200-day EMA ($102,074) = Bear market
⚠️  MACD death cross confirmed

However, daily RSI is at 35 (approaching oversold), which may signal
a potential bounce in the near term.

Conclusion: Strong downtrend with possible short-term bounce opportunity.

例 2：エントリーポイントの分析

ユーザー：「ETH のエントリーポイントとして、今は良いタイミングですか？」

エージェントの操作：

1. 実行：python crypto_analyzer.py ETH/USDT all
2. 長期トレンドと短期シグナルの両方を確認する
3. バランスの取れた評価を提示する

エージェントの回答：

ETH/USDT Entry Analysis:

Long-term (Daily): Bearish trend, price below key EMAs
Short-term (1h): Showing bullish divergence, RSI oversold at 28

Signals:
✅ Short-term RSI oversold = potential bounce
⚠️  Long-term trend still bearish
⚠️  Price below 200 EMA

Assessment: Risky for long-term entry, but short-term bounce trade
possible if you have tight stop-loss.

Safer entry would be: Wait for daily trend to turn bullish (EMA crossover)

⚠️  Disclaimer: This is educational analysis only, not financial advice.
Crypto markets are highly volatile.

例 3：リスク評価

ユーザー：「自分の BTC ポジションについて心配すべきですか？」

エージェントの操作：

1. 包括的な分析を実行する
2. 警告シグナルを確認する
3. リスク評価を提示する

エージェントの回答：

Risk Assessment for BTC/USDT:

⚠️  WARNING SIGNALS DETECTED:

1. Daily RSI: 72 (overbought) - Price may face pullback pressure
2. 4h StochRSI: 87 (extremely overbought)
3. Price position: Near Bollinger Band upper limit
4. Potential bearish divergence forming

Risk Level: MEDIUM-HIGH for short-term pullback

Recommendations:
- Consider taking partial profits if in profit
- Set stop-loss at recent support level
- Watch for RSI to drop below 70 as confirmation of reversal
- Don't chase if price continues up (let it cool down first)

Long-term trend is still bullish, so this may be temporary correction.

トラブルシューティング

問題：Binance API への接続エラー

考えられる原因：

• ネットワーク接続の問題
• Binance API の一時的な停止
• レート制限（リクエストが多すぎる）

解決策：

• インターネット接続を確認してください
• 数分待ってから再試行してください
• https://www.binance.com/en/support で Binance API のステータスを確認してください

問題：シンボルが見つからない

問題：「BTC/USDT データの取得に失敗しました」

解決策：

• シンボルの形式が正しいことを確認してください：BTC/USDT（BTCUSDT ではありません）
• Binance の現物市場にシンボルが存在するか確認してください
• 別のシンボルを試してください（例：ETH/USDT）

問題：仮想環境が有効化されていない

問題：「モジュールが見つかりません」というエラー

解決策：

cd crypto-kline-analysis
source venv/bin/activate
python crypto_analyzer.py BTC/USDT

重要な免責事項

AI エージェント向け：すべての分析に、以下の免責事項を必ず含めてください：

1. ⚠️ 投資助言ではありません：この分析は教育目的のみです
2. ⚠️ 高いリスク：暗号資産取引には、損失を被る重大なリスクが伴います
3. ⚠️ ご自身で調査してください：取引の前に、ユーザー自身で調査してください
4. ⚠️ 保証はありません：過去の実績は将来の結果を予測するものではありません
5. ⚠️ ボラティリティ：暗号資産市場は非常に変動が激しく、予測が困難です

技術サポート

• GitHub Issues：バグの報告や機能のリクエスト
• ドキュメント：詳細なセットアップについては README.md をご覧ください
• Binance API ドキュメント：https://binance-docs.github.io/apidocs/spot/en/

ライセンス

MIT ライセンス - 詳細については LICENSE ファイルをご覧ください